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> Gerenciamento de projetos> Consulta de informações do projeto

Atualizado em 2023-02-16 GMT+08:00

Ver PDF

Consulta de informações do projeto

Função

Essa API é usada para consultar informações do projeto.

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/projects

**Tabela 1** Parâmetros de consulta
Parâmetro	Obrigatoriedade	Tipo	Descrição
domain_id	Não	String	ID da conta do projeto de destino. Para obter detalhes sobre como conseguir o ID de domínio, consulte Obtenção de informações de conta, usuário do IAM, grupo, projeto, região e agência.
enabled	Não	Boolean	Habilitação do status do projeto.
is_domain	Não	Boolean	Deixe este campo em branco.
name	Não	String	Nome do projeto. Para obter detalhes sobre como conseguir o ID de domínio, consulte Obtenção de informações de conta, usuário do IAM, grupo, projeto, região e agência.
page	Não	Integer	Número da página para consulta de paginação. O valor mínimo é 1. Este parâmetro deve ser usado com per_page.
parent_id	Não	String	Especifique o ID de um subprojeto. Como alternativa, especifique o ID da conta de um projeto do sistema, por exemplo, o projeto de ap-southeast-1. Para obter detalhes sobre como obter a ID do projeto e a ID da conta, consulte Obtenção de informações de conta, usuário do IAM, grupo, projeto, região e agência.
per_page	Não	Integer	Número de registros de dados a serem exibidos em cada página. O valor varia de 1 a 5000. Este parâmetro deve ser usado com page.

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	Consulte Ações.

Parâmetros de resposta

**Tabela 3** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
links	Object	Informações sobre o link do recurso.
projects	Array of objects	Informações do projeto.

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

**Tabela 5** projects
Parâmetro	Tipo	Descrição
is_domain	Boolean	O valor é false.
description	String	Descrição do projeto.
links	Object	Link de recurso do projeto.
enabled	Boolean	Ativando o status do projeto.
id	String	ID do projeto.
parent_id	String	ID do subprojeto especificado ou ID da conta de um projeto de sistema especificado, por exemplo, o projeto de ap-southeast-1.
domain_id	String	ID da conta.
name	String	Nome do projeto. Por exemplo, ap-southeast-1. O MOS é um projeto embutido do OBS.

**Tabela 6** projects.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/projects

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{
    "projects": [
        {
            "domain_id": "d78cbac186b744899480f25bd02...",
            "is_domain": false,
            "parent_id": "d78cbac186b744899480f25bd022...",
            "name": "ap-southeast-1",
            "description": "",
            "links": {
                "next": null,
                "previous": null,
                "self": "https://iam.myhuaweicloud.com/v3/projects/06f1c15e6f0010672f86c003006c5f17"
            },
            "id": "06f1c15e6f0010672f86c00300...",
            "enabled": true
        },
        {
            "domain_id": "d78cbac186b744899480f25bd...",
            "is_domain": false,
            "parent_id": "d78cbac186b744899480f25bd0...",
            "name": "",
            "description": "",
            "links": {
                "next": null,
                "previous": null,
                "self": "https://iam.myhuaweicloud.com/v3/projects/065a7c66da0010992ff7c0031e5a..."
            },
            "id": "065a7c66da0010992ff7c0031e5a...",
            "enabled": true
        }
    ],
    "links": {
        "next": null,
        "previous": null,
        "self": "https://iam.myhuaweicloud.com/v3/projects"
    }
}

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.
500	Erro de servidor interno.
503	Serviço indisponível.