Consulta das cotas de instância de um locatário
Função
Essa API é usada para consultar as cotas de recursos de um locatário especificado. Antes de chamar essa API:
- Saiba como autorizá-la e autenticá-la.
- Obtenha a região e o ponto de extremidade necessários.
URI
GET /v3/{project_id}/project-quotas
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
Explicação: ID do projeto de um locatário numa região. Para obter esse valor, consulte Obtenção de um ID de projeto. Restrições: Nenhuma Intervalo de valores: O valor pode conter 32 caracteres. Apenas letras e dígitos são permitidos. Valor padrão: Nenhum |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
type |
Não |
String |
Explicação: Tipo de recurso usado para filtrar cotas. Restrições: Nenhuma Intervalo de valores: instance Valor padrão: instance |
Parâmetros de solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
X-Auth-Token |
Sim |
String |
Explicação: Token do usuário. Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é o valor do token. Restrições: Nenhuma Intervalo de valores: Nenhum Valor padrão: Nenhum |
X-Language |
Não |
String |
Explicação: Tipo de linguagem da solicitação. Restrições: Nenhuma Intervalo de valores:
Valor padrão: en-us |
Parâmetros de resposta
Código de status: 200
Parâmetro |
Tipo |
Descrição |
---|---|---|
quotas |
project-quotas object |
Explicação: Cota de instância de um locatário. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
resources |
Array of resource objects |
Explicação: Objetos de recurso. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
type |
String |
Explicação: Cota de um tipo especificado. Intervalo de valores: instance |
used |
Integer |
Explicação: Número de recursos criados. Intervalo de valores: ≥ 0 |
quota |
Integer |
Explicação: Cota máxima de recursos. Intervalo de valores: A cota de quantidade da instância varia de 0 a 100.000. O valor -1 indica que não há limite. |
Código de status: 400
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Mensagem de erro. |
Código de status: 500
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Mensagem de erro. |
Exemplo de solicitação
Consulta das cotas de instância de um locatário
GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/project-quotas?type=instance
Exemplo de resposta
Código de status: 200
Bem-sucedido.
{ "quotas" : { "resources" : [ { "type" : "instance,", "used" : "4,", "quota" : 50 } ] } }
Código de status
Para mais detalhes, consulte Códigos de status.
Código de erro
Para mais detalhes, consulte Códigos de erro.