Queries the detection points that can be used to create site monitoring tasks. These detection points belong to a carrier.
This topic provides an example on how to query the detection points that belong to the carrier China Unicom and the city is Guiyang.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DescribeSiteMonitorISPCityList |
The operation that you want to perform. Set the value to DescribeSiteMonitorISPCityList. |
Isp | String | No | China Unicom |
The name or ID of the carrier. Note Carrier names support fuzzy match.
|
City | String | No | Guiyang |
The name or ID of the city. Note City names support fuzzy match.
|
IPV6 | Boolean | No | true |
Specifies whether to query IPv6 probes. Valid values:
|
IPV4 | Boolean | No | true |
Specifies whether to query IPv4 probes. Valid values:
|
For more information about common request parameters, see Common parameters.
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
Code | String | 200 |
The HTTP status code. Note The status code 200 indicates that the call was successful.
|
RequestId | String | B35D7D84-547B-4E61-B909-48A1F8A0C756 |
The ID of the request. |
Message | String | successful |
The returned message. |
IspCityList | Array of IspCity |
The detection points. |
|
IspCity | |||
Area.en | String | XiNan |
The area. |
Area.zh_CN | String | Southwest China |
The area. Note This parameter can be returned only on the China site (aliyun.com).
|
City | String | 4 |
The ID of the city. |
CityName.en | String | Guiyang |
The name of the city. |
CityName.zh_CN | String | Guiyang |
The name of the city. Note This parameter can be returned only on the China site (aliyun.com).
|
Country | String | 629 |
The code of the country. |
Country.en | String | China |
The name of the country. |
Country.zh_CN | String | China |
The name of the country. Note This parameter can be returned only on the China site (aliyun.com).
|
IPPool | List | ["192.68.XX.XX","192.68.XX.XX"] |
The IP address pool. |
IPV4ProbeCount | String | 4 |
The number of IPv4 probes. |
IPV6ProbeCount | String | 3 |
The number of IPv6 probes. |
Isp | String | 232 |
The ID of the carrier. |
IspName.en | String | China-Unicom |
The name of the carrier. |
IspName.zh_CN | String | China Unicom |
The name of the carrier. Note This parameter can be returned only on the China site (aliyun.com).
|
Region | String | 264 |
The code of the province. |
Region.en | String | Guizhou |
The name of the province. |
Region.zh_CN | String | Guizhou |
The name of the province. Note This parameter can be returned only on the China site (aliyun.com).
|
Success | String | true |
Indicates whether the call was successful. Valid values:
|
Examples
Sample requests
http(s)://[Endpoint]/?Action=DescribeSiteMonitorISPCityList
&Isp= China Unicom
&City= Guiyang
&<Common request parameters>
Sample success responses
XML
format
<DescribeSiteMonitorISPCityListResponse>
<Message>successful</Message>
<RequestId>B35D7D84-547B-4E61-B909-48A1F8A0C756</RequestId>
<Code>200</Code>
<Success>true</Success>
<IspCityList>
<IspCity>
<Country.zh_CN>China</Country.zh_CN>
<Area.zh_CN>Southwest China</Area.zh_CN>
<CityName.en>Guiyang</CityName.en>
<IPV4ProbeCount>4</IPV4ProbeCount>
<Isp>232</Isp>
<City>4</City>
<IspName.en>China-Unicom</IspName.en>
<Country.en>China</Country.en>
<IPV6ProbeCount>0</IPV6ProbeCount>
<CityName.zh_CN>Guiyang</CityName.zh_CN>
<Area.en>XiNan</Area.en>
<Region.zh_CN>Guizhou</Region.zh_CN>
<APIProbeCount>0</APIProbeCount>
<Region>264</Region>
<Country>629</Country>
<IspName.zh_CN>China Unicom</IspName.zh_CN>
<Region.en>Guizhou</Region.en>
<IPPool>
<IPPool>192.168.XX.XX</IPPool>
<IPPool>192.168.XX.XX</IPPool>
</IPPool>
</IspCity>
</IspCityList>
</DescribeSiteMonitorISPCityListResponse>
JSON
format
{
"Message": "successful",
"RequestId": "B35D7D84-547B-4E61-B909-48A1F8A0C756",
"Code": "200",
"Success": true,
"IspCityList": {
"IspCity": [
{
"Country.zh_CN": "China",
"Area.zh_CN": "Southwest China",
"CityName.en": "Guiyang",
"IPV4ProbeCount": 4,
"Isp": "232",
"City": "4",
"IspName.en": "China-Unicom",
"Country.en": "China",
"IPV6ProbeCount": 0,
"CityName.zh_CN": "Guiyang",
"Area.en": "XiNan",
"Region.zh_CN": "Guizhou",
"APIProbeCount": 0,
"Region": "264",
"Country": "629",
"IspName.zh_CN": "China Unicom",
"Region.en": "Guizhou",
"IPPool": {
"IPPool": [
"192.168.XX.XX",
"192.168.XX.XX"
]
}
}
]
}
}
Error codes
For a list of error codes, visit the API Error Center.