调整集群节点

功能介绍

创建集群后，扩容/缩容集群Core节点或者Task节点。MRS集群创建成功后不支持调整Master节点数量，即不支持扩缩容Master节点。该接口不兼容Sahara。

处于running状态的集群才允许扩容/缩容，其他状态则不允许扩容/缩容。

本章节的接口只支持流式集群、分析集群和混合集群，不支持自定义集群。

接口约束

无

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

• URI格式

  PUT /v1.1/{project_id}/cluster_infos/{cluster_id}

• 参数说明

  表1 路径参数

  参数	是否必选	参数类型	描述
  project_id	是	String	参数解释： 项目编号。获取方法，请参见获取项目ID。 约束限制： 不涉及 取值范围： 只能由英文字母和数字组成，且长度为[1-64]个字符。 默认取值： 不涉及
  cluster_id	是	String	参数解释： 集群ID。如果指定集群ID，则获取该集群做过补丁更新的最新版本元数据。获取方法，请参见获取集群ID。 约束限制： 不涉及 取值范围： 只能由英文字母、数字以及“_”和“-”组成，且长度为[1-64]个字符。 默认取值： 不涉及

请求参数

响应参数

请求示例

• 在MRS集群中扩容1个core节点。

  PUT /v1.1/{project_id}/cluster_infos/{cluster_id}
  
  { 
      "service_id": "",  
      "plan_id": "",  
      "parameters": { 
          "order_id": "",  
          "scale_type": "scale_out",  
          "node_id": "node_orderadd",  
          "node_group": "core_node_default_group",
          "instances": "1",
         "skip_bootstrap_scripts":false,
         "scale_without_start":false
      },  
      "previous_values": { }
  }

• 当Task节点个数等于零时，在MRS集群中扩容1个Task节点。

  PUT /v1.1/{project_id}/cluster_infos/{cluster_id}
  
  { 
      "service_id": "",  
      "plan_id": "",  
      "parameters": { 
          "order_id": "",  
          "scale_type": "scale_out",  
          "node_id": "node_orderadd",  
          "node_group": "task_node_default_group",
          "instances": "1",
          "skip_bootstrap_scripts":false,  
          "scale_without_start":false
      },  
      "previous_values": { }
  }

• 当Task节点个数大于零时，在MRS集群中扩容1个规格为s3.xlarge.2.linux.bigdata的Task节点。

  PUT /v1.1/{project_id}/cluster_infos/{cluster_id}
  
  { 
      "service_id": "",  
      "plan_id": "",  
      "parameters": { 
          "order_id": "",  
          "scale_type": "scale_out",  
          "node_id": "node_orderadd",  
          "node_group": "task_node_default_group",
          "task_node_info": {
                    "node_size": "s3.xlarge.2.linux.bigdata",
                    "data_volume_type":"SATA",
                    "data_volume_count":2,
                    "data_volume_size":600
                    },
          "instances": "1",  
          "scale_without_start":false
  
  
      },  
      "previous_values": { }
  }

• 在MRS集群中缩容1个Core节点。

  PUT /v1.1/{project_id}/cluster_infos/{cluster_id}
  
  { 
      "service_id": "",  
      "plan_id": "",  
      "parameters": { 
          "order_id": "",  
          "scale_type": "scale_in",  
          "node_id": "node_orderadd",  
          "node_group": "core_node_default_group",
          "instances": "1"  
  
  
      },  
      "previous_values": { }
  }

• 在MRS集群中缩容1个Task节点

  PUT /v1.1/{project_id}/cluster_infos/{cluster_id}
  
  { 
      "service_id": "",  
      "plan_id": "",  
      "parameters": { 
          "order_id": "",  
          "scale_type": "scale_in",  
          "node_id": "node_orderadd",  
          "node_group": "task_node_default_group",
          "instances": "1"  
  
      },  
      "previous_values": { }
  }

• 在MRS集群中缩容指定的Task节点。

  PUT /v1.1/{project_id}/cluster_infos/{cluster_id}
  
  { 
      "service_id": "",  
      "plan_id": "",  
      "parameters": { 
          "order_id": "",  
          "scale_type": "scale_in",  
          "node_id": "node_orderadd",  
          "node_group": "task_node_default_group",
          "instances": "2",
          "server_ids": ["c9573435-7814-4b2c-9131-ad78b814414c", "a4951009-6a0f-4e7b-9c81-9d4bd1f8c537"]  
      },  
      "previous_values": { }
  }

响应示例

状态码：200

扩容/缩容集群Core节点或者Task节点成功。

{
    "result": "succeeded"
}

状态码

• 状态码如表6所示。

  表6 状态码

  状态码	描述
  200	扩容/缩容集群Core节点或者Task节点成功。

• 异常状态码请参见状态码。

错误码

请参见错误码。