更新时间:2022-10-09 GMT+08:00

创建独享模式域名

功能介绍

创建独享模式域名

URI

POST /v1/{project_id}/premium-waf/host

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

用户的project_id

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

表3 请求Body参数

参数

是否必选

参数类型

描述

certificateid

String

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

  • 对外协议为HTTP时不需要填写 -对外协议HTTPS时为必填参数

certificatename

String

证书名

  • 对外协议为HTTP时不需要填写 -对外协议HTTPS时为必填参数

hostname

String

防护域名或IP(可带端口)

proxy

Boolean

是否使用代理

policyid

String

防护域名初始绑定的策略ID,可以通过策略名称调用查询防护策略列表(ListPolicy)接口查询到对应的策略id

server

Array of PremiumWafServer objects

独享模式回源服务器配置

表4 PremiumWafServer

参数

是否必选

参数类型

描述

front_protocol

String

对外协议

back_protocol

String

源站协议

address

String

源站地址

port

Integer

源站端口

type

String

源站地址为ipv4

vpc_id

String

VPC id,通过以下步骤获取VPC id: \n 1.找到独享引擎所在的虚拟私有云名称,VPC\子网这一列就是VPC的名称:登录WAF的控制台->单击系统管理->独享引擎->VPC\子网 \n 2.登录虚拟私有云 VPC控制台->虚拟私有云->单击虚拟私有云的名称->基本信息的ID

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

id

String

域名id

policyid

String

策略id

hostname

String

域名id

domainid

String

租户id

projectid

String

项目projectid

protocol

String

http协议

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码: 401

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码: 500

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

请求示例

{
  "hostname" : "www.test.com",
  "server" : [ {
    "front_protocol" : "HTTP",
    "back_protocol" : "HTTP",
    "vpc_id" : "34e414f6-2407-456b-b61d-93d64e9e56f0",
    "type" : "ipv4",
    "address" : "1.1.1.1",
    "port" : 80
  } ],
  "proxy" : true
}

响应示例

状态码

状态码

描述

200

OK

400

非法请求

401

Token无权限

500

服务器内部错误

错误码

请参见错误码