# 创建配置项 - CreateConfigMap
#### 功能介绍
创建配置项
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IEF/doc?api=CreateConfigMap)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ief/ief_02_1003.html)。
#### URI
POST /v2/{project_id}/edgemgr/configmaps
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述   |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID |
#### 请求参数
表2请求Header参数 
| 参数              | 是否必选 | 参数类型   | 描述                                                        |
|:---|:---|:---|:---|
| Content-Type    | 是    | String | 消息体的类型（格式），默认取值为"application/json"。                       |
| X-Auth-Token    | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
| ief-instance-id | 否    | String | 企业版实例ID，专业版实例为空值。                                         |
   
表3请求Body参数 
| 参数        | 是否必选 | 参数类型                                                    | 描述  |
|:---|:---|:---|:---|
| configmap | 是    | [ConfigMap] object | 配置项 |
   
 表4ConfigMap 
| 参数          | 是否必选 | 参数类型                 | 描述                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| name        | 是    | String               | 配置项名称，以小写英文字母开头，4-64位，可以使用小写英文、数字、中划线（-），不能以中划线结尾只允许中文字符、英文字母、数字、下划线、中划线，最大长度64                                                                                                                                        |
| description | 否    | String               | 配置项描述，最大长度255，不允许\^ \~ # $ % \& \* \< \> ( ) \[ \] { } ' " \\                                                                                                                                                          |
| configs     | 否    | Map\<String,String\> | configs是一个字典，由多个键值对组成，json化后最大总长度为1048576，key和value均为字符串。键值对中key由大小写字母或中划线开头，由数字、大小写字母、点号（.）、中划线（-）、下划线（_）组成，最小长度为1，最大长度63个字符， 键值对中的value无其它限制。注：configs字典的长度即字典转为标准的字符串后的长度，例如字典{"a": "b"}转为标准字符串后为'{"a": "b"}'，长度为10 |
   
#### 响应参数
**状态码：201**
表5响应Body参数 
| 参数        | 参数类型                                                             | 描述  |
|:---|:---|:---|
| configmap | [ConfigMapResp] object | 配置项 |
   
 表6ConfigMapResp 
| 参数          | 参数类型                 | 描述     |
|:---|:---|:---|
| id          | String               | 配置项ID  |
| name        | String               | 配置项名称  |
| description | String               | 配置项描述  |
| configs     | Map\<String,String\> | 配置项键列表 |
| project_id  | String               | 项目ID   |
| created_at  | String               | 创建时间   |
| updated_at  | String               | 更新时间   |
   
#### 请求示例
创建配置项，输入配置项键值对。
```
{
  "configmap" : {
    "name" : "test-cm",
    "description" : "this is a test cm",
    "configs" : {
      "key1" : "val1 ",
      "key2" : "val2 "
    }
  }
}
```
#### 响应示例
**状态码：201**
ok
```
{
  "configmap" : {
    "id" : "12ns9eb6cc0d49a0941df2f31283mds8 ",
    "name" : "test-cm",
    "description" : "this is a test cm",
    "configs" : {
      "key1" : "val-1",
      "key2" : "val-2"
    },
    "project_id" : "d16e6eb6cc0d49a0941df2f31285757a",
    "created_at" : "2018-07-16T13:41:25.347335",
    "updated_at" : "2018-07-18T13:41:25.347335"
  }
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 201 | ok |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ief/ErrorCode.html)。