DescribeSiteMonitorISPCityList - Cloud Monitor - Centro de documentación de Alibaba Cloud

Consulta los detalles de todos los puntos de detección de operadores mediante la operación DescribeSiteMonitorISPCityList.

Descripción de la operación

Este artículo proporciona un ejemplo para consultar los detalles de los puntos de detección del operador "China Unicom" en la ciudad de "Guiyang".

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

cms:DescribeSiteMonitorISPCityList

get

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Isp	string	No	El nombre o ID del punto de detección del operador. Nota Se admite la coincidencia aproximada para los nombres de operadores.	China Unicom
City	string	No	El nombre o ID de la ciudad donde reside el punto de detección del operador. Nota Se admite la coincidencia aproximada para los nombres de ciudades.	Guiyang
IPV6	boolean	No	Especifica si se deben consultar las sondas IPv6. Valores válidos: true (predeterminado): Consulta las sondas IPv6. false: No consulta las sondas IPv6.	true
IPV4	boolean	No	Especifica si se deben consultar las sondas IPv4. Valores válidos: true (predeterminado): Consulta las sondas IPv4. false: No consulta las sondas IPv4.	true
ViewAll	boolean	No	Especifica si se deben devolver todos los puntos de detección. Valores válidos: true (predeterminado): Devuelve todos los puntos de detección. false: Devuelve solo los puntos de detección disponibles.	true

Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
Code	string	El código de estado. Nota 200 indica éxito.	200
Message	string	El mensaje de respuesta.	successful
RequestId	string	El ID de la solicitud.	B35D7D84-547B-4E61-B909-48A1F8A0C756
Success	string	Indica si la operación se realizó correctamente. Valores válidos: true: La operación se realizó correctamente. false: La operación falló.	true
IspCityList	object
IspCity	array<object>	La lista de puntos de detección.
	array<object>	La lista de puntos de detección.
CityName.en	string	El nombre de la ciudad (en inglés).	Guiyang
IPV4ProbeCount	string	El número de sondas IPv4.	4
City	string	El ID de la ciudad.	4
Isp	string	运营商 ID。	232
CityName.zh_CN	string	El nombre de la ciudad (en chino simplificado). Nota Este parámetro solo aplica al sitio de China.	贵阳市
Region.zh_CN	string	La provincia (en chino simplificado). Nota Este parámetro solo aplica al sitio de China.	贵州省
IspName.zh_CN	string	El nombre del operador (en chino simplificado). Nota Este parámetro solo aplica al sitio de China.	联通
Country.en	string	El país (en inglés).	China
IPV6ProbeCount	string	El número de sondas IPv6.	3
Region	string	El código de la provincia.	264
Country	string	El código del país.	629
IspName.en	string	El nombre del operador (en inglés).	China-Unicom
Region.en	string	La provincia (en inglés).	Guizhou
Country.zh_CN	string	El país (en chino simplificado). Nota Este parámetro solo aplica al sitio de China.	中国
Area.zh_CN	string	La región (en chino simplificado). Nota Este parámetro solo aplica al sitio de China.	西南
Area.en	string	La región (en pinyin).	XiNan
IPPool	object
IPPool	array	El pool de direcciones IP.
	string	El pool de direcciones IP.	["192.68.XX.XX","192.68.XX.XX"]

Ejemplos

Respuesta exitosa

JSON Formato

{
  "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\"]"
          ]
        }
      }
    ]
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidQueryParameter	%s
401	AccessDeniedException	You donot have sufficient access to perform this action.
500	InternalError	%s
402	LimitExceeded	The quota for this customer had been reached.
403	Forbidden	You are not authorized to operate the specified resource.	No permission, please use RAM to authorize
503	%s	%s
406	ExceedingQuota	Exceeding quota limits.	The number of tasks exceeds the limit
429	ThrottlingException	The request was denied due to request throttling.
409	%s	%s

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.