绑定证书到域名
功能介绍
绑定证书到域名
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 | 服务器内部错误 |
错误码
请参见错误码。
