4.2 域名配置
4.2.18 一个证书批量设置多个域名
响应示例
状态码: 200 OK
{ "status" : false }
状态码
状态码 描述
200 OK
错误码
请参见错误码。
4.2.18 一个证书批量设置多个域名
功能介绍
一个证书配置多个域名,设置域名强制https回源参数。
调试
您可以在API Explorer中调试该接口。
URI
PUT /v1.0/cdn/domains/config-https-info
表4-153 Query 参数
参数 是否必选 参数类型 描述
enterprise_pro
ject_id 否 String 当用户开启企业项目功能时,该
参数生效,表示查询资源所属项 目,不传表示查询默认项目。注 意:当使用子账号调用接口时,
该参数必传。
请求参数
表4-154 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。
通过调用IAM服务获取用户 Token接口获取(响应消息头中 X-Subject-Token的值)。
表4-155 请求 Body 参数
参数 是否必选 参数类型 描述
https 否 UpdateDoma
inMultiCertifi catesRequest BodyContent object
https对象。
表4-156 UpdateDomainMultiCertificatesRequestBodyContent
参数 是否必选 参数类型 描述
domain_name 是 String 域名列表,逗号分割,上限50个 域名
参数 是否必选 参数类型 描述
https_switch 是 Integer https开关(0:"关闭";1:"设 置证书" https_switch为1时,证 书参数不能为空)
access_origin_
way 否 Integer 回源方式:1:"回源跟随";2:
"http"(默认),3:"https" 为空 值时默认设置为http
force_redirect
_https 否 Integer 强制跳转HTTPS(0:不强制;
1:强制) 为空值时默认设置为 关闭。(建议使用
force_redirect_config修改配 置)
force_redirect
_config 否 ForceRedirect
object 强制跳转
http2 否 Integer http2.0(0:关闭;1:开启)
为空值时默认设置为关闭
cert_name 否 String 证书名称(设置证书必填)(长
度限制为3-32字符)。
certificate 否 String 证书内容(设置证书必填)
private_key 否 String 私钥内容(设置证书必填)
certificate_typ
e 否 Integer 证书类型(0为自有证书 ;1为
托管证书,此时不必不传入证书 内容和私钥,自动根据证书名称 匹配;不传默认为自有证书)
表4-157 ForceRedirect
参数 是否必选 参数类型 描述
switch 是 Integer 强制跳转开关。1打开。0关
闭。
redirect_type 否 String 强制跳转类型。http:强制跳转 HTTP。https:强制跳转 HTTPS。
响应参数
状态码: 200
表4-158 响应 Body 参数
参数 参数类型 描述
https UpdateDoma inMultiCertifi catesRespons eBodyConten t object
https对象。
表4-159 UpdateDomainMultiCertificatesResponseBodyContent
参数 参数类型 描述
domain_name String 域名列表
https_switch Integer https开关(0:"关闭";1:"设置证书") access_origin_
way Integer 回源方式:1:"PROTOCOL_FOLLOW";2:
"HTTP"(默认),3:"https"
force_redirect
_https Integer 强制跳转HTTPS(0:不强制;1:强制) 为空值 时默认设置为关闭。(建议使用
force_redirect_config修改配置)
force_redirect
_config ForceRedirect
object 强制跳转
http2 Integer http2.0(0:关闭;1:开启)
cert_name String 证书名称。(长度限制为3-32字符)。
certificate String 证书内容 certificate_typ
e Integer 证书类型(0为自有证书 , 1为托管证书)
expiration_tim
e Long 证书过期时间
表4-160 ForceRedirect
参数 参数类型 描述
switch Integer 强制跳转开关。1打开。0关闭。
redirect_type String 强制跳转类型。http:强制跳转HTTP。https:强 制跳转HTTPS。
请求示例
{ "https" : {
"domain_name" : "example1.com", "access_origin_way" : 2,
"http2" : 0,
"certificate_type" : 0, "force_redirect_config" : { "redirect_type" : "https", "switch" : 1
},
"https_switch" : 1,
"cert_name" : "cdn_test_cert",
"certificate" : "---BEGIN CERTIFICATE---END CERTIFICATE---",
"private_key" : "---BEGIN RSA PRIVATE KEY---END RSA PRIVATE KEY---"
}}
响应示例
状态码: 200 OK
{ "https" : {
"domain_name" : "example1.com", "https_switch" : 1,
"access_origin_way" : 2, "force_redirect_https" : 1, "force_redirect_config" : { "redirect_type" : "https", "switch" : 1
},
"http2" : 0,
"expiration_time" : 1925791912000, "cert_name" : "cdn_test_cert",
"certificate" : "---BEGIN CERTIFICATE---END CERTIFICATE---", "certificate_type" : 0
}}
您可以在API Explorer中调试该接口。