文档首页/微服务引擎 CSE/API参考/ServiceComb API/配置管理/创建配置 - CreateConfiguration
更新时间：2025-12-31 GMT+08:00
查看PDF
分享

创建配置 - CreateConfiguration

功能介绍

创建一条配置。

授权信息

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

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

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    cse:namespace:update

    read

    engine

    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。

表3 请求Body参数

参数

是否必选

参数类型

描述

key

是

String

配置的key。

value

否

String

配置的value。

labels

否

Map<String,String>

配置的labels。

status

否

String

配置的状态。

取值范围：

  • enabled：配置可用。
  • disabled：配置不可用。

value_type

否

String

配置value的类型。

取值范围：

  • text
  • yaml
  • json
  • properties
  • ini
  • xml

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

kie

SingleKieInfo

配置信息。

表5 SingleKieInfo

参数

参数类型

描述

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<String,String>

配置的标签信息。

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

父主题：配置管理