文档首页> Web应用防火墙 WAF> API参考> API> 证书管理> 绑定证书到域名
更新时间：2024-03-28 GMT+08:00
在线调试
CLI示例
查看PDF

绑定证书到域名

功能介绍

绑定证书到域名

调用方法

请参见如何调用API。

URI

POST /v1/{project_id}/waf/certificate/{certificate_id}/apply-to-hosts

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，对应华为云控制台用户名->我的凭证->项目列表->项目ID

certificate_id

是

String

https证书id，您可以通过调用查询证书列表（ListCertificates）接口获取证书id
表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

否

String

您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

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

Content-Type

是

String

内容类型

缺省值：application/json;charset=utf8
表4 请求Body参数

参数

是否必选

参数类型

描述

cloud_host_ids

否

Array of strings

云模式HTTPS域名id，通过查询云模式防护域名列表（ListHost）接口获取

premium_host_ids

否

Array of strings

独享模式HTTPS域名id，通过独享模式域名列表（ListPremiumHost）接口获取

响应参数

状态码： 200

表5 响应Body参数

参数

参数类型

描述

id

String

证书id

name

String

证书名

timestamp

Long

时间戳

expire_time

Long

过期时间

bind_host

Array of CertificateBundingHostBody objects

绑定域名列表
表6 CertificateBundingHostBody

参数

参数类型

描述

id

String

域名id

hostname

String

域名

waf_type

String

waf模式（分为云模式：cloud,独享模式：premium）

枚举值：

  • cloud

  • premium

状态码： 400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码： 401

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码： 500

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

请求示例

绑定项目id为project_id和证书id为certificate_id的证书到两个域名，分别为域名id为“85e554189d494c0f97789e93531c9f90”的云模式域名和域名id为“4e9e97c425fc463c8f374b90124e8392”的独享模式域名。

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"
  } ]
}

状态码

状态码

描述

200

OK

400

请求失败

401

token权限不足

500

服务器内部错误

错误码

请参见错误码。

父主题： 证书管理