DescribeSiteMonitorISPCityList - : Central de Documentação do Alibaba Cloud

Este tópico apresenta um exemplo de consulta aos pontos de detecção da China Unicom em Guiyang.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeSiteMonitorISPCityList	Operação a ser executada. Defina o valor como DescribeSiteMonitorISPCityList.
Isp	String	Não	China Unicom	Nome ou ID da operadora. Nota Os nomes das operadoras aceitam correspondência aproximada.
City	String	Não	Guiyang	Nome ou ID da cidade. Nota Os nomes das cidades aceitam correspondência aproximada.
IPV6	Boolean	Não	true	Define se a consulta inclui probes IPv6. Valores válidos: true (valor padrão): consulta probes IPv6. false: não consulta probes IPv6.
IPV4	Boolean	Não	true	Define se a consulta inclui probes IPv4. Valores válidos: true (valor padrão): consulta probes IPv4. false: não consulta probes IPv4.
ViewAll	Boolean	Não	true	Define se todos os pontos de detecção devem ser retornados. Valores válidos: true (valor padrão): retorna todos os pontos de detecção. false: retorna apenas os pontos de detecção disponíveis.

Para obter mais informações sobre parâmetros comuns de solicitação, consulte Parâmetros comuns.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Code	String	200	Código de status HTTP. Nota O código de status 200 indica que a chamada foi bem-sucedida.
Message	String	successful	Mensagem retornada.
RequestId	String	B35D7D84-547B-4E61-B909-48A1F8A0C756	ID da solicitação.
Success	String	true	Indica se a chamada foi bem-sucedida. Valores válidos: true: a chamada foi bem-sucedida. false: a chamada falhou.
IspCityList	Array of IspCity		Pontos de detecção.
IspCity
CityName.en	String	Guiyang	Nome da cidade.
IPV4ProbeCount	String	4	Quantidade de probes IPv4.
City	String	4	ID da cidade.
Isp	String	232	ID da operadora.
CityName.zh_CN	String	Guiyang	Nome da cidade. Nota Este parâmetro é retornado apenas no site da China (aliyun.com).
Region.zh_CN	String	Guizhou	Nome da província. Nota Este parâmetro é retornado apenas no site da China (aliyun.com).
IspName.zh_CN	String	China Unicom	Nome da operadora. Nota Este parâmetro é retornado apenas no site da China (aliyun.com).
Country.en	String	China	Nome do país.
IPV6ProbeCount	String	3	Quantidade de probes IPv6.
Region	String	264	Código da província.
Country	String	629	Código do país.
IspName.en	String	China Unicom	Nome da operadora.
Region.en	String	Guizhou	Nome da província.
Country.zh_CN	String	China	Nome do país. Nota Este parâmetro é retornado apenas no site da China (aliyun.com).
Area.zh_CN	String	Southwest China	Nome da área. Nota Este parâmetro é retornado apenas no site da China (aliyun.com).
Area.en	String	XiNan	Nome da área.
IPPool	Array of String	["192,68.XX.XX","192,68.XX.XX"]	Pool de endereços IP.

Exemplos

Solicitações de exemplo

http(s)://[Endpoint]/?Action=DescribeSiteMonitorISPCityList
&Isp=China Unicom
&City=Guiyang
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<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>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

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

Códigos de erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.