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 2024-08-31 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 da região específica. 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	Obrigatório	Tipo	Descrição
domain_id	Não	String	ID da conta do projeto de destino. Para obter detalhes sobre como obter o ID da conta, consulte Obtenção de informações sobre conta, usuário do IAM, grupo, projeto, região e agência.
enabled	Não	Boolean	Status de ativação do projeto.
is_domain	Não	Boolean	Deixe este campo em branco.
name	Não	String	Nome do projeto. Para obter detalhes sobre como obter o nome do projeto, consulte Obtenção de informações sobre 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 junto 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 ap-southeast-1. Para obter detalhes sobre como obter o ID do projeto e o ID da conta, consulte Obtenção de informações sobre 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 junto com page.

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 acesso emitido para um usuário para suportar sua identidade e permissões. Para obter detalhes sobre as permissões exigidas pelo token, consulte Ações.

Parâmetros de resposta

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

**Tabela 4** links
Parâmetro	Tipo	Descrição
self	String	Link de recurso.
previous	String	Link de 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	Status de ativação 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 ap-southeast-1.
domain_id	String	ID da conta.
name	String	Nome do projeto. Por exemplo, ap-southeast-1 e MOS. MOS é um projeto integrado do OBS.

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

Exemplo de solicitação

Solicitação para consultar informações do projeto

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	Falha na autenticação.
403	Acesso negado.
404	O recurso solicitado não pode ser encontrado.
500	Erro de servidor interno.
503	Serviço indisponível.