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/ Listagem de pontos de extremidade
Atualizado em 2024-08-31 GMT+08:00
Ver PDF
Compartilhar

Listagem de pontos de extremidade

Função

Essa API é usada para listar todos os pontos 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

Tabela 1 Parâmetros de consulta

Parâmetro

Obrigatório

Tipo

Descrição

interface

Não

String

Plano ao qual pertence o ponto de extremidade.

service_id

Não

String

ID do serviço.

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

endpoints

Array of objects

Link de recursos.

links

Object

Informações do ponto de extremidade.
Tabela 4 endpoints

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 endpoints.links

Parâmetro

Tipo

Descrição

self

String

Link de recursos.

next

String

Próximo link de recurso.

previous

String

Link de recurso anterior.
Tabela 6 links

Parâmetro

Tipo

Descrição

self

String

Link de recursos.

previous

String

Link de recurso anterior.

next

String

Próximo link de recurso.

Exemplo de solicitação

Solicitação para consultar pontos de extremidade

GET https://iam.myhuaweicloud.com/v3/endpoints

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{
    "endpoints": [
        {
            "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
        },
        {
            "service_id": "5186586acd38461d84b3dbf9f02e33ae",
            "region_id": "ap-southeast-1",
            "links": {
                "next": null,
                "previous": null,
                "self": "https://iam.myhuaweicloud.com/v3/endpoints/00d546d4823e452491407284ab26612c"
            },
            "id": "00d546d4823e452491407284ab26612c",
            "interface": "public",
            "region": "ap-southeast-1",
            "url": "https://ges.sample.domain.com/v1.0/$(tenant_id)s",
            "enabled": true
        }
    ],
    "links": {
        "next": null,
        "previous": null,
        "self": "https://iam.myhuaweicloud.com/v3/endpoints"
    }
}

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