Update content

api-ref/source/apis/auto_scaling_apis/index.rst

@@ -0,0 +1,14 @@
+:original_name: mrs_02_0054.html
+
+.. _mrs_02_0054:
+
+Auto Scaling APIs
+=================
+
+-  :ref:`Configuring an Auto Scaling Rule <mrs_02_0056>`
+
+.. toctree::
+   :maxdepth: 1
+   :hidden: 
+
+   configuring_an_auto_scaling_rule

api-ref/source/apis/cluster_management_apis_v1/deleting_a_cluster.rst

@@ -0,0 +1,81 @@
+:original_name: mrs_02_0032.html
+
+.. _mrs_02_0032:
+
+Deleting a Cluster
+==================
+
+Function
+--------
+
+This API is used to delete a cluster after data processing and analysis are completed or the cluster is abnormal. This API is compatible with Sahara.
+
+Clusters in any of the following states cannot be terminated:
+
+-  scaling-out
+-  scaling-in
+-  starting
+-  terminating
+-  terminated
+-  failed
+
+URI
+---
+
+-  Format
+
+   DELETE /v1.1/{project_id}/clusters/{cluster_id}
+
+-  Parameter description
+
+   .. table:: **Table 1** URI parameter description
+
+      +------------+-----------+-----------------------------------------------------------------------------------------------------------+
+      | Parameter  | Mandatory | Description                                                                                               |
+      +============+===========+===========================================================================================================+
+      | project_id | Yes       | Project ID. For details on how to obtain the project ID, see :ref:`Obtaining a Project ID <mrs_02_0011>`. |
+      +------------+-----------+-----------------------------------------------------------------------------------------------------------+
+      | cluster_id | Yes       | Cluster ID                                                                                                |
+      +------------+-----------+-----------------------------------------------------------------------------------------------------------+
+
+Request
+-------
+
+**Request parameters**
+
+None.
+
+Response
+--------
+
+**Response parameters**
+
+None.
+
+Example
+-------
+
+-  Example request
+
+   None.
+
+-  Example response
+
+   None.
+
+Status Code
+-----------
+
+:ref:`Table 2 <mrs_02_0032__table1584477916050>` describes the status code of this API.
+
+.. _mrs_02_0032__table1584477916050:
+
+.. table:: **Table 2** Status code
+
+   =========== =============================================
+   Status Code Description
+   =========== =============================================
+   204         The cluster has been successfully terminated.
+   =========== =============================================
+
+For the description about error status codes, see :ref:`Status Codes <mrs_02_0015>`.

api-ref/source/apis/cluster_management_apis_v1/index.rst

@@ -0,0 +1,24 @@
+:original_name: mrs_02_0027.html
+
+.. _mrs_02_0027:
+
+Cluster management APIs (V1)
+============================
+
+-  :ref:`Creating a Cluster and Running a Job <mrs_02_0028>`
+-  :ref:`Resizing a Cluster <mrs_02_0029>`
+-  :ref:`Querying a Cluster List <mrs_02_0030>`
+-  :ref:`Querying Cluster Details <mrs_02_0031>`
+-  :ref:`Deleting a Cluster <mrs_02_0032>`
+-  :ref:`Querying a Host List <mrs_02_0057>`
+
+.. toctree::
+   :maxdepth: 1
+   :hidden: 
+
+   creating_a_cluster_and_running_a_job
+   resizing_a_cluster
+   querying_a_cluster_list
+   querying_cluster_details
+   deleting_a_cluster
+   querying_a_host_list

api-ref/source/apis/cluster_management_apis_v2/index.rst

@@ -0,0 +1,14 @@
+:original_name: mrs_02_0100.html
+
+.. _mrs_02_0100:
+
+Cluster management APIs (V2)
+============================
+
+-  :ref:`Creating Clusters <mrs_02_0101>`
+
+.. toctree::
+   :maxdepth: 1
+   :hidden: 
+
+   creating_clusters

api-ref/source/apis/data_source_apis/deleting_a_data_source.rst

