更新时间:2024-12-18 GMT+08:00
分享

批量推送证书

功能介绍

批量推送SSL证书到弹性负载均衡(Elastic Load Balance,简称ELB)、Web应用防火墙(Web Application Firewall,WAF)、CDN(Content Delivery Network,内容分发网络)等其它华为云产品中。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v3/scm/certificates/{certificate_id}/batch-push

表1 路径参数

参数

是否必选

参数类型

描述

certificate_id

String

证书id。

最小长度:16

最大长度:16

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

最小长度:32

最大长度:2097152

表3 请求Body参数

参数

是否必选

参数类型

描述

target_projects

Array of strings

推送到的目标服务所在的区域,CDN、ELB、WAF。

最小长度:1

最大长度:32

数组长度:1 - 10

target_service

String

证书推送的目标服务,当前仅支持:CDN、WAF、ELB。

最小长度:1

最大长度:64

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

results

Array of results objects

部署结果。

数组长度:1 - 10

表5 results

参数

参数类型

描述

project_name

String

推送区域名称,如cn-north-7。

最小长度:0

最大长度:63

cert_id

String

目标证书ID。

最小长度:0

最大长度:255

message

String

推送结果。

最小长度:0

最大长度:255

状态码: 401

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误请求返回的错误码。

最小长度:3

最大长度:36

error_msg

String

错误请求返回的错误信息。

最小长度:0

最大长度:1024

状态码: 403

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误请求返回的错误码。

最小长度:3

最大长度:36

error_msg

String

错误请求返回的错误信息。

最小长度:0

最大长度:1024

状态码: 500

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误请求返回的错误码。

最小长度:3

最大长度:36

error_msg

String

错误请求返回的错误信息。

最小长度:0

最大长度:1024

请求示例

{
  "target_service" : "waf",
  "target_project" : "cn-north-7"
}

响应示例

状态码: 200

正常返回。

{
  "results" : [ {
    "project_name" : "cn-north-7",
    "cert_id" : "scs16751254852691",
    "message" : "success"
  } ]
}

状态码: 401

认证失败。

{
  "error_code" : "SCM.XXX",
  "error_msg" : "XXX"
}

状态码: 403

禁止访问。

{
  "error_code" : "SCM.XXX",
  "error_msg" : "XXX"
}

状态码: 500

请求未完成,服务器内部异常。

{
  "error_code" : "SCM.XXX",
  "error_msg" : "XXX"
}

状态码

状态码

描述

200

正常返回。

401

认证失败。

403

禁止访问。

404

访问页面未找到。

500

请求未完成,服务器内部异常。

错误码

请参见错误码

相关文档