
# 创建参数组V3
#### 功能介绍
创建参数组
#### URI
POST /v3/{project_id}/configurations
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                       |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户在某一region下的project ID。 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                  |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
   
表3请求Body参数 
| 参数          | 是否必选 | 参数类型                 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| name        | 是    | String               | 参数组名称。 参数模板名称在1到64个字符之间，区分大小写，可包含字母、数字、中划线、下划线或句点，不能包含其他特殊字符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| description | 是    | String               | 参数组描述。 描述不能超过256位，且不能包含回车和特殊字符 ! \< " = ' \> \&。 描述超过256个字符时，仍能创建参数组成功，会自动截取前256个字符的描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| values      | 否    | Map\<String,String\> | **参数解释**： 参数值对象，用户基于默认参数模板自定义的参数值。 **约束限制**： 不涉及。 **取值范围**： - key：参数名称，如"contains_shard_key"，"connection_idle_timeout"。为空时不修改参数值。   - value：参数值，如"6"，"20"。key不为空时value也不可为空。    **默认取值**： 不涉及。 |
   
#### 请求示例
创建参数组
```
POST https://{endpoint}/v3/{project_id}/configurations
{
  "name" : "param1688972688",
  "description" : "test"
}
```
#### 响应参数
- 正常响应参数说明
表4响应Body参数 
| 参数   | 参数类型   | 描述     |
|:---|:---|:---|
| id   | String | 参数组id。 |
| name | String | 名称。    |
   
#### 响应示例
- 正常响应示例
```
{
  "id": "404f3bbb8a724f7697e7fb15a1b09370pr09",
  "name": "param1688972688"
}
```
- 异常响应 请参见[异常请求结果](https://support.huaweicloud.com/api-ddm/ddm_api_01_0059.html)。
  
#### 状态码
- 正常 200
  
- 异常 请参见[状态码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0060.html)。
  
 
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0061.html)。
