绑定证书到域名
功能介绍
绑定证书到域名
URI
POST /v1/{project_id}/waf/certificate/{certificate_id}/apply-to-hosts
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID，对应控制台用户名->我的凭证->项目列表->项目ID |
|
certificate_id |
是 |
String |
https证书id，您可以通过调用查询证书列表（ListCertificates）接口获取证书id |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
enterprise_project_id |
否 |
String |
您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token，通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
|
Content-Type |
是 |
String |
内容类型 缺省值：application/json;charset=utf8 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
cloud_host_ids |
否 |
Array of strings |
云模式HTTPS域名id，通过查询云模式防护域名列表（ListHost）接口获取 |
|
premium_host_ids |
否 |
Array of strings |
独享模式HTTPS域名id，通过独享模式域名列表（ListPremiumHost）接口获取 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
证书id |
|
name |
String |
证书名 |
|
timestamp |
Long |
时间戳 |
|
expire_time |
Long |
过期时间 |
|
bind_host |
Array of CertificateBundingHostBody objects |
绑定域名列表 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
域名id |
|
hostname |
String |
域名 |
|
waf_type |
String |
waf模式（分为云模式：cloud,独享模式：premium） 枚举值：
|
状态码： 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误信息 |
状态码： 401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误信息 |
状态码： 500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误信息 |
请求示例
POST https://{Endpoint}/v1/{project_id}/waf/certificate/{certificate_id}/apply-to-hosts?enterprise_project_id=0
{
"cloud_host_ids" : [ "85e554189d494c0f97789e93531c9f90" ],
"premium_host_ids" : [ "4e9e97c425fc463c8f374b90124e8392" ]
}
响应示例
状态码： 200
OK
{
"id" : "3ac1402300374a63a05be68c641e92c8",
"name" : "www.abc.com",
"timestamp" : 1636343349139,
"expire_time" : 1650794100000,
"bind_host" : [ {
"id" : "e350cf556da34adab1f017523d1c05ed",
"hostname" : "www.demo.com",
"waf_type" : "cloud",
"bandwidth" : 0,
"qps" : 0
} ]
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
请求失败 |
|
401 |
token权限不足 |
|
500 |
服务器内部错误 |
错误码
请参见错误码。
