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
Compartilhar

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.

Códigos de erro

Nenhum