As seções a seguir contêm exemplos de comandos gcloud alpha quotas info
e gcloud alpha quotas preferences
. Esses comandos permitem que você visualize e
gerencie recursos QuotaInfo
e QuotaPreference
.
É possível usar a CLI do Google Cloud (CLI gcloud) para receber os valores de cotas atuais e especificar preferências de cota para algumas APIs e serviços do Google Cloud.
Limitações
As cotas do Cloud têm as seguintes limitações:
Todos os ajustes de aumento de cota estão sujeitos à aprovação do Google Cloud.
É possível solicitar ajustes de aumento e diminuição de cotas para cotas no nível do projeto.
É possível solicitar ajustes de diminuição de cota para project-, folder- e as cotas no nível da organização.
Antes de começar
Antes de começar, instale e inicialize a CLI gcloud.
Talvez também seja necessário usar o valor QUOTA_ID
. Se esse for o caso, consulte as instruções para encontrar o QUOTA_ID.
Instale e inicialize a CLI gcloud
Para usar a CLI gcloud, verifique se você tem instalado e inicializado a versão mais recente da CLI gcloud, incluindo componentes de comandos alfa. Se você estiver usando o Cloud Shell para interagir com o Google Cloud, a CLI do Google Cloud será instalada.
Encontrar o ID da cota
Muitos dos comandos da CLI gcloud nesta página se referem ao valor do ID de cota.
Para encontrar o valor do ID de cota, use o seguinte comando da CLI gcloud para listar as informações de cota do serviço especificado:
Digite o seguinte comando da CLI gcloud em uma janela de terminal:
gcloud alpha quotas info list --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER
Substitua:
SERVICE_NAME
: o nome do serviço com as cotas que você quer ver. Por exemplo, o nome do serviço do Cloud Logging élogging.googleapis.com
PROJECT_ID_OR_NUMBER
: o ID ou número do projetoPara encontrar o ID do projeto usando o console do Google Cloud, navegue até a página do Resource Manager:
A saída do comando
gcloud alpha quotas info list
contém um texto semelhante ao seguinte exemplo:... "quotaInfos": [ ... { "name": "projects/PROJECT_NUMBER/locations/global/services/compute.googleapis.com/quotaInfos/CPUS-per-project-region", "quotaId": "CPUS-per-project-region", "metric": "compute.googleapis.com/cpus", "containerType": "PROJECT", "dimensions": [ "region" ], "dimensionsInfo": [ { "details": { "value": 20 }, "applicableLocations": [ "us-central1", "us-central2", "us-west1", "us-east1" ] ... } ] }, ... ] ...
Procure o valor que corresponde a
quotaId
e use-o ao especificarQUOTA_ID
nas próximas seções.
Exemplo de comandos de informações de cota da gcloud
Esta seção fornece exemplos que mostram como usar os comandos gcloud alpha quotas info
para visualizar informações de cota para um serviço específico ou para uma
organização.
QuotaInfo
é um recurso somente leitura que fornece informações de metadados e valores de cota
sobre uma cota específica para um determinado projeto, pasta ou organização.
Visualizar informações de cota para um serviço específico
Para visualizar informações de cota de um serviço específico, execute o seguinte comando:
gcloud alpha quotas info describe QUOTA_ID --service=SERVICE_NAME \
--project=PROJECT_ID_OR_NUMBER
Substitua:
QUOTA_ID
: o ID da cotaSERVICE_NAME
: o nome do serviço com as cotas que você quer ver. Por exemplo, o nome do serviço do Cloud Logging élogging.googleapis.com
PROJECT_ID_OR_NUMBER
: o ID ou número do projeto
Visualizar informações de cota de uma organização
Para visualizar os mesmos detalhes de cota do serviço para uma organização, execute o seguinte comando:
gcloud alpha quotas info list --service=SERVICE_NAME --organization=ORGANIZATION_ID
Substitua:
SERVICE_NAME
: o nome do serviço com as cotas que você quer ver. Por exemplo, o nome do serviço do Cloud Logging élogging.googleapis.com
ORGANIZATION_ID
: o ID da organização
Exemplo de comandos de preferências de cota da gcloud
Nesta seção, fornecemos exemplos que mostram como usar os comandos gcloud alpha quotas preferences
para verificar as preferências de cota atuais e ajustar o valor da cota.
O recurso QuotaPreference
representa sua preferência por uma determinada
combinação de dimensões. Uma dimensão é um atributo que representa uma região
ou zona ou uma dimensão específica do serviço, como gpu_family
ou network_id
.
Verificar as preferências
Para verificar as preferências existentes, execute o seguinte comando:
gcloud alpha quotas preferences list --project=PROJECT_ID_OR_NUMBER
Substitua PROJECT_ID_OR_NUMBER
pelo ID ou número do projeto.
Verifique as preferências existentes com ajustes de cota pendentes
Para verificar as preferências atuais com ajustes de cota pendentes, adicione a
sinalização --reconciling-only=true
, conforme mostrado no comando a seguir:
gcloud alpha quotas preferences list --project=PROJECT_ID_OR_NUMBER --reconciling-only=true
Substitua PROJECT_ID_OR_NUMBER
pelo ID ou número do projeto.
Solicitar um ajuste de aumento de cota para uma região específica quando uma preferência de cota não tiver sido definida
Para solicitar um ajuste de aumento de cota para uma região específica quando uma preferência ainda não tiver sido definida, execute o seguinte comando:
gcloud alpha quotas preferences create --preferred-value=PREFERRED_VALUE \
--quota-id=QUOTA_ID --service=SERVICE_NAME \
--project=PROJECT_ID_OR_NUMBER --preference-id=PREFERENCE_ID
Substitua:
PREFERRED_VALUE
: o valor de cota preferencialQUOTA_ID
: o ID da cotaSERVICE_NAME
: o nome do serviço com as cotas que você quer ver. Por exemplo, o nome do serviço do Cloud Logging élogging.googleapis.com
PROJECT_ID_OR_NUMBER
: o ID ou número do projetoPREFERENCE_ID
: o ID da preferência
Solicitar um ajuste de aumento de cota para uma região específica quando uma preferência de cota tiver sido definida
Para solicitar um ajuste de aumento de cota para uma região específica e já houver uma preferência, execute novamente o seguinte comando:
gcloud alpha quotas preferences update PREFERENCE_ID --preferred-value=PREFERRED_VALUE \
--quota-id=QUOTA_ID --service=SERVICE_NAME--project=PROJECT_ID_OR_NUMBER
Substitua:
PREFERENCE_ID
: o ID da preferênciaPREFERRED_VALUE</var>"}}
: o valor de cota preferencialQUOTA_ID
: o ID da cotaSERVICE_NAME
: o nome do serviço com as cotas que você quer ver. Por exemplo, o nome do serviço do Cloud Logging élogging.googleapis.com
PROJECT_ID_OR_NUMBER
: o ID ou número do projeto
Recuperar uma preferência de cota existente
Para recuperar uma preferência de cota existente, execute o seguinte comando:
gcloud alpha quotas preferences describe PREFERENCE_ID project=PROJECT_ID_OR_NUMBER
Substitua:
PREFERENCE_ID
: o ID da preferênciaPROJECT_ID_OR_NUMBER
: o ID ou número do projeto
Outros serviços com comandos da gcloud CLI relacionados a cotas
Além de gcloud alpha quotas
, alguns serviços têm o próprio acesso à linha de comando para obter informações de uso de recursos e cotas.
Por exemplo, o Compute Engine permite acessar informações de cota usando. Para mais detalhes, consulte as seguintes seções do Compute Engine:
- cotas de alocação.
- Visão geral do compute da gcloud CLI
- A seção gcloud CLI compute da referência do SDK do Google Cloud.
A seguir
Para uma lista completa de comandos e sinalizações gcloud alpha quotas
, consulte a seção gcloud alpha cotas da referência da CLI do Google Cloud.
Para mais informações sobre a terminologia de cotas, consulte Noções básicas sobre valores de cota e limites do sistema.