@@ -0,0 +1,74 @@
+:original_name: mrs_02_0026.html
+
+.. _mrs_02_0026:
+
+Deleting a Data Source
+======================
+
+Function
+--------
+
+This API is used to delete a data source. This API is compatible with Sahara.
+
+URI
+---
+
+-  Format
+
+   DELETE /v1.1/{project_id}/data-sources/{data_source_id}
+
+-  Parameter description
+
+   .. table:: **Table 1** URI parameter description
+
+      +----------------+-----------+-----------------------------------------------------------------------------------------------------------+
+      | Parameter      | Mandatory | Description                                                                                               |
+      +================+===========+===========================================================================================================+
+      | project_id     | Yes       | Project ID. For details on how to obtain the project ID, see :ref:`Obtaining a Project ID <mrs_02_0011>`. |
+      +----------------+-----------+-----------------------------------------------------------------------------------------------------------+
+      | data_source_id | Yes       | Data source ID                                                                                            |
+      +----------------+-----------+-----------------------------------------------------------------------------------------------------------+
+
+Request
+-------
+
+**Request parameters**
+
+None.
+
+Response
+--------
+
+**Response parameters**
+
+None.
+
+Example
+-------
+
+-  Example request
+
+   .. code-block:: text
+
+      DELETE /v1.1/{project_id}/data-sources/{data_source_id}
+
+-  Example response
+
+   None.
+
+Status Code
+-----------
+
+:ref:`Table 2 <mrs_02_0026__table1584477916050>` describes the status code of this API.
+
+.. _mrs_02_0026__table1584477916050:
+
+.. table:: **Table 2** Status code
+
+   =========== ========================================
+   Status Code Description
+   =========== ========================================
+   204         The data source is deleted successfully.
+   =========== ========================================
+
+For the description about error status codes, see :ref:`Status Codes <mrs_02_0015>`.

api-ref/source/apis/data_source_apis/index.rst

@@ -0,0 +1,22 @@
+:original_name: mrs_02_0021.html
+
+.. _mrs_02_0021:
+
+Data Source APIs
+================
+
+-  :ref:`Creating a Data Source <mrs_02_0022>`
+-  :ref:`Updating a Data Source <mrs_02_0023>`
+-  :ref:`Querying the Data Source List <mrs_02_0024>`
+-  :ref:`Querying the Data Source Details <mrs_02_0025>`
+-  :ref:`Deleting a Data Source <mrs_02_0026>`
+
+.. toctree::
+   :maxdepth: 1
+   :hidden: 
+
+   creating_a_data_source
+   updating_a_data_source
+   querying_the_data_source_list
+   querying_the_data_source_details
+   deleting_a_data_source

api-ref/source/apis/index.rst

@@ -0,0 +1,30 @@
+:original_name: mrs_02_0020.html
+
+.. _mrs_02_0020:
+
+APIs
+====
+
+-  :ref:`Data Source APIs <mrs_02_0021>`
+-  :ref:`Cluster management APIs (V2) <mrs_02_0100>`
+-  :ref:`Cluster management APIs (V1) <mrs_02_0027>`
+-  :ref:`Job Binary Object APIs <mrs_02_0033>`
+-  :ref:`Job Object APIs (V1, Not Recommended) <mrs_02_0039>`
+-  :ref:`Job Execution Object APIs (V1, Not Recommended) <mrs_02_0049>`
+-  :ref:`Job Object APIs (V2) <mrs_02_0084>`
+-  :ref:`Auto Scaling APIs <mrs_02_0054>`
+-  :ref:`Tag Management APIs <mrs_02_0070>`
+
+.. toctree::
+   :maxdepth: 1
+   :hidden: 
+
+   data_source_apis/index
+   cluster_management_apis_v2/index
+   cluster_management_apis_v1/index
+   job_binary_object_apis/index
+   job_object_apis_v1,_not_recommended/index
+   job_execution_object_apis_v1,_not_recommended/index
+   job_object_apis_v2/index
+   auto_scaling_apis/index
+   tag_management_apis/index

api-ref/source/apis/job_binary_object_apis/deleting_a_job_binary_object.rst

