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/Data Encryption Workshop/Referência de API/APIs/APIs de gerenciamento de chaves/Consulta de APIs/Consulta da cota de um usuário
Atualizado em 2023-02-28 GMT+08:00
Ver PDF
Compartilhar

Consulta da cota de um usuário

Função

Essa API é usada para consultar a cota de um usuário, ou seja, o número total alocado de CMKs que podem ser criadas por um usuário e o número de CMKs criadas pelo usuário.

Restrições

A cota não inclui chaves principais padrão.

URI

GET /v1.0/{project_id}/kms/user-quotas

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatoriedade

Tipo

Descrição

project_id

Sim

String

ID do projeto.

Parâmetros de solicitação

Tabela 2 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatoriedade

Tipo

Descrição

X-Auth-Token

Sim

String

Token do usuário. O token pode ser obtido chamando a API do IAM (valor de X-Subject-Token no cabeçalho de resposta).

Parâmetros de resposta

Código de status: 200

Tabela 3 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

quotas

Quotas object

Detalhes da cota.

Tabela 4 Cotas

Parâmetro

Tipo

Descrição

resources

Array of Resources objects

Lista de cotas de recursos.

Tabela 5 Recursos

Parâmetro

Tipo

Descrição

type

String

Tipo de cota. O valor pode ser:

  • CMK
  • grant_per_CMK: número máximo de concessões que podem ser criadas para uma CMK

used

Integer

Cotas usadas.

quota

Integer

Cotas totais.

Código de status: 403

Tabela 6 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

error

Object

Mensagem de erro.

Tabela 7 ErrorDetail

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Informação de erro.

Exemplo de solicitações

Nenhum

Exemplo de respostas

Código de status: 200

Processamento da solicitação bem-sucedido.

{
  "quotas" : {
    "resources" : [ {
      "quota" : 20,
      "used" : 20,
      "type" : "CMK"
    }, {
      "quota" : 100,
      "used" : 0,
      "type" : "grant_per_CMK"
    } ]
  }
}

Código de status: 403

Autenticação falhou.

{
  "error" : {
    "error_code" : "KMS.XXX",
    "error_msg" : "XXX"
  }
}

Códigos de status

Código de status

Descrição

200

Processamento da solicitação bem-sucedido.

403

Autenticação falhou.

Códigos de erro

Consulte Códigos de erro.

Tópico principal:Consulta de APIs