全部产品
Search
文档中心

DDoS 防护:DescribeInstanceSpecs - 查询DDoS高防实例的规格信息

更新时间:Mar 03, 2024

查询DDoS高防实例的规格配置。

接口说明

本接口用于批量查询 DDoS 高防实例的规格配置,例如,实例的业务带宽、防护带宽、功能套餐版本、支持防护的域名和端口数量等。

QPS 限制

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

调试

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

授权信息

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

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

请求参数

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

要查询的 DDoS 高防实例的 ID 列表。

string

要查询的 DDoS 高防实例的 ID。

说明 您可以调用 DescribeInstanceIds 查询所有 DDoS 高防实例的 ID。
ddoscoo-cn-zvp2eibz****

调用 API 时,除了本文中该 API 的请求参数,还需加入阿里云 API 公共请求参数。公共请求参数的详细介绍,请参见公共参数

调用 API 的请求格式,请参见本文示例中的请求示例。

返回参数

名称类型描述示例值
object
RequestIdstring

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

4E3A9B5F-5DDB-593D-A1E6-F1F451DB5E0B
InstanceSpecsobject []

DDoS 高防实例的规格配置列表。

BaseBandwidthinteger

基础防护带宽。单位:Gbps。

30
QpsLimitinteger

正常业务 QPS。

3000
BandwidthMbpsinteger

正常业务带宽。单位:Mbps。

100
ElasticBwinteger

弹性业务带宽。单位:Mbps。

300
DefenseCountinteger

本月可用高级防护的次数。-1表示无限次。

说明 只有当请求参数 RegionIdap-southeast-1(表示查询 DDoS 高防非中国内地实例)时,才会返回该参数。
2
SiteLimitinteger

实例可防护站点的数量。

5
PortLimitinteger

实例可防护端口的数量。

50
ElasticBandwidthinteger

弹性防护带宽。单位:Gbps。

30
FunctionVersionstring

实例的功能套餐类型。取值:

  • default:表示标准功能套餐。
  • enhance:表示增强功能套餐。
  • cnhk:表示加速线路。
  • cnhk_default:表示安全加速线路标准功能。
  • cnhk_enhance:表示安全加速线路增强功能。
default
InstanceIdstring

实例 ID。

ddoscoo-cn-zvp2eibz****
DomainLimitinteger

实例可防护域名的数量。

50
ElasticBwModelstring

实例的弹性业务带宽的计费模式。取值:

  • day:表示日 95 计费模式。
  • month:表示月 95 计费模式。
day
CpsLimitlong

实例的新建连接数规格。

5000
ConnLimitlong

实例的并发连接数规格。

100000
RealLimitBwlong

实例业务带宽限速值。取值:0~15360,0 表示不限速。单位:mbps。

0
ElasticQpsModestring

实例的弹性 QPS 的计费模式。取值:

  • day:表示日 95 计费模式。
  • month:表示月 95 计费模式。
day
ElasticQpslong

弹性 QPS。单位:Qps。

10

示例

正常返回示例

JSON格式

{
  "RequestId": "4E3A9B5F-5DDB-593D-A1E6-F1F451DB5E0B",
  "InstanceSpecs": [
    {
      "BaseBandwidth": 30,
      "QpsLimit": 3000,
      "BandwidthMbps": 100,
      "ElasticBw": 300,
      "DefenseCount": 2,
      "SiteLimit": 5,
      "PortLimit": 50,
      "ElasticBandwidth": 30,
      "FunctionVersion": "default",
      "InstanceId": "ddoscoo-cn-zvp2eibz****",
      "DomainLimit": 50,
      "ElasticBwModel": "day",
      "CpsLimit": 5000,
      "ConnLimit": 100000,
      "RealLimitBw": 0,
      "ElasticQpsMode": "day",
      "ElasticQps": 10
    }
  ]
}

错误码

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

变更历史

变更时间变更内容概要操作
2023-05-17OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更
2023-04-04OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更