调用DescribeOnDemandInstanceStatus查询代播实例的详细信息。

调试

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

请求参数

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

要执行的操作。取值:DescribeOnDemandInstanceStatus

InstanceIdList.N RepeatList ddosbgp-cn-z2q1qzxb****

要查询的代播实例的ID列表。

说明 您可以调用 DescribeOnDemandInstance查询所有代播实例的ID。
RegionId String cn-zhangjiakou

代播实例的地域ID。

说明 您可以调用 DescribeRegions查询DDoS原生防护支持的所有地域信息。

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

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

返回数据

名称 类型 示例值 描述
Instances Array of instance

代播实例的详细信息。

Declared String [{\"region\":\"oe24\",\"declared\":0},{\"region\":\"oe26\",\"declared\":0},{\"region\":\"oe28\",\"declared\":0},{\"region\":\"oi39\",\"declared\":0},{\"region\":\"us50\",\"declared\":0},{\"region\":\"jp141\",\"declared\":0}]

海外IDC的路由宣告状态信息。以JSON数组格式转化成字符串表示,JSON数组中的每个结构体包含以下参数:

  • region:String类型 | 海外IDC代码。关于IDC代码对应的地域信息,请参见该表格下方的海外IDC代码说明。
  • declared:String类型 | 该IDC是否宣告路由,取值:0(表示未宣告) | 1(表示宣告)。
Desc String test

代播实例的描述。

说明 该参数仅在返回多个代播实例时才会返回。目前仅返回一个代播实例,该参数不会返回。
InstanceId String ddosbgp-cn-z2q1qzxb****

代播实例的ID。

说明 该参数仅在返回多个代播实例时才会返回。目前仅返回一个代播实例,该参数不会返回。
Mode String netflow-auto

代播防护的启动模式。取值:

  • manual:表示手动启动。
  • netflow-auto:表示通过NetFlow网络流量监测自动启动。
Net String 47.***.***.0/24

代播网段。

RegistedAs String 0

自治系统AS(Autonomous System)号码。目前取值固定为0,表示暂未启用。

UserId String 171986973287****

阿里云账号ID。

RequestId String CC49FF51-612F-429B-AB1E-374B3F115396

本次请求的ID。

海外IDC代码

下表描述了不同海外地域部署的代播防护IDC的代码。

地域

IDC代码

美国(硅谷)

oe24、oe25、oc27、ot7

美国(弗吉尼亚)

us44-a、us44-b、us68、us50、us51

中国(香港)

meg、oe26、hk45、hk71

新加坡

oe28、og37、os30、sg94、sg52、sg113

澳大利亚(悉尼)

au49、au67、au57、au58

德国(法兰克福)

de46、de81、oe38、oi39

俄罗斯(莫斯科)

ol31、ru85、ru66

英国(伦敦)

gb82、gb83、gb33、gb124

印度(孟买)

in74、in75、in73、in123

日本(东京)

jp59、jp42、jp43、jp138、jp141

马来西亚(吉隆坡)

my86、my87、my88、my115

印度尼西亚(雅加达)

id56、id55、id35、id90

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeOnDemandInstanceStatus
&InstanceIdList.1=ddosbgp-cn-z2q1qzxb****
&<公共请求参数>

正常返回示例

XML 格式

<DescribeOnDemandInstanceStatusResponse>
	  <Instances>
		    <UserId>171986973287****</UserId>
		    <Mode>netflow-auto</Mode>
		    <RegistedAs>0</RegistedAs>
		    <Net>47.***.***.0/24</Net>
		    <Declared>[{\"region\":\"oe24\",\"declared\":0},{\"region\":\"oe26\",\"declared\":0},{\"region\":\"oe28\",\"declared\":0},{\"region\":\"oi39\",\"declared\":0},{\"region\":\"us50\",\"declared\":0},{\"region\":\"jp141\",\"declared\":0}]</Declared>
	  </Instances>
	  <RequestId>CC49FF51-612F-429B-AB1E-374B3F115396</RequestId>
  </DescribeOnDemandInstanceStatusResponse>

JSON 格式

{
	"Instances": [
		{
			"UserId": "171986973287****",
			"Mode": "netflow-auto",
			"RegistedAs": "0",
			"Net": "47.***.***.0/24",
			"Declared": "[{\"region\":\"oe24\",\"declared\":0},{\"region\":\"oe26\",\"declared\":0},{\"region\":\"oe28\",\"declared\":0},{\"region\":\"oi39\",\"declared\":0},{\"region\":\"us50\",\"declared\":0},{\"region\":\"jp141\",\"declared\":0}]"
		}
	],
	"RequestId": "CC49FF51-612F-429B-AB1E-374B3F115396"
}

错误码

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