首页 DDoS防护 DDoS基础防护 开发参考 DDoS基础防护(2017-05-18) API目录 资产 DescribeIpDdosThreshold - 查询指定公网IP资产的DDoS防护阈值或流量清洗阈值详情

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

更新时间: 2024-11-13 17:15:35

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

接口说明

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

QPS 限制

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

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
yundun-ddos:DescribeIpDdosThresholdget
  • 全部资源
    *

请求参数

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

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

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

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

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

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

  • ecs:表示查询云服务器 ECS 实例。
  • slb:表示查询负载均衡 SLB 实例。
  • eip:表示查询弹性公网 IP 实例。
  • ipv6:表示查询 IPv6 网关公网实例。
  • swas:表示查询轻量服务器公网实例。
  • waf:表示查询 Web 应用防火墙独享实例。
  • ga_basic:表示查询全球加速公网实例。
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"
  }
}

错误码

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

变更历史

变更时间变更内容概要操作
暂无变更历史
上一篇: DescribeInstanceIpAddress - 查询公网IP资产的DDoS防护信息以及所属原生防护实例的详情 下一篇: DescribeIpLocationService - 查询公网IP资产的IP归属地域
阿里云首页 DDoS防护 相关技术圈