使用DescribeSiteMonitorISPCityList查询所有运营商探测点详情-云监控-阿里云-云监控(CMS)-阿里云帮助中心

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

接口说明

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

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
cms:DescribeSiteMonitorISPCityList	get	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
Isp	string	否	运营商探测点的名称或 ID。说明运营商名称支持模糊查询。	联通
City	string	否	运营商探测点所在城市的名称或 ID。说明城市名称支持模糊查询。	贵阳市
IPV6	boolean	否	是否查询 IPv6 探针。取值： true（默认值）：查询 IPv6 探针。 false：不查询 IPv6 探针。	true
IPV4	boolean	否	是否查询 IPv4 探针。取值： true（默认值）：查询 IPv4 探针。 false：不查询 IPv4 探针。	true
ViewAll	boolean	否	是否返回所有探测点。取值： true（默认值）：返回所有探测点。 false：只返回可用探测点。	true

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

返回参数

名称	类型	描述	示例值
	object
Code	string	状态码。说明 200 表示成功。	200
Message	string	返回信息。	successful
RequestId	string	请求 ID。	B35D7D84-547B-4E61-B909-48A1F8A0C756
Success	string	操作是否成功。取值： true：成功。 false：失败。	true
IspCityList	array<object>	探测点列表。
IspCity	object	探测点列表。
CityName.en	string	城市名称（英文）。	Guiyang
IPV4ProbeCount	string	IPv4 探针数量。	4
City	string	城市 ID。	4
Isp	string	运营商 ID。	232
CityName.zh_CN	string	城市名称（简体中文）。说明该参数仅适用于中国站。	贵阳市
Region.zh_CN	string	省份（简体中文）。说明该参数仅适用于中国站。	贵州省
IspName.zh_CN	string	运营商名称（简体中文）。说明该参数仅适用于中国站。	联通
Country.en	string	国家（英文）。	China
IPV6ProbeCount	string	IPv6 探针数量。	3
Region	string	省份代码。	264
Country	string	国家代码。	629
IspName.en	string	运营商名称（英文）。	China-Unicom
Region.en	string	省份（英文）。	Guizhou
Country.zh_CN	string	国家（简体中文）。说明该参数仅适用于中国站。	中国
Area.zh_CN	string	区域（简体中文）。说明该参数仅适用于中国站。	西南
Area.en	string	区域（汉语拼音）。	XiNan
IPPool	array	IP 地址池。
IPPool	string	IP 地址池。	["192.68.XX.XX","192.68.XX.XX"]

示例

正常返回示例

JSON格式

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

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidQueryParameter	%s	-
401	AccessDeniedException	You donot have sufficient access to perform this action.	-
402	LimitExceeded	The quota for this customer had been reached.	-
403	Forbidden	You are not authorized to operate the specified resource.	没有权限，请使用RAM进行授权
406	ExceedingQuota	Exceeding quota limits.	任务数量超出限额
409	%s	%s	-
429	ThrottlingException	The request was denied due to request throttling.	-
500	InternalError	%s	-

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

变更历史

变更时间	变更内容概要	操作
2023-04-03	OpenAPI 错误码发生变更	查看变更详情