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.