Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda> Identity and Access Management> Referência de API> API> Gerenciamento de regiões> Consulta de detalhes da região

Atualizado em 2023-02-16 GMT+08:00

Ver PDF

Consulta de detalhes da região

Função

Essa API é usada para consultar detalhes da região.

A API pode ser chamada usando o ponto de extremidade global e pontos de extremidade específicos da região. Para pontos de extremidade do IAM, consulte Regiões e pontos de extremidade.

URI

GET /v3/regions/{region_id}

**Tabela 1** Parâmetros de URI
Parâmetro	Obrigatoriedade	Tipo	Descrição
region_id	Sim	String	ID da região a ser consultada. Você pode obter um ID de região usando a API descrita em Consulta de regiões ou usando o console.

Parâmetros de solicitação

**Tabela 2** Parâmetros no cabeçalho da solicitação
Parâmetro	Obrigatoriedade	Tipo	Descrição
Content-Type	Sim	String	Preencha application/json;charset=utf8 neste campo.
X-Auth-Token	Sim	String	Token de usuário do IAM (sem requisitos de permissão especiais).

Parâmetros de resposta

**Tabela 3** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
region	Object	Informações da região.

**Tabela 4** region
Parâmetro	Tipo	Descrição
description	String	Descrição da região.
parent_region_id	String	Nulo.
links	Object	Link de recursos da região.
locales	Object	Nome da região.
id	String	ID da região.
type	String	Tipo de região.

**Tabela 5** region.links
Parâmetro	Tipo	Descrição
self	String	Link de recursos.

**Tabela 6** region.locales
Parâmetro	Tipo	Descrição
zh-cn	String	Nome da região em chinês.
en-us	String	Nome da região em inglês.
pt-br	String	Nome da região em português.
es-us	String	Nome da região em espanhol americano.
es-es	String	Nome da região em espanhol.

Exemplo de solicitação

GET https://iam.myhuaweicloud.com/v3/regions/{region_id}

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{
    "region": {
        "description": "",
        "links": {
            "self": "https://iam.myhuaweicloud.com/v3/regions/la-south-2"
        },
        "type": "public",
        "id": "la-south-2",
        "locales": {
            "pt-br": "AL-Santiago",
            "zh-cn": "Region name in Chinese",
            "en-us": "LA-Santiago",
            "es-us": "AL-Santiago de Chile1",
            "es-es": "LA-Santiago"
        }
    }
}

Códigos de status

Código de status	Descrição
200	A solicitação foi bem-sucedida.
400	Parâmetros inválidos.
401	Autenticação falhou.
403	Acesso negado.
404	O recurso solicitado não pode ser encontrado.
405	O método especificado na solicitação não é permitido para o recurso solicitado.
413	A entidade de solicitação é muito grande.
500	Erro de servidor interno.
503	Serviço indisponível.