All Products
Search
Document Center

Anti-DDoS:DescribeExcpetionCount

Last Updated:Aug 28, 2026

Queries the number of assets in an abnormal state and the number of Anti-DDoS Origin instances that are about to expire. Assets include elastic IP addresses (EIPs), Elastic Compute Service (ECS) instances with public IP addresses, and Server Load Balancer (SLB) instances with public IP addresses.

Usage notes

Use this operation to query, for a specific region, the number of assets in an abnormal state and the number of Anti-DDoS Origin instances that are about to expire. An asset is in an abnormal state when blackhole filtering is triggered for its IP address. An Anti-DDoS Origin instance is considered about to expire when its remaining validity period is less than seven days.

Debugging

Debug

Run this operation in OpenAPI Explorer to skip manual signature calculation. OpenAPI Explorer also generates SDK code samples after a successful call.

Authorization information

The following table lists the authorization details for this operation. Use the Action policy element to grant a RAM user or RAM role permission to call this operation.

  • Operation: the value to use in the Action element to specify the operation on a resource.

  • Access level: the access level of the operation. Levels are read, write, and list.

  • Resource type: the type of resource on which you can grant the RAM user or RAM role permission. Required resource types are displayed in bold. If the operation cannot be granted at the resource level, the Resource type column shows All Resources.

  • Condition key: the condition key defined by the cloud service.

  • Associated operation: other operations the RAM user or RAM role must have permission to perform in order to complete this operation.

OperationAccess levelResource typeCondition keyAssociated operation
yundun-antiddosbag:DescribeExcpetionCountgetAll Resources *nonenone

Request parameters

ParameterTypeRequiredDescriptionExample
ResourceGroupIdstringNoThe ID of the resource group to which the Anti-DDoS Origin instance belongs in Resource Management. If not specified, the instance belongs to the default resource group.rg-acfm2pz25js****
RegionIdstringNoThe region of the Anti-DDoS Origin instance. To get the region ID, call the DescribeRegions operation.cn-hangzhou

For common request parameters, see Common parameters.

Response parameters

ParameterTypeDescriptionExample
(root)object
ExceptionIpCountintegerThe number of assets in an abnormal state.0
ExpireTimeCountintegerThe number of Anti-DDoS Origin instances that are about to expire.1
RequestIdstringThe request ID.4B45279A-B1BE-5EEE-87CA-58AF4183EA58

Examples

Sample success responses

JSON format

{
  "ExceptionIpCount": 0,
  "ExpireTimeCount": 1,
  "RequestId": "4B45279A-B1BE-5EEE-87CA-58AF4183EA58"
}

Error codes

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

Change history

Change timeSummary of changesOperation
2024-12-11API description updateView change details