调用DescribeSiteMonitorISPCityList接口查询所有运营商探测点详情。

本文将提供一个示例，查询运营商“联通”在“贵阳市”的探测点详情。

调试

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

请求参数

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

要执行的操作，取值：DescribeSiteMonitorISPCityList。
Isp String 否 联通

运营商探测点的名称或ID。

说明 运营商名称支持模糊查询。
City String 否 贵阳市

运营商探测点所在城市的名称或ID。

说明 城市名称支持模糊查询。
IPV6 Boolean 否 true

是否查询IPv6探针。取值：

  • true（默认值）：查询IPv6探针。
  • false：不查询IPv6探针。
IPV4 Boolean 否 true

是否查询IPv4探针。取值：

  • true（默认值）：查询IPv4探针。
  • false：不查询IPv4探针。

关于公共请求参数的详情，请参见公共参数。

返回数据

名称 类型 示例值 描述
Code String 200

状态码。

说明 200表示成功。
RequestId String B35D7D84-547B-4E61-B909-48A1F8A0C756

请求ID。
Message String successful

返回信息。
IspCityList Array of IspCity

探测点列表。
IspCity
Area.en String XiNan

区域（汉语拼音）。
Area.zh_CN String 西南

区域（简体中文）。

说明 该参数仅适用于中国站。
City String 4

城市ID。
CityName.en String Guiyang

城市名称（英文）。
CityName.zh_CN String 贵阳市

城市名称（简体中文）。

说明 该参数仅适用于中国站。
Country String 629

国家代码。
Country.en String China

国家（英文）。
Country.zh_CN String 中国

国家（简体中文）。

说明 该参数仅适用于中国站。
IPPool List ["192.68.XX.XX","192.68.XX.XX"]

IP地址池。
IPV4ProbeCount String 4

IPv4探针数量。
IPV6ProbeCount String 3

IPv6探针数量。
Isp String 232

运营商ID。
IspName.en String China-Unicom

运营商名称（英文）。
IspName.zh_CN String 联通

运营商名称（简体中文）。

说明 该参数仅适用于中国站。
Region String 264

省份代码。
Region.en String Guizhou

省份（英文）。
Region.zh_CN String 贵州省

省份（简体中文）。

说明 该参数仅适用于中国站。
Success String true

操作是否成功。取值：

  • true：成功。
  • false：失败。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeSiteMonitorISPCityList
&Isp=联通
&City=贵阳市
&<公共请求参数>

正常返回示例

XML格式 

<DescribeSiteMonitorISPCityListResponse>
	  <Message>successful</Message>
	  <RequestId>B35D7D84-547B-4E61-B909-48A1F8A0C756</RequestId>
	  <Code>200</Code>
	  <Success>true</Success>
	  <IspCityList>
		    <IspCity>
			      <Country.zh_CN>中国</Country.zh_CN>
			      <Area.zh_CN>西南</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>贵阳市</CityName.zh_CN>
			      <Area.en>XiNan</Area.en>
			      <Region.zh_CN>贵州省</Region.zh_CN>
			      <APIProbeCount>0</APIProbeCount>
			      <Region>264</Region>
			      <Country>629</Country>
			      <IspName.zh_CN>联通</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格式 

{
    "Message": "successful",
    "RequestId": "B35D7D84-547B-4E61-B909-48A1F8A0C756",
    "Code": "200",
    "Success": true,
    "IspCityList": {
        "IspCity": [
            {
                "Country.zh_CN": "中国",
                "Area.zh_CN": "西南",
                "CityName.en": "Guiyang",
                "IPV4ProbeCount": 4,
                "Isp": "232",
                "City": "4",
                "IspName.en": "China-Unicom",
                "Country.en": "China",
                "IPV6ProbeCount": 0,
                "CityName.zh_CN": "贵阳市",
                "Area.en": "XiNan",
                "Region.zh_CN": "贵州省",
                "APIProbeCount": 0,
                "Region": "264",
                "Country": "629",
                "IspName.zh_CN": "联通",
                "Region.en": "Guizhou",
                "IPPool": {
                    "IPPool": [
                        "192.168.XX.XX",
                        "192.168.XX.XX"
                    ]
                }
            }
        ]
    }
}

错误码

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