调用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数组中的每个结构体包含以下参数:
|
Desc | String | test |
代播实例的描述。 说明 该参数仅在返回多个代播实例时才会返回。目前仅返回一个代播实例,该参数不会返回。
|
InstanceId | String | ddosbgp-cn-z2q1qzxb**** |
代播实例的ID。 说明 该参数仅在返回多个代播实例时才会返回。目前仅返回一个代播实例,该参数不会返回。
|
Mode | String | netflow-auto |
代播防护的启动模式。取值:
|
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代码 |
---|---|
美国(硅谷) |
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"
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交