# 创建实例组
#### 功能介绍
创建DDM实例组。
#### 接口约束
无
#### 调试
您可以在[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}/groups
  
- 参数说明
  表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参数 
| 参数         | 是否必选 | 参数类型                                                               | 描述                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| name       | 是    | String                                                             | DDM实例组名称，命名要求如下。 - 长度为4-64个字符。  - 必须以字母开头。  - 可以包含字母、数字、中划线、下划线、不能包含其它特殊字符。   最小长度：**4** 最大长度：**64** |
| type       | 是    | String                                                             | 实例组的类型。 rw：读写组 r：只读组                                                                                                                                                                                                                                                                                                                            |
| flavor_id  | 否    | String                                                             | 规格ID（规格ID和规格码必须传一个）。 获取方法参见[查询DDM可用区规格信息](https://support.huaweicloud.com/api-ddm/ddm_api_01_0016.html)。                                                                                                                                                                                                                                                                         |
| flavor_ref | 否    | String                                                             | 规格码（规格ID和规格码必须传一个）。 获取方法参见[查询DDM可用区规格信息](https://support.huaweicloud.com/api-ddm/ddm_api_01_0016.html)。                                                                                                                                                                                                                                                                          |
| nodes      | 是    | Array of [表 NodeInfo] objects | 节点信息列表。 最小：**1** 最大：**32**                                                                                                                                                                                                                                                                                                                       |
   
 表4NodeInfo 
| 参数             | 是否必选 | 参数类型   | 描述                                                                                   |
|:---|:---|:---|:---|
| available_zone | 是    | String | 节点可用区。取值非空，请参见[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/DDM)。 |
| subnet_id      | 是    | String | 子网ID。                                                                                |
   
#### 请求示例
创建DDM实例组，组类型：读写，节点数为1个。
```
POST https://{endpoint}/v3/{project_id}/instances/{instance_id}/groups
{
    "name": "group-1",
    "type": "rw",
    "flavor_id": "a615922f-0ed8-3691-aad4-a595185febba",
     "nodes": [
        {
            "available_zone": "az1", 
            "subnet_id": "ead1e945-ca89-45dd-bcce-4a30b2054c22"
        }
    ]
}
```
创建DDM实例组，组类型：读，节点数为1个。
```
POST https://{endpoint}/v3/{project_id}/instances/{instance_id}/groups
{
    "name": "group-2",
    "type": "r",
    "flavor_id": "a615922f-0ed8-3691-aad4-a595185febba",
     "nodes": [
        {
            "available_zone": "az1", 
            "subnet_id": "ead1e945-ca89-45dd-bcce-4a30b2054c22"
        }
    ]
}
```
创建DDM实例组，组类型：读写，节点数为2个。
```
POST https://{endpoint}/v3/{project_id}/instances/{instance_id}/groups
{
    "name": "group-3",
    "type": "rw",
    "flavor_id": "a615922f-0ed8-3691-aad4-a595185febba",
     "nodes": [
        {
            "available_zone": "az1", 
            "subnet_id": "ead1e945-ca89-45dd-bcce-4a30b2054c22"
        },
        {
            "available_zone": "az2", 
            "subnet_id": "ead1e945-ca89-45dd-bcce-4a30b2054c22"
        }
    ]
}
```
#### 响应参数
- 正常响应参数说明
  表5响应Body参数 
  | 参数          | 参数类型   | 描述                                                           |
  |:---|:---|:---|
  | instance_id | String | DDM实例ID。                                                     |
  | job_id      | String | 创建组的任务ID。 仅创建按需实例时会返回该参数。 |
  | order_id    | String | 订单号，创建包年包月时返回该参数。                                            |
  | group_id    | String | 组ID。 仅创建按需实例时会返回该参数。        |
     
  
 
#### 响应示例
- 正常响应示例 按需：
  ```
  {
    "job_id": "3ae783f3-844e-4051-abd5-b9cc65899785",
    "group_id": "b4153b807b1a4f83870bf868fcc4f4ea****" 
  }
  ```
  包周期：
  ```
  {
    "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)。