更新时间:2024-12-16 GMT+08:00

创建配置

功能介绍

创建一条配置。

URI

POST /v1/{project_id}/kie/kv

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

请填固定值:default。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Authorization

String

若微服务引擎专享版开启了安全认证,此参数必填。否则,无此参数。

开启了安全认证的微服务引擎专享版Token,格式为:

Authorization:Bearer {Token}

Token获取方法,请参考获取微服务引擎专享版用户Token

表3 请求Body参数

参数

是否必选

参数类型

描述

key

String

配置的key。

value

String

配置的value。

labels

Map<String,String>

配置的labels。

status

String

配置的状态。

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的类型。

status

String

配置的状态。

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