All Products
Search
Document Center

Anti-DDoS:API overview

最終更新日:Mar 25, 2026

API standard and pre-built SDKs in multi-language

The OpenAPI specification of this product (antiddos-public/2017-05-18) follows the RPC standard. Alibaba Cloud provides pre-built SDKs for popular programming languages to abstract low-level complexities such as request signing. This enables developers to call APIs using language-specific syntax without dealing with HTTP details directly.

Custom signature

If your specific needs, such as a customized signature, are not supported by the SDK, manually sign requests using the signature mechanism. Note that manual signing requires significant effort (usually about 5 business days). For support, join our DingTalk group (ID: 147535001692).

Before you begin

An Alibaba Cloud account has full administrative privileges. A compromised AccessKey pair exposes all associated resources to unauthorized access, posing a significant security risk. To call APIs securely, create a Resource Access Management (RAM) user with API access only, configure its AccessKey pairs, and implement the principle of least privilege (PoLP) through RAM policies. Use the Alibaba Cloud account only when its permissions are explicitly required for specific scenarios.

Regions

API

Title

Description

DescribeRegions DescribeRegions Queries the regions in which Anti-DDoS Origin Basic is available.

Asset

API

Title

Description

DescribeInstance DescribeInstance Retrieves the details of the assets within the current Alibaba Cloud account. The assets can be elastic IP addresses (EIPs). The assets can also be Elastic Compute Service (ECS) instances or Server Load Balancer (SLB) instances that are assigned public IP addresses. This operation is phased out. We recommend that you use the DescribeInstanceIpAddress operation.
DescribeDdosThreshold DescribeDdosThreshold Retrieves the details of the DDoS mitigation thresholds or traffic scrubbing thresholds for specified assets. The assets can be elastic IP addresses (EIPs). The assets can also be Elastic Compute Service (ECS) instances or Server Load Balancer (SLB) instances that are assigned public IP addresses.
DescribeBgpPackByIp DescribeBgpPackByIp Queries the configurations of the Anti-DDoS Origin instance that is associated with an asset. The asset is assigned a public IP address.
DescribeInstanceIpAddress DescribeInstanceIpAddress Retrieves the details of the assets within the current Alibaba Cloud account and the details of the Anti-DDoS Origin instance to which the assets belong. The assets can be elastic IP addresses (EIPs). The assets can also be Elastic Compute Service (ECS) instances or Server Load Balancer (SLB) instances that are assigned public IP addresses.
DescribeIpDdosThreshold DescribeIpDdosThreshold Retrieves the details of the DDoS mitigation thresholds or traffic scrubbing thresholds for specified assets. The assets can be elastic IP addresses (EIPs). The assets can also be Elastic Compute Service (ECS) instances or Server Load Balancer (SLB) instances that are assigned public IP addresses.
DescribeIpLocationService DescribeIpLocationService Queries the region to which the public IP address of the asset within the current Alibaba Cloud account belongs. The asset can be an elastic IP address (EIP). The asset can also be an Elastic Compute Service (ECS) instance or Server Load Balancer (SLB) instance that is assigned a public IP address.

Protection

API

Title

Description

ModifyIpDefenseThreshold ModifyIpDefenseThreshold Modifies the scrubbing thresholds for an asset that is assigned a public IP address. This operation is a synchronous operation that supports Terraform.
ModifyDefenseThreshold ModifyDefenseThreshold Modifies the Anti-DDoS scrubbing threshold for a single asset with a public IP address.
DescribeDdosEventList DescribeDdosEventList Queries the details of DDoS attack events for an asset with a public IP address.
DescribeDdosCount DescribeDdosCount Queries the number of assets that are under DDoS attacks in a specific region. The assets are assigned public IP addresses.
DescribeCap DescribeCap Queries the download link to the traffic data that is captured when a DDoS attack event occurs.

Others

API

Title

Description

DescribeDdosCredit DescribeDdosCredit Retrieves the details of the security credit score of the current Alibaba Cloud account in a specific region.