首页 DDoS 防护 DDoS原生防护 API参考 DDoS基础防护 API目录 资产 DescribeIpDdosThreshold - 查询指定公网IP资产的DDoS防护阈值或流量清洗阈值详情

DescribeIpDdosThreshold - 查询指定公网IP资产的DDoS防护阈值或流量清洗阈值详情

查询当前阿里云账号下指定公网IP资产(云服务器ECS实例、负载均衡SLB实例、弹性公网IP实例)的DDoS防护阈值或流量清洗阈值详情。

接口说明

在一个DDoS原生防护实例包含一个或者多个公网IP资产的场景下,您可以调用DescribeIpDdosThreshold接口查询指定公网IP资产的DDoS防护阈值或流量清洗阈值详情,例如当前清洗阈值、最大清洗阈值、当前防护阈值、最大防护阈值等。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制,API调用将会被限流,这可能影响您的业务,请合理调用。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
DdosRegionIdstring

要查询的公网IP资产所在地域ID。

说明您可以调用DescribeRegions查询所有地域ID。
cn-hangzhou
DdosTypestring

要查询的阈值类型。取值:

  • defense:表示查询流量清洗阈值。
  • blackhole:表示查询DDoS防护阈值。
defense
InstanceTypestring

要查询的公网IP资产的实例类型。取值:

  • ecs:表示查询云服务器ECS实例。
  • slb:表示查询负载均衡SLB实例。
  • eip:表示查询弹性公网IP实例。
ecs
InstanceIdstring

要查询的公网IP资产的实例ID。

说明您可以调用DescribeInstanceIpAddress查询当前阿里云账号拥有的ECS、SLB、EIP实例的ID。
i-bp1i88rqjza51s****
InternetIpstring

要查询的公网IP资产的IP地址。

192.0.XX.XX

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

025F1688-680B-551A-9A8E-1A0D796315CF
Thresholdobject

公网IP资产的阈值详情列表。

DdosTypestring

阈值类型。取值:

  • defense:表示流量清洗阈值。
  • blackhole:表示DDoS防护阈值。
defense
IsAutoboolean

是否为系统默认阈值。取值:

  • true:表示是,即由DDoS防护服务根据云服务器的流量负载,动态调整清洗阈值。
  • false:表示否,即由您手动设置清洗阈值。
false
MaxBpsinteger

最大流量清洗阈值。单位:Mbps。

7500
ElasticBpsinteger

DDoS弹性防护阈值(即DDoS最大防护阈值)。单位:Mbps。

说明只有当DdosTypeblackhole(表示查询DDoS防护阈值)时,才会返回该参数。
12310
InstanceIdstring

实例ID。

i-bp1i88rqjza51s****
Bpsinteger

DdosTypedefense(表示查询流量清洗阈值)时,表示当前流量清洗阈值。单位:Mbps。

DdosTypeblackhole(表示查询DDoS防护阈值)时,表示当前DDoS基础防护阈值。单位:Mbps。

7500
Ppsinteger

当前报文数量清洗阈值。单位:pps。

说明只有当DdosTypedefense(表示查询流量清洗阈值)时,才会返回该参数。
5000000
MaxPpsinteger

最大报文数量清洗阈值。单位:pps。

5000000
InternetIpstring

公网IP资产的IP地址。

192.0.XX.XX

示例

正常返回示例

JSON格式

{
  "RequestId": "025F1688-680B-551A-9A8E-1A0D796315CF",
  "Threshold": {
    "DdosType": "defense",
    "IsAuto": false,
    "MaxBps": 7500,
    "ElasticBps": 12310,
    "InstanceId": "i-bp1i88rqjza51s****",
    "Bps": 7500,
    "Pps": 5000000,
    "MaxPps": 5000000,
    "InternetIp": "192.0.XX.XX"
  }
}

错误码

访问错误中心查看更多错误码。

阿里云首页 DDoS防护 相关技术圈