全部产品
Search

搜索本产品

    云监控：DescribeSiteMonitorISPCityList - 查询所有运营商探测点详情

    文档中心

    云监控：DescribeSiteMonitorISPCityList - 查询所有运营商探测点详情

    更新时间：Jul 26, 2024

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

    接口说明

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

    调试

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

    授权信息

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

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

    请求参数

    名称类型必填描述示例值
    Ispstring否

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

    说明 运营商名称支持模糊查询。
    		联通
    Citystring否

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

    说明 城市名称支持模糊查询。
    		贵阳市
    IPV6boolean否

    是否查询 IPv6 探针。取值：

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

    是否查询 IPv4 探针。取值：

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

    是否返回所有探测点。取值：

    • true（默认值）：返回所有探测点。
    • false：只返回可用探测点。
    		true

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

    返回参数

    名称类型描述示例值
    object
    Codestring

    状态码。

    说明 200 表示成功。
    		200
    Messagestring

    返回信息。

    		successful
    RequestIdstring

    请求 ID。

    		B35D7D84-547B-4E61-B909-48A1F8A0C756
    Successstring

    操作是否成功。取值：

    • true：成功。

    • false：失败。

    		true
    IspCityListarray<object>

    探测点列表。

    object

    探测点列表。

    CityName.enstring

    城市名称（英文）。

    		Guiyang
    IPV4ProbeCountstring

    IPv4 探针数量。

    		4
    Citystring

    城市 ID。

    		4
    Ispstring

    运营商 ID。

    		232
    CityName.zh_CNstring

    城市名称（简体中文）。

    说明 该参数仅适用于中国站。
    		贵阳市
    Region.zh_CNstring

    省份（简体中文）。

    说明 该参数仅适用于中国站。
    		贵州省
    IspName.zh_CNstring

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

    说明 该参数仅适用于中国站。
    		联通
    Country.enstring

    国家（英文）。

    		China
    IPV6ProbeCountstring

    IPv6 探针数量。

    		3
    Regionstring

    省份代码。

    		264
    Countrystring

    国家代码。

    		629
    IspName.enstring

    运营商名称（英文）。

    		China-Unicom
    Region.enstring

    省份（英文）。

    		Guizhou
    Country.zh_CNstring

    国家（简体中文）。

    说明 该参数仅适用于中国站。
    		中国
    Area.zh_CNstring

    区域（简体中文）。

    说明 该参数仅适用于中国站。
    		西南
    Area.enstring

    区域（汉语拼音）。

    		XiNan
    IPPoolarray

    IP 地址池。

    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错误码错误信息描述
    400InvalidQueryParameter%s-
    401AccessDeniedExceptionYou donot have sufficient access to perform this action.-
    402LimitExceededThe quota for this customer had been reached.-
    403ForbiddenYou are not authorized to operate the specified resource.没有权限，请使用RAM进行授权
    406ExceedingQuotaExceeding quota limits.-
    409%s%s-
    429ThrottlingExceptionThe request was denied due to request throttling.-
    500InternalError%s-

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

    变更历史

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