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 2023-02-16 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 específicos da região. 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	Obrigatoriedade	Tipo	Descrição
interface	Não	String	Plano ao qual o ponto final pertence.
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	Obrigatoriedade	Tipo	Descrição
Content-Type	Sim	String	Preencha application/json;charset=utf8 neste 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ção do ponto final.

**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 final pertence.
links	Object	Informações de link de recurso do ponto de extremidade.
id	String	ID do ponto final.
interface	String	Plano ao qual o ponto final pertence.
region	String	Região à qual o ponto final pertence.
url	String	URL do ponto final.
enabled	Boolean	Habilitação do status 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 do recurso anterior.

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

Exemplo de solicitação

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	Autenticação falhou.
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.