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

导入配置文件

功能介绍

此API用于通过导入zip压缩包创建配置文件。

URI

POST /v3/{project_id}/cas/configs/import

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户项目ID。获取方法,请参考获取项目ID

请求消息

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

消息体的类型(格式),设置为:

multipart/form-data

X-Auth-Token

String

调用接口的认证方式分为Token和AK/SK两种,如果您使用的Token方式,此参数为必填,请填写Token的值。Token获取方式,请参考认证鉴权

表3 请求Body参数

参数

是否必选

参数类型

描述

upload_file

File

导入的配置文件需要压缩成zip格式,且压缩包文件大小不能超过500KB。

导入的压缩包中的配置文件数不能超过500个。

压缩包中的文件夹名称为配置分组名称,文件名称为配置名称,文件类型支持yaml、properties格式。

repetition_policy

String

导入配置文件中同名配置文件处理策略:

  • covered:覆盖,用导入的配置文件替换分组下已有同名配置文件。
  • skip:跳过,跳过导入同名配置文件。

响应消息

表4 响应参数

参数

参数类型

描述

covered_num

Integer

导入配置文件中被覆盖的配置文件数量。

skip_num

Integer

导入配置文件中跳过的配置文件数量。

total_num

Integer

导入配置文件的数量。

请求示例

POST https://{endpoint}/v3/{project_id}/cas/configs/import
{repetition_policy=covered }

响应示例

{
	"covered_num" : 0,
	"total_num" : 1
}

状态码

状态码

描述

204

操作成功。

400

错误的请求。

404

请求对象不存在。

500

内部错误。

错误码

错误码格式为:SVCSTG.00100.[Error_ID],例如:SVCSTG.00100400。错误码说明请参考ServiceStage错误码