调用DescribeInstanceSpecs查询指定的DDoS原生防护企业版实例的规格信息。

调试

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

请求参数

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

要执行的操作,取值:DescribeInstanceSpecs

InstanceIdList String ["ddosbgp-cn-n6w1r7nz****"]

要查询的DDoS原生防护企业版实例的ID。使用JSON数组转化的字符串格式表示。JSON数组中的每个元素表示一个实例ID(字符串格式),多个ID间使用英文逗号(,)分隔。

说明 您可以调用DescribeInstanceList查询指定地域下所有DDoS原生防护企业版实例的ID。
RegionId String cn-hangzhou

DDoS原生防护企业版实例的地域ID。默认为cn-hangzhou,表示华东1(杭州)。

说明 如果您的实例不在华东1(杭州)地域,则此处必须填写实例所在地域的ID。您可以调用DescribeRegions查询所有的RegionId
ResourceGroupId String rg-acfm2pz25js****

DDoS原生防护企业版实例在资源管理服务中所属的资源组ID。默认为空,即属于默认资源组。

关于资源组的更多信息,请参见创建资源组

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

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

返回数据

名称 类型 示例值 描述
InstanceSpecs Array of InstanceSpec

DDoS原生防护企业版实例的规格信息,包含全力防护的开启状态、可用和已用的全力防护次数等。

AvailableDefenseTimes Integer 2

当前可用的全力防护次数。

AvailableDeleteBlackholeCount String 100

当前可用的解除黑洞次数。

InstanceId String ddosbgp-cn-n6w1r7nz****

DDoS原生防护企业版实例的ID。

IsFullDefenseMode Integer 1

该实例是否开启了全力防护模式。取值:

  • 0:未开启全力防护模式。
  • 1:开启了全力防护模式。
PackConfig Struct

DDoS原生防护企业版实例的配置信息,包含防护IP数量、防护带宽信息等。

BindIpCount Integer 0

已添加防护的IP数量。

IpAdvanceThre Integer 300

被防护IP的弹性防护阈值。单位:Gbps。

IpBasicThre Integer 20

被防护IP的基础防护阈值。单位:Gbps。

IpSpec Integer 100

可添加的防护IP的数量。

NormalBandwidth Integer 200

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

PackAdvThre Integer 300

原生防护企业版实例的弹性防护带宽。单位:Gbps。

PackBasicThre Integer 20

原生防护企业版实例的基础防护带宽。单位:Gbps。

Region String cn-hangzhou

DDoS原生防护企业版实例的地域ID。

说明 您可以调用DescribeRegions查询地域ID的具体含义。
TotalDefenseTimes Integer 2

总共可用的全力防护次数。

RequestId String 5840AB9F-1419-4620-807D-5EA476090247

本次请求的ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeInstanceSpecs
&InstanceIdList=[\"ddosbgp-cn-n6w1r7nz****\"]
&<公共请求参数>

正常返回示例

XML 格式

<DescribeInstanceSpecsResponse>
	  <RequestId>5840AB9F-1419-4620-807D-5EA476090247</RequestId>
	  <InstanceSpecs>
		    <TotalDefenseTimes>2</TotalDefenseTimes>
		    <IsFullDefenseMode>1</IsFullDefenseMode>
		    <InstanceId>ddosbgp-cn-n6w1r7nz****</InstanceId>
		    <AvailableDefenseTimes>2</AvailableDefenseTimes>
		    <Region>cn-hangzhou</Region>
		    <AvailableDeleteBlackholeCount>100</AvailableDeleteBlackholeCount>
		    <PackConfig>
			      <PackAdvThre>300</PackAdvThre>
			      <IpSpec>100</IpSpec>
			      <NormalBandwidth>200</NormalBandwidth>
			      <BindIpCount>0</BindIpCount>
			      <IpAdvanceThre>300</IpAdvanceThre>
			      <PackBasicThre>20</PackBasicThre>
			      <IpBasicThre>20</IpBasicThre>
		    </PackConfig>
	  </InstanceSpecs>
</DescribeInstanceSpecsResponse>

JSON 格式

{
	"RequestId": "5840AB9F-1419-4620-807D-5EA476090247",
	"InstanceSpecs": [
		{
			"TotalDefenseTimes": 2,
			"IsFullDefenseMode": 1,
			"InstanceId": "ddosbgp-cn-n6w1r7nz****",
			"AvailableDefenseTimes": 2,
			"Region": "cn-hangzhou",
			"AvailableDeleteBlackholeCount": 100,
			"PackConfig": {
				"PackAdvThre": 300,
				"IpSpec": 100,
				"NormalBandwidth": 200,
				"BindIpCount": 0,
				"IpAdvanceThre": 300,
				"PackBasicThre": 20,
				"IpBasicThre": 20
			}
		}
	]
}

错误码

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