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 2024-08-31 GMT+08:00
Ver PDF
Compartilhar

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 da região específica. 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

Obrigatório

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

Obrigatório

Tipo

Descrição

Content-Type

Sim

String

Preencha application/json;charset=utf8 nesse 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 recurso 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 recurso.

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

Solicitação para consultar detalhes da regiã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

Falha na autenticação.

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.

Códigos de erro

Nenhum

Tópico principal:Gerenciamento de regiões