更新时间:2023-09-27 GMT+08:00

导入配置

功能介绍

从配置管理中心导入配置信息。

URI

POST /v1/{project_id}/kie/file

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户子项目的唯一标识,字符长度为1~64位,获取方法请参考获取项目ID

表2 Query参数

参数

是否必选

参数类型

描述

override

String

force:强制导入,会覆盖重复项。

skip:跳过导入,会跳过重复项。

abort:终止导入,遇到重复项会停止导入操作。

label

String

指定label导入,格式为:{标签key}:{标签value},如果不填则按body的label导入。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

x-engine-id

String

待上传配置的引擎id,获取方法请参考查询微服务引擎专享版列表

X-Enterprise-Project-ID

String

企业项目id。

如果不配置此参数,则默认企业项目为“default”,ID为0。

表4 请求Body参数

参数

是否必选

参数类型

描述

upload_file

File

导入的文件,文件名格式为:fileName.json

文件格式为:

{
    "data": [
        {
            "key": "keyItem1",
            "value": "valueItem1",
            "labels":{
                "1": "1"
            },
            "status": "enabled",
            "value_type": "text"
        }
    ]
}

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

success

List<KVDoc>

导入成功的配置项列表

failure

List<DocFailedOfUpload>

导入失败的配置项列表

表6 KVDoc

参数

参数类型

描述

id

String

配置id

key

String

配置的key

value

String

配置的value

value_type

String

配置value的类型

status

String

配置的状态

create_time

Integer

配置的创建时间

update_time

Integer

配置的更新时间

create_revision

Integer

创建配置的版本号

update_revision

Integer

修改配置的版本号

labels

Map<String,String>

配置的标签信息

表7 DocFailedOfUpload

参数

参数类型

描述

key

String

导入失败配置项的key

labels

Map<String,String>

导入失败配置项的labels信息

error_code

String

错误代码

error_message

String

错误信息

状态码: 400

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误代码

error_message

String

错误信息

detail

String

详细定位信息

状态码: 500

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误代码

error_message

String

错误信息

detail

String

详细定位信息

请求示例

导入配置文件,当存在相同配置时,会强制导入覆盖重复项,按body的label导入。

POST https://{endpoint}/v1/{project_id}/kie/file/override=force

----WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="upload_file"; filename="custom_1663124521493.json"
Content-Type: application/json
----WebKitFormBoundary7MA4YWxkTrZu0gW

响应示例

查询成功

{
    "success": [
        {
            "id": "7e2d346e-d907-4871-bf51-a17fc7e52ad4",
            "key": "2",
            "value": "2",
            "value_type": "text",
            "create_revision": 3,
            "update_revision": 3,
            "status": "enabled",
            "create_time": 1636374809,
            "update_time": 1636374809,
            "labels": {
                "2": "2",
                "environment": "production"
            }
        },
        {
            "id": "907b3891-c691-4ae0-816f-e91eba705e28",
            "key": "1",
            "value": "1",
            "value_type": "text",
            "create_revision": 4,
            "update_revision": 4,
            "status": "enabled",
            "create_time": 1636374809,
            "update_time": 1636374809,
            "labels": {
                "1": "1",
                "environment": "production"
            }
        }
    ],
    "failure": []
}

状态码

状态码

描述

200

导入成功。

400

错误的请求。

500

服务内部错误。

错误码

请参见CSE错误码