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/ Serviços e pontos de extremidade/ Consulta de detalhes do ponto de extremidade

Atualizado em 2024-08-31 GMT+08:00

Ver PDF

Consulta de detalhes do ponto de extremidade

Função

Essa API é usada para consultar os detalhes de um ponto de extremidade. Um ponto de extremidade fornece uma entrada para um serviço específico.

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/endpoints/{endpoint_id}

**Tabela 1** Parâmetros de URI
Parâmetro	Obrigatório	Tipo	Descrição
endpoint_id	Sim	String	ID do ponto de extremidade a ser consultado.

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
endpoint	Object	Informações do ponto de extremidade.

**Tabela 4** endpoint
Parâmetro	Tipo	Descrição
service_id	String	ID do serviço ao qual o ponto de extremidade pertence.
region_id	String	ID da região à qual o ponto de extremidade pertence.
links	Object	Informações sobre link de recurso do ponto de extremidade.
id	String	ID do ponto de extremidade.
interface	String	Plano ao qual pertence o ponto de extremidade.
region	String	Região à qual o ponto de extremidade pertence.
url	String	URL do ponto de extremidade.
enabled	Boolean	Status de ativação do ponto de extremidade.

**Tabela 5** endpoint.links
Parâmetro	Tipo	Descrição
self	String	Link de recurso.
next	String	Próximo link de recurso.
previous	String	Link de recurso anterior.

Exemplo de solicitação

Solicitação para consultar detalhes do ponto de extremidade

GET https://iam.myhuaweicloud.com/v3/endpoints/{endpoint_id}

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{
    "endpoint": {
        "service_id": "3e93d3eb20b34bfbbdcc81a79c1c3045",
        "region_id": "ap-southeast-1",
        "links": {
            "next": null,
            "previous": null,
            "self": "https://iam.myhuaweicloud.com/v3/endpoints/0046cca357c94165b7a10ec2c01bdf60"
        },
        "id": "0046cca357c94165b7a10ec2c01bdf60",
        "interface": "public",
        "region": "ap-southeast-1",
        "url": "https://ims.sample.domain.com",
        "enabled": true
    }
}

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.
501	A API não está disponível.
503	Serviço indisponível.