文档首页/ 微服务引擎 CSE/ API参考/ ServiceComb API/ 配置管理/ 修改配置 - ModifyConfiguration
更新时间：2025-11-20 GMT+08:00
查看PDF
分享

修改配置 - ModifyConfiguration

功能介绍

修改指定一条配置。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    cse:namespace:update

    read

    engine

    cse:namespace:write

    -

URI

PUT /v1/{project_id}/kie/kv/{kv_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

请填固定值：default。

kv_id

是

String

修改的指定配置的id，获取方法请参考查询配置列表。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Authorization

否

String

若ServiceComb引擎专享版开启了安全认证，此参数必填。否则，无此参数。

开启了安全认证的ServiceComb引擎专享版Token，格式为：

Authorization:Bearer {Token}

Token获取方法，请参考获取ServiceComb引擎专享版用户Token。
表3 请求Body参数

参数

是否必选

参数类型

描述

value

是

String

配置的value。

status

否

String

配置的状态。

枚举值：

  • enabled
  • disabled

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

kie

SingleKieInfo

一条配置信息。

状态码： 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错误码。

父主题： 配置管理

相关文档