导入配置文件 - ImportConfigurationFile
功能介绍
此API用于通过导入zip压缩包创建配置文件。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
servicestage:config:import
write
-
-
-
-
URI
POST /v3/{project_id}/cas/configs/import
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 参数解释: 租户项目ID。获取方法,请参考获取项目ID。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
请求消息
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Content-Type | 是 | String | 参数解释: 消息体的类型(格式)。 约束限制: 不涉及 取值范围: application/json;charset=utf8 默认取值: 不涉及 |
X-Auth-Token | 是 | String | 参数解释: 调用接口的认证方式分为Token和AK/SK两种,如果您使用的Token方式,此参数为必填,请填写Token的值。Token获取方式,请参考认证鉴权。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
upload_file | 是 | File | 参数解释: 导入的配置文件。 约束限制: 导入的配置文件需要压缩成zip格式,且压缩包文件大小不能超过500KB。 导入的压缩包中的配置文件数不能超过500个。 压缩包中的文件夹名称为配置分组名称,文件名称为配置名称,文件类型支持yaml、properties格式。 |
repetition_policy | 否 | String | 参数解释: 导入配置文件中同名配置文件处理策略。 取值范围:
默认取值: 不涉及 |
响应消息
参数 | 参数类型 | 描述 |
|---|---|---|
covered_num | Integer | 参数解释: 导入配置文件中被覆盖的配置文件数量。 取值范围: 不涉及 |
skip_num | Integer | 参数解释: 导入配置文件中跳过的配置文件数量。 取值范围: 不涉及 |
total_num | Integer | 参数解释: 导入配置文件的数量。 取值范围: 不涉及 |
请求示例
导入配置文件,文件绝对路径为/root/configfile.zip。
{
"upload_file" : "/root/configfile.zip"
} 响应示例
{
"covered_num" : 0,
"total_num" : 1
} 状态码
状态码 | 描述 |
|---|---|
204 | 操作成功。 |
400 | 错误的请求。 |
404 | 请求对象不存在。 |
500 | 内部错误。 |
错误码
请参考ServiceStage错误码。

