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 do catálogo de serviços
Atualizado em 2024-08-31 GMT+08:00
Ver PDF
Compartilhar

Consulta do catálogo de serviços

Função

Essa API é usada para consultar o catálogo de serviços correspondente ao X-Auth-Token contido na solicitação.

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/auth/catalog

Parâmetros de solicitação

Tabela 1 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 (nenhuma permissão especial é necessária, mas o scope do token deve ser project).

Parâmetros de resposta

Tabela 2 Parâmetros no corpo da resposta

Parâmetro

Tipo

Descrição

catalog

Array of objects

Informações do catálogo de serviços.

links

Object

Informações do link do recurso.
Tabela 3 catalog

Parâmetro

Tipo

Descrição

endpoints

Array of objects

Informações do ponto de extremidade.

id

String

ID do serviço.

name

String

Nome do serviço.

type

String

Tipo de serviço.
Tabela 4 catalog.endpoints

Parâmetro

Tipo

Descrição

id

String

ID do ponto de extremidade.

interface

String

Plano ao qual pertence o ponto de extremidade. O valor é public.

region

String

Região à qual o ponto de extremidade pertence.

region_id

String

ID da região à qual o ponto de extremidade pertence.

url

String

URL do ponto de extremidade.
Tabela 5 links

Parâmetro

Tipo

Descrição

self

String

Link de recurso.

Exemplo de solicitação

Solicitação para consultar um catálogo de serviços

GET https://iam.myhuaweicloud.com/v3/auth/catalog

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{
    "catalog": [
        {
            "endpoints": [
                {
                    "id": "33e1cbdd86d34e89a63cf8ad16a5f49f",
                    "interface": "public",
                    "region": "*",
                    "region_id": "*",
                    "url": "https://iam.myhuaweicloud.com/v3.0"
                }
            ],
            "id": "100a6a3477f1495286579b819d399e36",
            "name": "iam",
            "type": "iam"
        },
        {
            "endpoints": [
                {
                    "id": "6c91faa9890f40b397542561e3d87444",
                    "interface": "public",
                    "region": "*",
                    "region_id": "*",
                    "url": "https://cbc.sample.domain.com/v1.0"
                }
            ],
            "id": "ad7396ee0eea4281a180c4230641b72f",
            "name": "bss-intlv1",
            "type": "bss-intlv1"
        }
    ],
    "links": {
        "self": "https://iam.myhuaweicloud.com/v3/auth/catalog"
    }
}

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