调用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"
}

错误码

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