Connecting a Domain Name to WAF

Function Description

This API is used to connect a domain name to WAF.

URI

• URI format

  PUT /v1/{project_id}/waf/instance/{instance_id}/access_status

• Parameter description

  Table 1 Path parameters

  Parameter	Mandatory	Type	Description
  projecte_id	Yes	String	Specifies the project ID.
  instance_id	Yes	String	Specifies the instance ID.

Request

Request parameters

Table 2 Parameter description

Parameter	Mandatory	Type	Description
access_status	Yes	Integer	Specifies whether a domain name is connected to WAF. 1: The domain name is connected to WAF.

Response

Response parameters

Table 3 Parameter description

Parameter	Mandatory	Type	Description
access_status	Yes	Integer	Specifies whether a domain name is connected to WAF. 1: The domain name is connected to WAF. 0: The domain name is not connected to WAF.
protect_status	Yes	Integer	Specifies the WAF mode of a domain name. 1: enabled. 0: disabled. -1: bypassed. That is, a client sends a request to the server without passing through WAF.

Examples

access_status with a value of 1 is used as an example.

• Request example

  {
   "access_status": 1
  }
  

• Response examples

  The following shows the response if the domain name is connected to WAF:

  {
    "access_status": 1,
    "protect_status": 1
  }
  

  The following shows the response if connection fails:

  {
   "access_status": 0,
   "protect_status": 0
  }
  

Status Code

Table 4 describes the normal status code returned by the API.

Table 4 Status code

Status Code	Description	Meaning
200	OK	The request has succeeded.

For details about error status codes, see Status Codes.

last updated: 2024-04-20 02:29