@@ -0,0 +1,72 @@
+:original_name: mrs_02_0038.html
+
+.. _mrs_02_0038:
+
+Deleting a Job Binary Object
+============================
+
+Function
+--------
+
+This API is used to delete a binary object. This API is compatible with Sahara.
+
+URI
+---
+
+-  Format
+
+   DELETE /v1.1/{project_id}/job-binaries/{job_binary_id}
+
+-  Parameter description
+
+   .. table:: **Table 1** URI parameter description
+
+      +---------------+-----------+-----------------------------------------------------------------------------------------------------------+
+      | Parameter     | Mandatory | Description                                                                                               |
+      +===============+===========+===========================================================================================================+
+      | project_id    | Yes       | Project ID. For details on how to obtain the project ID, see :ref:`Obtaining a Project ID <mrs_02_0011>`. |
+      +---------------+-----------+-----------------------------------------------------------------------------------------------------------+
+      | job_binary_id | Yes       | Job binary object ID                                                                                      |
+      +---------------+-----------+-----------------------------------------------------------------------------------------------------------+
+
+Request
+-------
+
+**Request parameters**
+
+None
+
+Response
+--------
+
+**Response parameters**
+
+None
+
+Example
+-------
+
+-  Example request
+
+   None
+
+-  Example response
+
+   None
+
+Status Code
+-----------
+
+:ref:`Table 2 <mrs_02_0038__table1584477916050>` describes the status code of this API.
+
+.. _mrs_02_0038__table1584477916050:
+
+.. table:: **Table 2** Status code
+
+   =========== ==========================================
+   Status code Description
+   =========== ==========================================
+   204         The binary object is deleted successfully.
+   =========== ==========================================
+
+For the description about error status codes, see :ref:`Status Codes <mrs_02_0015>`.

api-ref/source/apis/job_binary_object_apis/index.rst

@@ -0,0 +1,22 @@
+:original_name: mrs_02_0033.html
+
+.. _mrs_02_0033:
+
+Job Binary Object APIs
+======================
+
+-  :ref:`Creating a Job Binary Object <mrs_02_0034>`
+-  :ref:`Updating a Job Binary Object <mrs_02_0035>`
+-  :ref:`Querying the Binary Object List <mrs_02_0036>`
+-  :ref:`Querying the Binary Object Details <mrs_02_0037>`
+-  :ref:`Deleting a Job Binary Object <mrs_02_0038>`
+
+.. toctree::
+   :maxdepth: 1
+   :hidden: 
+
+   creating_a_job_binary_object
+   updating_a_job_binary_object
+   querying_the_binary_object_list
+   querying_the_binary_object_details
+   deleting_a_job_binary_object

api-ref/source/apis/job_execution_object_apis_v1,_not_recommended/deleting_a_job_execution_object.rst

@@ -0,0 +1,72 @@
+:original_name: mrs_02_0053.html
+
+.. _mrs_02_0053:
+
+Deleting a Job Execution Object
+===============================
+
+Function
+--------
+
+This API is used to delete a job execution object. This API is compatible with Sahara.
+
+URI
+---
+
+-  Format
+
+   DELETE /v1.1/{project_id}/job-executions/{job_execution_id}
+
+-  Parameter description
+
+   .. table:: **Table 1** URI parameter description
+
+      +------------------+-----------+-----------------------------------------------------------------------------------------------------------+
+      | Parameter        | Mandatory | Description                                                                                               |
+      +==================+===========+===========================================================================================================+
+      | project_id       | Yes       | Project ID. For details on how to obtain the project ID, see :ref:`Obtaining a Project ID <mrs_02_0011>`. |
+      +------------------+-----------+-----------------------------------------------------------------------------------------------------------+
+      | job_execution_id | Yes       | Job ID                                                                                                    |
+      +------------------+-----------+-----------------------------------------------------------------------------------------------------------+
+
+Request
+-------
+
+**Request parameters**
+
+None.
+
+Response
+--------
+
+**Response parameters**
+
+None.
+
+Example
+-------
+
+-  Example request
+
+   None.
+
+-  Example response
+
+   None.
+
+Status Code
+-----------
+
+:ref:`Table 2 <mrs_02_0053__table1584477916050>` describes the status code of this API.
+
+.. _mrs_02_0053__table1584477916050:
+
+.. table:: **Table 2** Status code
+
+   =========== =================================================
+   Status Code Description
+   =========== =================================================
+   204         The job execution object is deleted successfully.
+   =========== =================================================
+
+For the description about error status codes, see :ref:`Status Codes <mrs_02_0015>`.

