Querying Domain Name Settings in Dedicated Mode

Function

This API is used for querying domain name settings in dedicated mode.

URI

GET /v1/{project_id}/premium-waf/host/{host_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID
host_id	Yes	String	ID of the domain name protected by the dedicated WAF engine

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
enterprise_project_id	No	String	ID of the enterprise project. It can be obtained by calling the ListEnterpriseProject API of EPS.

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
Content-Type	Yes	String	Content type Default: application/json;charset=utf8
X-Auth-Token	Yes	String	User token. It can be obtained by calling the IAM API (value of X-Subject-Token in the response header).

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
id	String	Domain name ID
policyid	String	ID of the policy initially used to the domain name. It can be obtained by calling the ListPolicy API.
hostname	String	Domain name added to dedicated WAF.
domainid	String	User domain ID
project_id	String	Project ID
access_code	String	CNAME prefix
protocol	String	HTTP protocol
server	Array of PremiumWafServer objects	Origin server details
certificateid	String	HTTPS certificate ID. It can be obtained by calling the ListCertificates API. This parameter is not required if Client Protocol is set to HTTP. This parameter is mandatory if Client Protocol is set to HTTPS.
certificatename	String	Certificate name. This parameter is not required if Client Protocol is set to HTTP. This parameter is mandatory if Client Protocol is set to HTTPS.
proxy	Boolean	Whether the proxy is enabled. true: The proxy is enabled. false: The proxy is disabled.
locked	Integer	Locked Status Default: 0
protect_status	Integer	WAF status of the protected domain name. -1: Bypassed. Requests are directly sent to the backend servers without passing through WAF. 0: Suspended. WAF only forwards requests for the domain name but does not detect attacks. 1: Enabled. WAF detects attacks based on the configured policy.
access_status	Integer	Specifies whether a domain name is connected to WAF. 0: disconnected 1: connected
web_tag	String	Website name.
timestamp	Long	Time a domain name is added to WAF.
flag	Flag object	Special domain name identifier. This parameter is used for console only.
block_page	BlockPage object	Alarm configuration page
extend	Map<String,String>	Extended attribute
traffic_mark	TrafficMark object	Stream tag
timeout_config	TimeoutConfig object	Timeout settings
access_progress	Array of Access_progress objects	Redundant parameter. It is used for console only.

**Table 5** PremiumWafServer
Parameter	Type	Description
front_protocol	String	Client protocol used to request access to the origin server. Enumeration values: HTTP HTTPS
back_protocol	String	Server protocol used when WAF forwards client requests to the origin server. Enumeration values: HTTP HTTPS
address	String	Public IP address or domain name of the origin server that the client accesses.
port	Integer	Port number used by the web server. The value ranges from 0 to 65535, for example, 8080.
type	String	The origin server address is an IPv4 or IPv6 address. Enumeration values: ipv4 ipv6
vpc_id	String	VPC ID. Perform the following steps to obtain the VPC ID: 1.Find the name of the VPC where the dedicated engine is located. The VPC name is in the VPC\Subnet column. Log in to the WAF console and choose Instance Management > Dedicated Engine > VPC\Subnet. 2.Log in to the VPC console and click the VPC name. On the page displayed, copy the VPC ID in the VPC Information area.

**Table 6** Flag
Parameter	Type	Description
pci_3ds	String	Whether your website passes PCI 3DS check. true: Your website passed the PCI 3DS check. false: Your website failed the PCI 3DS check. Enumeration values: true false
pci_dss	String	Whether your website passes PCI DSS check true: Your website passed the PCI DSS check. false: Your website failed the PCI DSS check. Enumeration values: true false
cname	String	The CNAME record the domain name is using old: The domain name uses the old CNAME record. new: The domain name uses a new CNAME record. Enumeration values: old new
is_dual_az	String	Whether WAF supports multi-AZ DR. true: WAF supports multi-AZ disaster recovery (DR). false: WAF does not support multi-AZ DR. Enumeration values: true false

**Table 7** BlockPage
Parameter	Type	Description
template	String	Template name
custom_page	CustomPage object	Custom alarm page
redirect_url	String	Redirection URL

**Table 8** CustomPage
Parameter	Type	Description
status_code	String	Status code
content_type	String	Content type of alarm page
content	String	Page content

**Table 9** TrafficMark
Parameter	Type	Description
sip	Array of strings	IP address in the known attack source rule
cookie	String	cookie
params	String	Parameters

**Table 10** TimeoutConfig
Parameter	Type	Description
connect_timeout	Integer	Timeout for WAF to connect to the origin server.
send_timeout	Integer	Timeout for WAF to send requests to the origin server.
read_timeout	Integer	Timeout for WAF to receive responses from the origin server.

**Table 11** Access_progress
Parameter	Type	Description
step	Integer	Step
status	Integer	Status

Status code: 400

**Table 12** Response body parameters
Parameter	Type	Description
error_code	String	Error Code
error_msg	String	Error Messages

Status code: 401

**Table 13** Response body parameters
Parameter	Type	Description
error_code	String	Error Code
error_msg	String	Error Messages

Status code: 500

**Table 14** Response body parameters
Parameter	Type	Description
error_code	String	Error Code
error_msg	String	Error Messages

Example Requests

GET https://{Endpoint}/v1/{project_id}/premium-waf/host/{host_id}?enterprise_project_id=0

Example Responses

Status code: 200

{
  "id" : "ee896796e1a84f3f85865ae0853d8974",
  "hostname" : "www.demo.com",
  "protocol" : "HTTPS",
  "server" : [ {
    "address" : "1.2.3.4",
    "port" : 443,
    "type" : "ipv4",
    "weight" : 1,
    "front_protocol" : "HTTPS",
    "back_protocol" : "HTTPS",
    "vpc_id" : "ebfc553a-386d-4746-b0c2-18ff3f0e903d"
  } ],
  "proxy" : false,
  "locked" : 0,
  "timestamp" : 1650593801380,
  "flag" : {
    "pci_3ds" : "false",
    "pci_dss" : "false"
  },
  "description" : "",
  "policyid" : "df15d0eb84194950a8fdc615b6c012dc",
  "domainid" : "0ee78615ca08419f81f539d97c9ee353",
  "projectid" : "550500b49078408682d0d4f7d923f3e1",
  "protect_status" : 1,
  "access_status" : 0,
  "certificateid" : "360f992501a64de0a65c50a64d1ca7b3",
  "certificatename" : "certificatename75315",
  "web_tag" : "",
  "timeout_config" : {
    "connect_timeout" : 30,
    "read_timeout" : 180,
    "send_timout" : 180
  }
}