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

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.