api-ref/source/apis/job_execution_object_apis_v1,_not_recommended/index.rst

@@ -0,0 +1,20 @@
+:original_name: mrs_02_0049.html
+
+.. _mrs_02_0049:
+
+Job Execution Object APIs (V1, Not Recommended)
+===============================================
+
+-  :ref:`Querying the Job Execution Object List <mrs_02_0050>`
+-  :ref:`Querying Job Execution Object Details <mrs_02_0051>`
+-  :ref:`Canceling Job Execution <mrs_02_0052>`
+-  :ref:`Deleting a Job Execution Object <mrs_02_0053>`
+
+.. toctree::
+   :maxdepth: 1
+   :hidden: 
+
+   querying_the_job_execution_object_list
+   querying_job_execution_object_details
+   canceling_job_execution
+   deleting_a_job_execution_object

api-ref/source/apis/job_object_apis_v1,_not_recommended/deleting_a_job_object.rst

@@ -0,0 +1,72 @@
+:original_name: mrs_02_0048.html
+
+.. _mrs_02_0048:
+
+Deleting a Job Object
+=====================
+
+Function
+--------
+
+This API is used to delete a job object. This API is compatible with Sahara.
+
+URI
+---
+
+-  Format
+
+   DELETE /v1.1/{project_id}/jobs/{job_id}
+
+-  Parameter description
+
+   .. table:: **Table 1** URI parameter description
+
+      +------------+-----------+-----------------------------------------------------------------------------------------------------------+
+      | Parameter  | Mandatory | Description                                                                                               |
+      +============+===========+===========================================================================================================+
+      | project_id | Yes       | Project ID. For details on how to obtain the project ID, see :ref:`Obtaining a Project ID <mrs_02_0011>`. |
+      +------------+-----------+-----------------------------------------------------------------------------------------------------------+
+      | job_id     | Yes       | Job object ID                                                                                             |
+      +------------+-----------+-----------------------------------------------------------------------------------------------------------+
+
+Request
+-------
+
+**Request parameters**
+
+None.
+
+Response
+--------
+
+**Response parameters**
+
+None.
+
+Example
+-------
+
+-  Example request
+
+   None.
+
+-  Example response
+
+   None.
+
+Status Code
+-----------
+
+:ref:`Table 2 <mrs_02_0048__table1584477916050>` describes the status code of this API.
+
+.. _mrs_02_0048__table1584477916050:
+
+.. table:: **Table 2** Status code
+
+   =========== =============================================
+   Status Code Description
+   =========== =============================================
+   204         The job object has been successfully deleted.
+   =========== =============================================
+
+For the description about error status codes, see :ref:`Status Codes <mrs_02_0015>`.

api-ref/source/apis/job_object_apis_v1,_not_recommended/index.rst

@@ -0,0 +1,30 @@
+:original_name: mrs_02_0039.html
+
+.. _mrs_02_0039:
+
+Job Object APIs (V1, Not Recommended)
+=====================================
+
+-  :ref:`Adding a Job and Executing the Job <mrs_02_0040>`
+-  :ref:`Creating a Job Object <mrs_02_0041>`
+-  :ref:`Updating a Job Object <mrs_02_0042>`
+-  :ref:`Executing a Job Object <mrs_02_0043>`
+-  :ref:`Querying the Job Object List <mrs_02_0044>`
+-  :ref:`Querying Job Object Details <mrs_02_0045>`
+-  :ref:`Querying the exe Object List of Jobs <mrs_02_0046>`
+-  :ref:`Querying exe Object Details <mrs_02_0047>`
+-  :ref:`Deleting a Job Object <mrs_02_0048>`
+
+.. toctree::
+   :maxdepth: 1
+   :hidden: 
+
+   adding_a_job_and_executing_the_job
+   creating_a_job_object
+   updating_a_job_object
+   executing_a_job_object
+   querying_the_job_object_list
+   querying_job_object_details
+   querying_the_exe_object_list_of_jobs
+   querying_exe_object_details
+   deleting_a_job_object

