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 contas/ Consulta das cotas de uma conta

Atualizado em 2024-08-31 GMT+08:00

Ver PDF

Consulta das cotas de uma conta

Função

Essa API é usada para consultar as cotas de uma conta especificada.

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.0/OS-QUOTA/domains/{domain_id}

**Tabela 1** Parâmetros de URI
Parâmetro	Obrigatório	Tipo	Descrição
domain_id	Sim	String	ID da conta. 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.

**Tabela 2** Parâmetros de consulta
Parâmetro	Obrigatório	Tipo	Descrição
type	Não	String	Tipo da cota que você deseja consultar. As opções incluem: user: usuários do IAM group: grupos de usuários idp: provedores de identidade agency: agências policy: políticas personalizadas assigment_group_mp: número máximo de permissões que podem ser atribuídas a um grupo de usuários para um projeto do IAM assigment_agency_mp: número máximo de permissões que podem ser atribuídas a uma agência assigment_group_ep: número máximo de permissões que podem ser atribuídas a um grupo de usuários para um projeto empresarial assigment_user_ep: número máximo de permissões que podem ser atribuídas a um usuário para um projeto empresarial mapping: cota de regra de mapeamento para todos os provedores de identidade na conta

Parâmetros de solicitação

**Tabela 3** Parâmetros no cabeçalho da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
X-Auth-Token	Sim	String	Token de usuário do IAM (sem requisitos de permissão especiais).

Parâmetros de resposta

Código de status: 200

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

**Tabela 5** quotas
Parâmetro	Tipo	Descrição
resources	Array of objects	Informações sobre recursos.

**Tabela 6** resources
Parâmetro	Tipo	Descrição
max	Integer	Cota máxima.
min	Integer	Cota mínima.
quota	Integer	Cota atual.
type	String	Tipo de cota.
used	Integer	Cota usada. O número de regras de mapeamento de provedor de identidade usadas é personalizado e não é retornado.

Exemplo de solicitação

Solicitação para consultar as cotas de uma conta

GET https://iam.myhuaweicloud.com/v3.0/OS-QUOTA/domains/{domain_id}

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{ 
  "quotas" : { 
    "resources" : [ 
               { 
                  "max" : 1000, 
                  "min" : 50, 
                  "quota" : 50, 
                  "type" : "user", 
                  "used" : 10 
                }, 
               { 
                  "max" : 300, 
                  "min" : 10, 
                  "quota" : 20, 
                  "type" : "group", 
                  "used" : 8 
                }, 
               { 
                  "max" : 20, 
                  "min" : 10, 
                  "quota" : 10, 
                  "type" : "idp", 
                  "used" : 9 
                },
               { 
                  "max" : 300, 
                  "min" : 10, 
                  "quota" : 50, 
                  "type" : "agency", 
                  "used" : 12 
                }, 
               { 
                  "max" : 300, 
                  "min" : 128, 
                  "quota" : 200, 
                  "type" : "policy", 
                  "used" : 8 
                },
               { 
                  "max" : 500, 
                  "min" : 50, 
                  "quota" : 200, 
                  "type" : "assigment_group_mp", 
                  "used" : 8 
                },
               { 
                  "max" : 500, 
                  "min" : 50, 
                  "quota" : 200, 
                  "type" : "assigment_agency_mp", 
                  "used" : 8 
                },
               { 
                  "max" : 5000, 
                  "min" : 50, 
                  "quota" : 500, 
                  "type" : "assigment_group_ep", 
                  "used" : 8 
                },
               { 
                  "max" : 5000, 
                  "min" : 50, 
                  "quota" : 500, 
                  "type" : "assigment_user_ep", 
                  "used" : 8 
                },
               { 
                  "max" : 100, 
                  "min" : 10, 
                  "quota" : 10, 
                  "type" : "mapping", 
                  "used" : null 
                }
             ] 
            } 
}

Código de status: 400

Parâmetros inválidos.

{
  "error_msg" : "Request parameter %(key)s is invalid.",
  "error_code" : "IAM.0007"
}

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.
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.