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

使用说明

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

QPS限制

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeInstanceSpecs

要执行的操作。取值:DescribeInstanceSpecs

RegionId String cn-hangzhou

DDoS高防实例所属地域ID。取值:

  • cn-hangzhou(默认):表示中国内地,即DDoS高防(新BGP)实例。
  • ap-southeast-1:表示非中国内地,即DDoS高防(国际)实例。
InstanceIds.N String ddoscoo-cn-zvp2eibz****

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

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

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

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

返回数据

名称 类型 示例值 描述
RequestId String 03C4A2E8-F647-5783-995C-AE49B6ACE925

本次请求的ID。

InstanceSpecs Array of InstanceSpec

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

BaseBandwidth Integer 30

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

QpsLimit Integer 3000

正常业务QPS。

BandwidthMbps Integer 100

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

ElasticBw Integer 300

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

DefenseCount Integer 2

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

说明 只有当请求参数RegionIdap-southeast-1(表示查询DDoS高防国际实例)时,才会返回该参数。
SiteLimit Integer 5

实例可防护站点的数量。

PortLimit Integer 50

实例可防护端口的数量。

ElasticBandwidth Integer 30

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

FunctionVersion String default

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

  • default:表示标准功能套餐。
  • enhance:表示增强功能套餐。
  • cnhk:表示加速线路。
  • cnhk_default:表示安全加速线路标准功能。
  • cnhk_enhance:表示安全加速线路增强功能。
InstanceId String ddoscoo-cn-zvp2eibz****

实例ID。

DomainLimit Integer 50

实例可防护域名的数量。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeInstanceSpecs
&InstanceIds=["ddoscoo-cn-zvp2eibz****"]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeInstanceSpecsResponse>
    <RequestId>03C4A2E8-F647-5783-995C-AE49B6ACE925</RequestId>
    <InstanceSpecs>
        <BaseBandwidth>30</BaseBandwidth>
        <QpsLimit>3000</QpsLimit>
        <BandwidthMbps>100</BandwidthMbps>
        <ElasticBw>300</ElasticBw>
        <SiteLimit>5</SiteLimit>
        <PortLimit>50</PortLimit>
        <ElasticBandwidth>30</ElasticBandwidth>
        <FunctionVersion>default</FunctionVersion>
        <InstanceId>ddoscoo-cn-zvp2eibz****</InstanceId>
        <DomainLimit>50</DomainLimit>
    </InstanceSpecs>
</DescribeInstanceSpecsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "03C4A2E8-F647-5783-995C-AE49B6ACE925",
  "InstanceSpecs" : [ {
    "BaseBandwidth" : 30,
    "QpsLimit" : 3000,
    "BandwidthMbps" : 100,
    "ElasticBw" : 300,
    "SiteLimit" : 5,
    "PortLimit" : 50,
    "ElasticBandwidth" : 30,
    "FunctionVersion" : "default",
    "InstanceId" : "ddoscoo-cn-zvp2eibz****",
    "DomainLimit" : 50
  } ]
}

错误码

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