# 创建配置 - CreateConfiguration #### 功能介绍 创建一条配置。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cse/cse_06_0081.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | cse:namespace:update | read | engine | - [g:ResourceTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) | cse:namespace:write | - | #### URI POST /v1/{project_id}/kie/kv 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 请填固定值：default。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Authorization | 否 | String | 若ServiceComb引擎专享版开启了安全认证，此参数必填。否则，无此参数。 开启了安全认证的ServiceComb引擎专享版Token，格式为： ``` Authorization:Bearer {Token} ``` Token获取方法，请参考[获取ServiceComb引擎专享版用户Token](https://support.huaweicloud.com/api-cse/cse_06_0035.html)。 | | X-Authorization | 否 | String | 若ServiceComb引擎专享版开启了安全认证，此参数必填。否则，无此参数。 开启了安全认证的ServiceComb引擎专享版Token，格式为： ``` X-Authorization:Bearer {Token} ``` Token获取方法，请参考[获取ServiceComb引擎专享版用户Token](https://support.huaweicloud.com/api-cse/cse_06_0035.html)。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | key | 是 | String | 配置的key。 | | value | 否 | String | 配置的value。 | | labels | 否 | Map\ | 配置的labels。 | | status | 否 | String | 配置的状态。 **取值范围：** - enabled：配置可用。 - disabled：配置不可用。 | | value_type | 否 | String | 配置value的类型。 **取值范围：** - text - yaml - json - properties - ini - xml | #### 响应参数 **状态码： 200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | kie | [SingleKieInfo] | 配置信息。 | 表5SingleKieInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 配置id。 | | key | String | 配置的key。 | | value | String | 配置的value。 | | value_type | String | 配置value的类型。 **取值范围：** - text - yaml - json - properties - ini - xml | | status | String | 配置的状态。 **取值范围：** - enabled：配置可用。 - disabled：配置不可用。 | | create_time | String | 配置的创建时间。 | | update_time | String | 配置的更新时间。 | | labels | Map\ | 配置的标签信息。 | | create_revision | Integer | 配置的创建版本号。 | | update_revision | Integer | 配置的修改版本号。 | **状态码： 400** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误代码。 | | error_message | String | 错误信息。 | **状态码： 500** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误代码。 | | error_message | String | 错误信息。 | #### 请求示例 创建一条配置，其标签信息为： "key1": "value1"， "key2": "value2"。 ``` POST https://{endpoint}/v1/{project_id}/kie/kv { "key": "String", "value": "String", "labels": { "key1": "value1", "key2": "value2", }, "status": "String", "value_type": "String" } ``` #### 响应示例 **状态码： 200** 创建成功，返回配置信息。 ``` { "id": "8a9e6a5d-8d65-48fb-a40c-5150c8479da8", "key": "string", "labels": { "key1": "value1", "key2": "value2" }, "value": "string", "value_type": "text", "status": "enabled", "create_time": 1623139038, "update_time": 1623139038, "create_revision": 13, "update_revision": 13, } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 创建成功。 | | 400 | 错误的请求。 | | 409 | 创建的配置已存在。 | | 500 | 服务内部错误。 | #### 错误码 请参见[ServiceComb错误码](https://support.huaweicloud.com/api-cse/cse_06_0110.html)。