Queries domain names that have Web Application Firewall (WAF) enabled and the relevant information, including the status of the access control list (ACL), protection against HTTP flood attacks, domain name configuration, and service activation.

Note The maximum number of times that users can call this operation per second is 150.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeDcdnWafDomain

The operation that you want to perform. Set the value to DescribeDcdnWafDomain.

RegionId String Yes cn-hangzhou

The region where WAF is enabled.

DomainName String No example.com

The accelerated domain names. If you do not specify an accelerated domain name, all accelerated domain names are queried.

Response parameters

Parameter Type Example Description
OutPutDomains Array of OutPutDomain

The information about the accelerated domain name. Valid values:

AclStatus Integer 1

The status of the ACL.

  • 0: disabled
  • 1: enabled
CcStatus Integer 1

The status of protection against HTTP flood attacks. Valid values:

  • 0: disabled
  • 1: enabled
Domain String example.com

The domain names that have WAF enabled.

Status Integer 1

The status of the domain name. Valid values:

  • 1: The domain name is added to WAF, or the domain name is valid
  • 10: The domain name is being added to WAF
  • 11: The domain name failed to be added to WAF
WafStatus Integer 1

The status of WAF. Valid values:

  • 0: disabled
  • 1: enabled
RequestId String CB1A380B-09F0-41BB-802B-72F8FD6DA2FE

The ID of the request.

TotalCount Integer 1

The number of accelerated domain names returned.

Examples

Sample requests

http://dcdn.aliyuncs.com?Action=DescribeDcdnWafDomain
&DomainName=example.com
&RegionId=cn-hangzhou
&<Common request parameters>|

Sample success responses

XML format

<TotalCount>1</TotalCount>
<OutputDomains>
    <AclStatus>1</AclStatus>
    <CcStatus>1</CcStatus>
    <Domain>example.com</Domain>
    <Status>1</Status>
    <WafStatus>1</WafStatus>
</OutputDomains>
<RequestId>CB1A380B-09F0-41BB-802B-72F8FD6DA2FE</RequestId>

JSON format

{
  "TotalCount": 1,
  "OutputDomains": [
    {
      "AclStatus": 1,
      "CcStatus": 1,
      "Domain": "example.com",
      "Status": 1,
      "WafStatus": 1
    }
  ],
  "RequestId": "CB1A380B-09F0-41BB-802B-72F8FD6DA2FE"
}

Error codes

HttpCode Error code Error message Description
400 InvalidParameter The specified parameter is invalid. The error message returned because a parameter is set to an invalid value.
400 InvalidDomainName The specified DomainName is invalid. The error message returned because DomainName is set to an invalid value. Specify a valid value.
404 InvalidDomain.NotFound The specified domain does not exist. The error message returned because the specified domain name does not exist.

For a list of error codes, visit the API Error Center.