# 修改配置 - ModifyConfiguration
#### 功能介绍
修改指定一条配置。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cse/cse_06_0081.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                  | 访问级别 | 资源类型（\*为必须） | 条件键                                                                                                                                                                                                                                                                                                                                                                                                                | 别名                  | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | cse:namespace:update | read | engine      | - [g:ResourceTag/\<tag-key\>](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
PUT /v1/{project_id}/kie/kv/{kv_id}
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                    |
|:---|:---|:---|:---|
| project_id | 是    | String | 请填固定值：default。                                                                        |
| kv_id      | 是    | String | 修改的指定配置的id，获取方法请参考[查询配置列表](https://support.huaweicloud.com/api-cse/cse_06_0064.html)。 |
   
#### 请求参数
表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参数 
| 参数     | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| value  | 是    | String | 配置的value。                                                                                                                                                                                                                                                              |
| status | 否    | String | 配置的状态。 **取值范围：** - enabled：配置可用。  - disabled：配置不可用。   |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数  | 参数类型                                                                                                   | 描述      |
|:---|:---|:---|
| kie | [SingleKieInfo](https://support.huaweicloud.com/api-cse/cse_06_0061.html#cse_06_0061__table7234001183) | 一条配置信息。 |
   
**状态码： 400**
表5响应Body参数 
| 参数            | 参数类型   | 描述    |
|:---|:---|:---|
| error_code    | String | 错误代码。 |
| error_message | String | 错误信息。 |
   
**状态码： 500**
表6响应Body参数 
| 参数            | 参数类型   | 描述    |
|:---|:---|:---|
| error_code    | String | 错误代码。 |
| error_message | String | 错误信息。 |
   
#### 请求示例
修改配置ID为8a9e6a5d-8d65-48fb-a40c-5150c8479da8的配置值为this is a test，设置其配置状态为enabled。
```
PUT https://{endpoint}/v1/{project_id}/kie/kv/8a9e6a5d-8d65-48fb-a40c-5150c8479da8
{
    "value": "this is a test",
    "status": "enabled"
}
```
#### 响应示例
**状态码： 200**
修改成功，返回配置信息。
```
{   
    "id": "8a9e6a5d-8d65-48fb-a40c-5150c8479da8",   
    "key": "string",   
    "labels": {     
        "key1": "value1",
        "key2": "value2"
    },   
    "value": "this is a test",   
    "value_type": "text",   
    "status": "enabled",   
    "create_time": 1623139038,   
    "update_time": 1623139038,
    "create_revision": 13,
    "update_revision": 13,
}
```
#### 状态码
| 状态码 | 描述      |
|:---|:---|
| 200 | 修改成功。   |
| 400 | 错误的请求。  |
| 500 | 服务内部错误。 |
   
#### 错误码
请参见[ServiceComb错误码](https://support.huaweicloud.com/api-cse/cse_06_0110.html)。