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

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeRegions	A operação a ser executada. Defina o valor como DescribeRegions.
InstanceChargeType	String	Não	PrePaid	O método de faturamento da instância. Para mais informações, consulte Visão geral do faturamento. Valores válidos: PrePaid: assinatura. Se definir este parâmetro como PrePaid, verifique se há saldo ou créditos suficientes na conta. Caso contrário, o sistema retorna o código de erro InvalidPayMethod. PostPaid: pagamento conforme o uso. Valor padrão: PostPaid.
ResourceType	String	Não	instance	O tipo de recurso. Valores válidos: instance: instância do Elastic Compute Service (ECS). disk: disco reservedinstance: instância reservada scu: unidade de capacidade de armazenamento (SCU) Valor padrão: instance.
AcceptLanguage	String	Não	zh-CN	O idioma natural usado para filtrar respostas. Para mais informações, consulte RFC 7231. Valores válidos: zh-CN: chinês en-US: inglês ja: japonês Valor padrão: zh-CN.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.
Regions	Array of Region		Detalhes sobre as regiões.
Region
Status	String	available	Indica se os clusters estão esgotados. Valores válidos: available soldOut
RegionEndpoint	String	ecs.aliyuncs.com	O endpoint da região.
LocalName	String	China (Qingdao)	O nome da região.
RegionId	String	cn-qingdao-et2-bo1	O ID da região.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DescribeRegions
&RegionId=cn-qingdao
&InstanceChargeType=PrePaid
&ResourceType=Instance
&AcceptLanguage=en-US
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<DescribeRegionsResponse>
    <RequestId>38EC7366-F5A9-46B1-BDB1-0FDC2E296397</RequestId>
    <Regions>
        <Region>
            <RegionId>cn-qingdao-et2-b01</RegionId>
            <RegionEndpoint>ecs.aliyuncs.com</RegionEndpoint>
            <LocalName>China (Qingdao)</LocalName>
        </Region>
        <Region>
            <RegionId>cn-qingdao-nebula</RegionId>
            <RegionEndpoint>ecs.cn-qingdao-nebula.aliyuncs.com</RegionEndpoint>
            <LocalName>cn-qingdao-nebula</LocalName>
        </Region>
    </Regions>
</DescribeRegionsResponse>

Formato JSON

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

{
  "RequestId" : "38EC7366-F5A9-46B1-BDB1-0FDC2E296397",
  "Regions" : {
    "Region" : [ {
      "RegionId" : "cn-qingdao-et2-b01",
      "RegionEndpoint" : "ecs.aliyuncs.com",
      "LocalName" : "China (Qingdao)"
    }, {
      "RegionId" : "cn-qingdao-nebula",
      "RegionEndpoint" : "ecs.cn-qingdao-nebula.aliyuncs.com",
      "LocalName" : "cn-qingdao-nebula"
    } ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
403	Unauthorized.EmptyRegion	The specified account has no access authority to any region.	Você não tem permissão para acessar regiões. Solicite as permissões necessárias e tente novamente.
404	InvalidAcceptLanguage.NotFound	Only Chinese (zh-CN), English (en-US), and Japanese (ja) are allowed.	O idioma selecionado não é compatível. Apenas chinês, inglês e japonês são compatíveis.
404	InvalidResourceType.NotFound	The ResourceType provided does not exist in our records.	O tipo de recurso especificado não foi encontrado.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.