# DDM实例节点扩容V3
#### 功能介绍
对指定的DDM实例的节点个数进行扩容，支持按需实例与包周期实例。
#### 接口约束
请确保实例关联的RDS状态正常并且没有进行其他操作。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DDM&api=ListEngines)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
- URL格式 POST /v3/{project_id}/instances/{instance_id}/nodes
  
- 参数说明
  表1路径参数 
  | 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                                        |
  |:---|:---|:---|:---|
  | project_id  | 是    | String | 租户在某一region下的project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ddm/ddm_api_01_0063.html)。 |
  | instance_id | 是    | String | DDM实例ID。                                                                                                                                                  |
     
  
 
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                     |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务的"获取用户Token"接口来获取。 |
   
表3请求Body参数 
| 参数          | 是否必选 | 参数类型                                                                      | 描述                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| group_id    | 否    | String                                                                    | 组ID，指定当前进行节点扩容的组。当实例的组数量大于1时，必填。                                                                                                                                                                                                                                                                          |
| subnet_id   | 否    | String                                                                    | 子网ID，当实例组下的子网ID数量大于1时，必填。                                                                                                                                                                                                                                                                                 |
| is_auto_pay | 否    | Boolean                                                                   | 对包年包月实例节点扩容时可指定，表示是否自动从账户中支付。 - **true**，表示自动从账户中支付。  - **false**，表示手动从账户中支付，默认为该方式。   |
| nodes       | 是    | Array of [表 EnlargeNodeInfo] objects | 节点信息列表。 最小：**1** 最大：实例下最大节点个数不超过32                                                                                                                                                                                                    |
   
 表4EnlargeNodeInfo 
| 参数             | 是否必选 | 参数类型   | 描述                                                                                   |
|:---|:---|:---|:---|
| available_zone | 是    | String | 节点可用区。取值非空，请参见[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/DDM)。 |
   
#### 请求示例
扩容按需实例的节点，需要扩容的节点数量为1。
```
POST https://{endpoint}/v3/{project_id}/instances/{instance_id}/nodes
{
     "nodes": [
        {
            "available_zone": "az1"
        }
    ]
}
```
扩容按需实例的节点，实例有多个组，组下有多个子网，需要扩容的节点数量为1。
```
POST https://{endpoint}/v3/{project_id}/instances/{instance_id}/nodes
{
    "group_id": "efd077a3a50e460c8ba62e1956363299gr09",
    "subnet_id": "ead1e945-ca89-45dd-bcce-4a30b2054c22",
     "nodes": [
        {
            "available_zone": "az1"
        }
    ]
}
```
扩容包周期实例的节点，需要扩容的节点数量为1，自动从账户余额中支付。
```
POST https://{endpoint}/v3/{project_id}/instances/{instance_id}/nodes
{
    "is_auto_pay" : true,
     "nodes": [
        {
            "available_zone": "az1"
        }
    ]
}
```
#### 响应消息
- 正常响应参数说明
  表5响应Body参数 
  | 参数       | 参数类型   | 描述                                                             |
  |:---|:---|:---|
  | job_id   | String | 节点扩容任务ID。 仅按需实例节点扩容时会返回该参数。 |
  | order_id | String | 订单号，仅包年包月实例节点扩容时返回该参数。                                         |
     
  
- 正常响应示例 按需：
  ```
  {
    "job_id": "eff1d289-4d03-4942-8b9f-463ea07c000c"
  }
  ```
  包周期：
  ```
  {
    "order_id" : "CS1810251738L8VVD" 
  }
  ```
  
 
- 异常响应 请参见[异常请求结果](https://support.huaweicloud.com/api-ddm/ddm_api_01_0059.html)。
  
#### 状态码
- 正常 202
  
- 异常 请参见[状态码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0060.html)。
  
 
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0061.html)。