api-ref/source/apis/job_object_apis_v2/deleting_jobs_in_batches.rst

@@ -0,0 +1,79 @@
+:original_name: mrs_02_0089.html
+
+.. _mrs_02_0089:
+
+Deleting Jobs in Batches
+========================
+
+Function
+--------
+
+This API is used to delete APIs in batches.
+
+URI
+---
+
+-  Format
+
+   POST /v2/{project_id}/clusters/{cluster_id}/job-executions/batch-delete
+
+-  Parameter description
+
+   .. table:: **Table 1** URI parameter description
+
+      +------------+-----------+-----------------------------------------------------------------------------------------------------------------------------------+
+      | Parameter  | Mandatory | Description                                                                                                                       |
+      +============+===========+===================================================================================================================================+
+      | project_id | Yes       | Project ID. For details on how to obtain the project ID, see :ref:`Obtaining a Project ID <mrs_02_0011>`.                         |
+      +------------+-----------+-----------------------------------------------------------------------------------------------------------------------------------+
+      | cluster_id | Yes       | Cluster ID. For details on how to obtain the cluster ID, see :ref:`Obtaining a Cluster ID <mrs_02_0091__section177891315153619>`. |
+      +------------+-----------+-----------------------------------------------------------------------------------------------------------------------------------+
+
+Request
+-------
+
+.. table:: **Table 2** Request parameter description
+
+   +-------------+-----------+-------+--------------------------------------------------------------------------------------------------------------------------------------+
+   | Parameter   | Mandatory | Type  | Description                                                                                                                          |
+   +=============+===========+=======+======================================================================================================================================+
+   | job_id_list | Yes       | Array | List of job IDs. For details on how to obtain the list of job IDs, see :ref:`Obtaining a Job ID <mrs_02_0091__section247234143612>`. |
+   +-------------+-----------+-------+--------------------------------------------------------------------------------------------------------------------------------------+
+
+Response
+--------
+
+**Response parameters**
+
+None
+
+Example
+-------
+
+-  Example request
+
+   .. code-block::
+
+      {
+          "job_id_list": ["c23c1f53-5c8e-4eb8-ab2f-a6acff8ac369", "8f7969b6-d2fb-4442-9533-3fe7d7bdf31b"]
+      }
+
+-  Example response
+
+   -  Example of a successful response
+
+      None
+
+   -  Example of a failed response
+
+      .. code-block::
+
+         {
+         "error_msg": "Failed to delete jobs in batches.",
+         "error_code":"0161"
+         }
+
+Status Code
+-----------
+
+For details about status codes, see :ref:`Status Codes <mrs_02_0015>`.

api-ref/source/apis/job_object_apis_v2/index.rst

@@ -0,0 +1,24 @@
+:original_name: mrs_02_0084.html
+
+.. _mrs_02_0084:
+
+Job Object APIs (V2)
+====================
+
+-  :ref:`Adding and Executing a Job <mrs_02_0085>`
+-  :ref:`Querying Information About a Job <mrs_02_0086>`
+-  :ref:`Querying a List of Jobs <mrs_02_0087>`
+-  :ref:`Terminating a Job <mrs_02_0088>`
+-  :ref:`Deleting Jobs in Batches <mrs_02_0089>`
+-  :ref:`Obtain the SQL Result <mrs_02_0090>`
+
+.. toctree::
+   :maxdepth: 1
+   :hidden: 
+
+   adding_and_executing_a_job
+   querying_information_about_a_job
+   querying_a_list_of_jobs
+   terminating_a_job
+   deleting_jobs_in_batches
+   obtain_the_sql_result