更新时间:2023-08-24 GMT+08:00

创建防护域名

功能介绍

创建防护域名

URI

POST /v1/edgewaf/domains

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

表2 请求Body参数

参数

是否必选

参数类型

描述

domain_name

String

防护域名(可带端口),通过查询CDN域名接口获取

enterprise_project_id

String

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

policy_id

String

防护域名关联的策略id,通过查询WAF防护策略接口获取

certificate_id

String

证书id,通过查询证书列表接口(ListCertificates)接口获取证书id

  • 对外协议为HTTP时不需要填写

  • 对外协议HTTPS时为必填参数

  • 查询证书列表接口未开放时,从边缘安全控制台->边缘WAF->证书管理获取

web_tag

String

域名名称

description

String

域名描述

area_type

String

域名在CDN所属区域,通过查询CDN域名接口获取

枚举值:

  • mainland_china

  • outside_mainland_china

  • global

  • europe

响应参数

状态码: 400

表3 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码: 401

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码: 500

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

请求示例

添加domain_name到WAF防护域名

POST https://{Endpoint}/v1/edgewaf/domains

{
  "domain_name" : "domain_name",
  "enterprise_project_id" : 0,
  "policy_id" : "1771a426afcc4e16b8636cb72c2d53e4",
  "web_tag" : "domain_name",
  "description" : "demo",
  "area_type" : "outside_mainland_china"
}

响应示例

状态码

状态码

描述

200

请求成功

400

请求失败

401

token权限不足

500

服务器内部错误

错误码

请参见错误码