All Products
Search
Document Center

Anti-DDoS:DeleteBlackhole

Last Updated:Aug 27, 2026

Deactivates blackhole filtering for a protected IP address.

Operation description

Call this operation to lift an active blackhole filtering event on a specific IP address protected by an Anti-DDoS Origin instance. Before calling this operation, call DescribePackIpList to confirm whether blackhole filtering is currently active for the target IP address.

Limits

This operation is rate-limited to 10 calls per second per account. Exceeding this limit triggers throttling, which may affect your service.

Debugging

Debug

Run this operation directly in OpenAPI Explorer without calculating signatures. OpenAPI Explorer automatically generates SDK code samples after a successful run.

Authorization information

The following table lists the authorization information for this operation. Use the values in the Operation column in RAM policies to grant a RAM user or RAM role the permissions to call this operation.

  • Operation: The value to use in the Action policy element.

  • Access level: The access level of the operation (read, write, or list).

  • Resource type: The type of resource on which you can grant permissions. Required resource types are shown in bold. If permissions 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 that the RAM user or RAM role must have permission to perform in order to complete this operation.

OperationAccess levelResource typeCondition keyAssociated operation
yundun-antiddosbag:DeleteBlackholedeleteAll Resourcesnonenone

Request parameters

ParameterTypeRequiredDescriptionExample
IpstringYesThe IP address for which to deactivate blackhole filtering. Call DescribePackIpList to query all IP addresses protected by the Anti-DDoS Origin instance and their protection status, including whether blackhole filtering is active.47.89.XX.XX
InstanceIdstringYesThe ID of the Anti-DDoS Origin instance. Call DescribeInstanceList to query all Anti-DDoS Origin instance IDs.ddosbgp-cn-n6w1r7nz****
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. Call DescribeRegions to query the available regions.cn-hangzhou

Response parameters

ParameterTypeDescriptionExample
RequestIdstringThe request ID.C33EB3D5-AF96-43CA-9C7E-37A81BC06A1E

Examples

Sample success responses

JSON format

{
  "RequestId": "C33EB3D5-AF96-43CA-9C7E-37A81BC06A1E"
}

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