DescribeDefenseResource - Web Application Firewall - Alibaba Cloud Documentation Center

Queries the information about a protected object.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	The ID of the Web Application Firewall (WAF) instance. Note You can call the DescribeInstance operation to query the ID of the WAF instance.	waf_v3prepaid_public_cn-4xl****i60i
ResourceManagerResourceGroupId	string	No	The ID of the Alibaba Cloud resource group.	rg-acfm***q
Resource	string	Yes	The name of the protected object that you want to query. Only exact queries are supported.	example.aliyundoc.com-waf
RegionId	string	No	The region in which the WAF instance is deployed. Valid values: cn-hangzhou: Chinese mainland. ap-southeast-1: outside the Chinese mainland.	cn-hangzhou

Response parameters

Parameter	Type	Description	Example
	object	The response parameters.
RequestId	string	The request ID.	439AADF2-368C-5E98-B14E-3086****0573
Resource	object	The information about the protected object.
GmtCreate	long	The time when the protected object was created. Unit: milliseconds.	1607493144000
GmtModified	long	The time when the protected object was modified. Unit: milliseconds.	1691720010000
Product	string	The name of the cloud service.	alb
Resource	string	The name of the protected object.	alb-rencs***
ResourceGroup	string	The name of the protected object group to which the protected object belongs.	example_resource_group
Detail	object	The details of the protected object. Different key-value pairs indicate different attributes of the protected object.	{ "product": "waf", "domain": "demo.aliyundoc****.com" }
Pattern	string	The pattern used for the protected object.	domain
XffStatus	integer	Indicates whether a Layer 7 proxy is deployed in front of WAF, such as Anti-DDoS Proxy and Alibaba Cloud CDN. Valid values: 0: No Layer 7 proxy is deployed. 1: A Layer 7 proxy is deployed.	0
CustomHeaders	array	The custom header fields. Note If the value of XffStatus is 1, the first IP address in the specified header field is used as the originating IP address of the client to prevent X-Forwarded-For (XFF) forgery. If you specify multiple header fields, WAF reads the values of the header fields in sequence until the originating IP address is obtained. If the originating IP address cannot be obtained, the first IP address in the XFF header field is used as the originating IP address of the client.
	string	The custom header field.	x-forwarded-for
ResourceOrigin	string	The origin of the protected object. Valid values: custom access	custom
Description	string	The description of the protected object.	This is Description
ResourceManagerResourceGroupId	string	The ID of the Alibaba Cloud resource group.	rg-acfmoiy****p2oq
AcwCookieStatus	integer	The status of the tracking cookie. 0: disabled. 1: enabled.	0
AcwSecureStatus	integer	The status of the secure attribute of the tracking cookie. 0: disabled. 1: enabled.	0
AcwV3SecureStatus	integer	The status of the secure attribute of the slider CAPTCHA cookie. 0: disabled. 1: enabled.	0
OwnerUserId	string	The user ID (UID) of the Alibaba Cloud account to which the protected object belongs.	170457******9107

Examples

Sample success responses

JSONformat

{
  "RequestId": "439AADF2-368C-5E98-B14E-3086****0573",
  "Resource": {
    "GmtCreate": 1607493144000,
    "GmtModified": 1691720010000,
    "Product": "alb",
    "Resource": "alb-rencs***\n",
    "ResourceGroup": "example_resource_group",
    "Detail": {
      "product": "waf",
      "domain": "demo.aliyundoc****.com"
    },
    "Pattern": "domain",
    "XffStatus": 0,
    "CustomHeaders": [
      "x-forwarded-for"
    ],
    "ResourceOrigin": "custom",
    "Description": "This is Description",
    "ResourceManagerResourceGroupId": "rg-acfmoiy****p2oq",
    "AcwCookieStatus": 0,
    "AcwSecureStatus": 0,
    "AcwV3SecureStatus": 0,
    "OwnerUserId": "170457******9107"
  }
}

Error codes

For a list of error codes, visit the Service error codes.