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
|
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
|---|---|---|---|
|
project_id |
Sim |
String |
ID do projeto. |
Parâmetros 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
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
quotas |
Quotas object |
Detalhes da cota. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
resources |
Array of Resources objects |
Lista de cotas de recursos. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
type |
String |
Tipo de cota. O valor pode ser:
|
|
used |
Integer |
Cotas usadas. |
|
quota |
Integer |
Cotas totais. |
Código de status: 403
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error |
Object |
Mensagem de erro. |
|
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.
