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 das cotas de um projeto

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

Ver PDF

Consulta das cotas de um projeto

Função

Essa API é usada para consultar as cotas de um projeto especificado.

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.0/OS-QUOTA/projects/{project_id}

**Tabela 1** Parâmetros de URI
Parâmetro	Obrigatoriedade	Tipo	Descrição
project_id	Sim	String	ID do projeto a ser consultado. 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.

Parâmetros de solicitação

**Tabela 2** Parâmetros no cabeçalho da solicitação
Parâmetro	Obrigatoriedade	Tipo	Descrição
X-Auth-Token	Sim	String	Um token com permissões de administrador de segurança ou um token de usuário do IAM. (Não são necessárias permissões especiais, mas o escopo do token deve ser o projeto especificado na URL.)

Parâmetros de resposta

**Tabela 3** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
quotas	object	Informações de cota da conta.

**Tabela 4** quotas
Parâmetro	Tipo	Descrição
resources	Array of objects	Informação de recursos.

**Tabela 5** resources
Parâmetro	Tipo	Descrição
max	Integer	Quota máxima.
min	Integer	Quota mínima.
quota	Integer	Quota atual.
type	String	Tipo de cota.
used	Integer	Cota usada.

Exemplo de solicitação

GET https://iam.myhuaweicloud.com/v3.0/OS-QUOTA/projects/{project_id}

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{ 
  "quotas" : { 
                "resources" : [ 
                      { 
                           "max" : 50, 
                           "min" : 0, 
                           "quota" : 10, 
                           "type" : "project", 
                           "used" : 4 
                         } 
                     ] 
               } 
}

Código de status: 403

Acesso negado.

Exemplo 1

{ 
   "error_msg" : "You are not authorized to perform the requested action.", 
   "error_code" : "IAM.0002" 
 }

Exemplo 2

{ 
   "error_msg" : "Policy doesn't allow %(actions)s to be performed.", 
   "error_code" : "IAM.0003" 
 }

Código de status: 404

O recurso solicitado não pode ser encontrado.

{
  "error_msg" : "Could not find %(target)s: %(target_id)s.",
  "error_code" : "IAM.0004"
}

Código de status: 500

Erro de servidor interno.

{ 
  "error_msg" : "An unexpected error prevented the server from fulfilling your request.", 
  "error_code" : "IAM.0006" 
}

Códigos de status

Código de status	Descrição
200	A solicitação foi bem-sucedida.
401	Autenticação falhou.
403	Acesso negado.
404	O recurso solicitado não pode ser encontrado.
500	Erro de servidor interno.