Esta página foi traduzida pela API Cloud Translation.

Faça a gestão de quotas através da CLI gcloud beta

As secções seguintes contêm exemplos de comandos gcloud beta quotas info e gcloud beta quotas preferences. Estes comandos permitem-lhe ver e gerir recursos QuotaInfo e QuotaPreference.

Pode usar a CLI Google Cloud (CLI gcloud) para obter os valores das quotas atuais e especificar as preferências de quotas para algumas APIs e serviços. Google Cloud

Limitações

As quotas do Google Cloud têm as seguintes limitações:

Na maioria dos casos, os ajustes de aumento da quota têm de ser feitos ao nível do projeto. Um número limitado de produtos suporta ajustes de aumento da quota ao nível da organização. Para ver se um Google Cloud produto suporta ajustes de aumento da quota ao nível da organização, consulte a documentação desse produto.
Pode pedir ajustes de diminuição da quota para quotas ao nível do projeto, da organização e da pasta.

Antes de começar

Antes de usar a CLI gcloud, certifique-se de que instala e inicializa a CLI gcloud.

Também pode precisar do valor QUOTA_ID. Se for o caso, consulte as instruções para encontrar o ID da quota.

Instale e inicialize a CLI gcloud

Para usar a CLI gcloud para as quotas do Google Cloud, certifique-se de que instala e inicializa os componentes:

Instale a CLI gcloud.

Se estiver a usar o Cloud Shell, pode ignorar este passo porque a CLI gcloud vem pré-instalada.
Inicialize a CLI gcloud.
Instale o componente beta executando o seguinte comando:
```
gcloud components install beta
```

Encontre o ID da quota

Vários comandos da CLI gcloud neste documento referem-se ao valor do ID da quota. Pode encontrar o ID da quota através da Google Cloud consola, da CLI gcloud, das bibliotecas cliente ou da API REST. Esta secção mostra como encontrar o ID da quota através da Google Cloud consola ou da CLI gcloud.

Consola

Na Google Cloud consola, aceda à página IAM e administração > Quotas e limites do sistema:
Aceda a Quotas e limites do sistema
Clique em Filtrar para filtrar pelo seu serviço.
Se não vir a coluna Nome do limite, clique no ícone Opções de apresentação de colunas.... Selecione Nome do limite e clique em OK.
A coluna Nome do limite mostra o ID da quota.

gcloud

Para encontrar o valor do ID da quota através da CLI gcloud, execute o seguinte comando para listar as informações da quota para o serviço especificado:

Introduza o seguinte comando da CLI gcloud numa janela de terminal:
```
gcloud beta quotas info list --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
--billing-project=BILLING_PROJECT_ID_OR_NUMBER
```
Substitua o seguinte:
- SERVICE_NAME: o nome do serviço com as quotas que quer ver. Por exemplo, o nome do serviço do Compute Engine é compute.googleapis.com
- PROJECT_ID_OR_NUMBER: o ID do projeto ou o número do projeto
  
  Para encontrar o ID do projeto através da Google Cloud consola, navegue para a página Resource Manager:
  Aceda ao Resource Manager
- BILLING_PROJECT_ID_OR_NUMBER: o ID do projeto ou o número do projeto para utilização de quotas e faturação. A execução de um comando gcloud afeta a quota como se tivesse feito o pedido equivalente diretamente através de uma API REST ou RPC.
  
  Especifique o projeto cuja quota quer usar. Pode ser diferente do projeto que contém o serviço para o qual está a encontrar o ID da quota.
  
  Se já definiu o projeto de faturação quando configurou a CLI gcloud, esta flag é opcional. Caso contrário, a omissão pode causar um erro de acesso negado. Para mais informações, consulte o artigo Defina o projeto de quota.

A saída do comando gcloud beta quotas info list contém 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 quando especificar QUOTA_ID nas secções seguintes.

Exemplos de comandos de informações de quotas gcloud

Esta secção fornece exemplos que mostram como usar os comandos gcloud beta quotas info para ver informações sobre a quota de um serviço específico ou de uma organização.

QuotaInfo é um recurso só de leitura que fornece metadados e informações de valor de quota acerca de uma quota específica para um determinado projeto, pasta ou organização.

Veja informações sobre quotas de um serviço específico

Para ver informações sobre a quota de um serviço específico, execute o seguinte comando:

gcloud beta quotas info describe QUOTA_ID --service=SERVICE_NAME \
    --project=PROJECT_ID_OR_NUMBER --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Substitua o seguinte:

QUOTA_ID: o valor do ID da quota. Para encontrar este valor, consulte o artigo Encontre o seu ID de quota.
SERVICE_NAME: o nome do serviço com as quotas que quer ver. Por exemplo, o nome do serviço do Compute Engine é compute.googleapis.com
PROJECT_ID_OR_NUMBER: o ID do projeto ou o número do projeto
BILLING_PROJECT_ID_OR_NUMBER: o ID do projeto ou o número do projeto para utilização de quotas e faturação. A execução de um comando gcloud afeta a quota como se tivesse feito o pedido equivalente diretamente através de uma API REST ou RPC.

Especifique o projeto cuja quota quer usar. Pode ser diferente do projeto que contém o serviço para o qual está a ver informações de quota.

Se já definiu o projeto de faturação quando configurou a CLI gcloud, esta flag é opcional. Caso contrário, a omissão pode causar um erro de acesso negado. Para mais informações, consulte o artigo Defina o projeto de quota.

Veja informações sobre quotas de uma organização

Para ver os detalhes da quota do mesmo serviço para uma organização, execute o seguinte comando:

gcloud beta quotas info list --service=SERVICE_NAME --organization=ORGANIZATION_ID \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Substitua o seguinte:

SERVICE_NAME: o nome do serviço com as quotas que quer ver. Por exemplo, o nome do serviço do Compute Engine é compute.googleapis.com
ORGANIZATION_ID: o ID da sua organização
BILLING_PROJECT_ID_OR_NUMBER: o ID do projeto ou o número do projeto para utilização de quotas e faturação. A execução de um comando gcloud afeta a quota como se tivesse feito o pedido equivalente diretamente através de uma API REST ou RPC.

Especifique o projeto cuja quota quer usar. Pode ser diferente do projeto que contém o serviço para o qual está a ver informações de quota.

Se já definiu o projeto de faturação quando configurou a CLI gcloud, esta flag é opcional. Caso contrário, a omissão pode causar um erro de acesso negado. Para mais informações, consulte o artigo Defina o projeto de quota.

Exemplos de comandos gcloud quota preferences

Esta secção fornece exemplos que mostram como usar os comandos gcloud beta quotas preferences para verificar as preferências de quota existentes e ajustar o valor da quota.

O recurso QuotaPreference representa a sua preferência por uma determinada combinação de dimensões. Uma dimensão é um atributo que representa uma região ou uma zona, ou uma dimensão específica do serviço, como gpu_family ou network_id.

Verifique se existem preferências

Para verificar as preferências existentes, execute o seguinte comando:

gcloud beta quotas preferences list --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Substitua o seguinte:

PROJECT_ID_OR_NUMBER : o ID do projeto ou o número do projeto
BILLING_PROJECT_ID_OR_NUMBER: o ID do projeto ou o número do projeto para utilização de quotas e faturação. A execução de um comando gcloud afeta a quota como se tivesse feito o pedido equivalente diretamente através de uma API REST ou RPC.

Especifique o projeto cuja quota quer usar. Este pode ser diferente do projeto para o qual está a verificar as preferências de quota.

Se já definiu o projeto de faturação quando configurou a CLI gcloud, esta flag é opcional. Caso contrário, a omissão pode causar um erro de acesso negado. Para mais informações, consulte o artigo Defina o projeto de quota.

Verifique se existem preferências com ajustes de quota pendentes

Para verificar se existem preferências com ajustes de quota pendentes, adicione a flag --reconciling-only=true, conforme mostrado no comando seguinte:

gcloud beta quotas preferences list --project=PROJECT_ID_OR_NUMBER --reconciling-only=true \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Substitua o seguinte:

PROJECT_ID_OR_NUMBER : o ID do projeto ou o número do projeto
BILLING_PROJECT_ID_OR_NUMBER: o ID do projeto ou o número do projeto para utilização de quotas e faturação. A execução de um comando gcloud afeta a quota como se tivesse feito o pedido equivalente diretamente através de uma API REST ou RPC.

Especifique o projeto cuja quota quer usar. Este pode ser diferente do projeto para o qual está a verificar as preferências de quota.

Se já definiu o projeto de faturação quando configurou a CLI gcloud, esta flag é opcional. Caso contrário, a omissão pode causar um erro de acesso negado. Para mais informações, consulte o artigo Defina o projeto de quota.

Peça um ajuste de aumento da quota quando ainda não tiver definido uma preferência de quota

Para pedir um ajuste de aumento da quota para uma região específica quando ainda não foi definida uma preferência, execute o seguinte comando:

gcloud beta quotas preferences create --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME  --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER --email=EMAIL \
    --justification=JUSTIFICATION --preference-id=PREFERENCE_ID

Substitua o seguinte:

PREFERRED_VALUE: o valor de quota preferencial
QUOTA_ID: o valor do ID da quota. Para encontrar este valor, consulte o artigo Encontre o seu ID de quota.
SERVICE_NAME: o nome do serviço com as quotas que quer ver. Por exemplo, o nome do serviço do Compute Engine é compute.googleapis.com
PROJECT_ID_OR_NUMBER: o ID do projeto ou o número do projeto
BILLING_PROJECT_ID_OR_NUMBER: o ID do projeto ou o número do projeto para utilização de quotas e faturação. A execução de um comando gcloud afeta a quota como se tivesse feito o pedido equivalente diretamente através de uma API REST ou RPC.

Especifique o projeto cuja quota quer usar. Este pode ser diferente do projeto para o qual está a pedir um ajuste de quota.

Se já definiu o projeto de faturação quando configurou a CLI gcloud, esta flag é opcional. Caso contrário, a omissão pode causar um erro de acesso negado. Para mais informações, consulte o artigo Defina o projeto de quota.
EMAIL: um endereço de email que pode ser usado como contacto, caso a Google Cloud precise de mais informações antes de poder conceder uma quota adicional
JUSTIFICATION: uma string opcional que explica o seu pedido
PREFERENCE_ID: um ID de preferência opcional; se não especificar um ID de preferência, a API gera um identificador único universal (UUID) para si

Peça um ajuste de aumento da quota quando tiver sido definida uma preferência de quota

Para pedir um ajuste de aumento da quota para uma região específica e já existir uma preferência, execute o seguinte comando:

gcloud beta quotas preferences update PREFERENCE_ID --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER --email=EMAIL  \
    --justification=JUSTIFICATION

Substitua o seguinte:

PREFERENCE_ID: o ID de preferência, que é obrigatório como o primeiro argumento quando usa o comando gcloud beta quotas preferences update
PREFERRED_VALUE: o valor de quota preferencial
QUOTA_ID: o valor do ID da quota. Para encontrar este valor, consulte o artigo Encontre o seu ID de quota.
SERVICE_NAME: o nome do serviço com as quotas que quer ver. Por exemplo, o nome do serviço do Compute Engine é compute.googleapis.com
PROJECT_ID_OR_NUMBER: o ID do projeto ou o número do projeto
BILLING_PROJECT_ID_OR_NUMBER: o ID do projeto ou o número do projeto para utilização de quotas e faturação. A execução de um comando gcloud afeta a quota como se tivesse feito o pedido equivalente diretamente através de uma API REST ou RPC.

Especifique o projeto cuja quota quer usar. Este pode ser diferente do projeto para o qual está a pedir um ajuste de quota.

Se já definiu o projeto de faturação quando configurou a CLI gcloud, esta flag é opcional. Caso contrário, a omissão pode causar um erro de acesso negado. Para mais informações, consulte o artigo Defina o projeto de quota.
EMAIL: um endereço de email que pode ser usado como contacto, caso a Google Cloud precise de mais informações antes de poder conceder uma quota adicional
JUSTIFICATION: uma string opcional que explica o seu pedido

Peça um ajuste de aumento da quota através de uma dimensão

Para pedir um ajuste de aumento da quota através de uma dimensão, execute o seguinte comando:

gcloud beta quotas preferences create --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
    --dimensions=KEY1=VALUE1,KEY2=VALUE2,... --billing-project=BILLING_PROJECT_ID_OR_NUMBER \
    --email=EMAIL --justification=JUSTIFICATION --preference-id=PREFERENCE_ID

Substitua o seguinte:

PREFERRED_VALUE: o valor de quota preferencial
QUOTA_ID: o valor do ID da quota. Para encontrar este valor, consulte o artigo Encontre o seu ID de quota.
SERVICE_NAME: o nome do serviço com as quotas que quer ver. Por exemplo, o nome do serviço do Compute Engine é compute.googleapis.com
PROJECT_ID_OR_NUMBER: o ID do projeto ou o número do projeto
KEY1=VALUE1,KEY2=VALUE2,...: uma lista opcional que especifica a sua dimensão como uma lista separada por vírgulas de pares de chave-valor. Por exemplo, a sua dimensão pode especificar os seguintes valores do Compute Engine:
- KEY1=VALUE1: region=us-east4
- KEY2=VALUE2: gpu_family=NVIDIA_H100
BILLING_PROJECT_ID_OR_NUMBER: o ID do projeto ou o número do projeto para utilização de quotas e faturação. A execução de um comando gcloud afeta a quota como se tivesse feito o pedido equivalente diretamente através de uma API REST ou RPC.

Especifique o projeto cuja quota quer usar. Este pode ser diferente do projeto para o qual está a pedir um ajuste de quota.

Se já definiu o projeto de faturação quando configurou a CLI gcloud, esta flag é opcional. Caso contrário, a omissão pode causar um erro de acesso negado. Para mais informações, consulte o artigo Defina o projeto de quota.
EMAIL: um endereço de email que pode ser usado como contacto, caso a Google Cloud precise de mais informações antes de poder conceder uma quota adicional
JUSTIFICATION: uma string opcional que explica o seu pedido
PREFERENCE_ID: um ID de preferência opcional; se não especificar um ID de preferência, a API gera um identificador único universal (UUID) para si

A saída contém dados específicos da sua configuração e tem um aspeto semelhante ao da seguinte saída de exemplo:

{
    "createTime":"CREATE_TIME",
    "dimensions":{
        "gpu_family":"NVIDIA_H100",
        "region":"us-east4"
    },
    "etag":"ETAG_VALUE",
    "name":"projects/12345/locations/global/quotaPreferences/PREFERENCE_ID",
    "quotaConfig":{
        "grantedValue":"0",
        "preferredValue":"128",
        "traceId":"TRACE_ID"
    },
    "quotaId":"GPUS-PER-GPU-FAMILY-per-project-region",
    "reconciling":true,
    "service":"compute.googleapis.com",
    "updateTime":"UPDATE_TIME",
}

Veja uma preferência de quota existente

Para ver os detalhes da preferência de quota que acabou de criar, execute o seguinte comando:

gcloud beta quotas preferences describe PREFERENCE_ID \
    --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Substitua o seguinte:

PREFERENCE_ID: o ID de preferência, que é obrigatório como o primeiro argumento quando usa o comando gcloud beta quotas preferences describe
PROJECT_ID_OR_NUMBER: o ID do projeto ou o número do projeto
BILLING_PROJECT_ID_OR_NUMBER: o ID do projeto ou o número do projeto para utilização de quotas e faturação. A execução de um comando gcloud afeta a quota como se tivesse feito o pedido equivalente diretamente através de uma API REST ou RPC.

Especifique o projeto cuja quota quer usar. Este pode ser diferente do projeto para o qual está a ver a preferência de quota.

Se já definiu o projeto de faturação quando configurou a CLI gcloud, esta flag é opcional. Caso contrário, a omissão pode causar um erro de acesso negado. Para mais informações, consulte o artigo Defina o projeto de quota.

A saída contém dados específicos da sua configuração e tem um aspeto semelhante ao da seguinte saída de exemplo:

createTime: 'CREATE_TIME'
dimensions:
  gpu_family: NVIDIA_H100
  region: us-east4
etag: ETAG_VALUE
name: projects/12345/locations/global/quotaPreferences/PREFERENCE_ID
quotaConfig:
  grantedValue: '0'
  preferredValue: '128'
  traceId: TRACE_ID
quotaId: GPUS-PER-GPU-FAMILY-per-project-region
reconciling: true
service: compute.googleapis.com
updateTime: 'UPDATE_TIME'

Ative o ajustador de quota através de um projeto cliente

Um projeto de cliente refere-se ao projeto usado por uma aplicação ou um utilizador para aceder e interagir com Google Cloud recursos, enquanto um projeto de recursos é o projeto subjacente onde esses recursos são armazenados e geridos.

Para ativar o ajuste de quota através de um projeto de cliente com a CLI gcloud, siga estes passos:

Crie um projeto de cliente:
```
gcloud projects create CLIENT_PROJECT_ID
gcloud config set project CLIENT_PROJECT_ID
```
Substitua CLIENT_PROJECT_ID pelo ID do projeto que quer criar. Os IDs dos projetos são imutáveis e só podem ser definidos durante a criação do projeto. Têm de começar com uma letra minúscula e podem ter letras ASCII minúsculas, dígitos ou hífenes. Os IDs dos projetos têm de ter entre 6 e 30 carateres.

Ative a API Cloud Quotas no projeto cliente:

gcloud services enable cloudquotas.googleapis.com

Crie uma conta de serviço no projeto do cliente:
```
gcloud iam service-accounts create SA_NAME \
  --display-name SA_DISPLAY_NAME \
  --project=CLIENT_PROJECT_ID
```
Substitua o seguinte:
- SA_NAME: o nome interno da nova conta de serviço. Usado para gerar um IAM_ACCOUNT (um endereço de email interno do IAM usado como identificador da conta de serviço), que tem de ser transmitido a comandos subsequentes.
- SA_DISPLAY_NAME: o nome a apresentar da conta de serviço.
- CLIENT_PROJECT_ID: o ID do projeto do cliente.
Crie uma chave de conta de serviço:
```
gcloud iam service-accounts keys create KEY_FILE \
  --iam-account=SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com
```
Substitua o seguinte:
- KEY_FILE: o caminho para o ficheiro de chave da conta de serviço JSON.
- SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com: o endereço de email da conta de serviço.

Conceda autorizações da IAM à conta de serviço:

gcloud projects add-iam-policy-binding CLIENT_PROJECT_ID \
  --member="serviceAccount:SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/serviceusage.serviceUsageConsumer"

gcloud projects add-iam-policy-binding RESOURCE_PROJECT_ID \
  --member="serviceAccount:SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/cloudquotas.admin"

Substitua o seguinte:

CLIENT_PROJECT_ID: o ID do projeto do cliente.
RESOURCE_PROJECT_ID: o ID do projeto de recursos.
SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com: o endereço de email da conta de serviço.

Ative a conta de serviço através da chave da conta de serviço que criou anteriormente:
```
gcloud auth activate-service-account --key-file=KEY_FILE
```
Ative o ajustador de quota no seu projeto de recursos especificando o projeto e a definição de ativação:
```
gcloud beta quotas adjuster settings update --project=RESOURCE_PROJECT_ID \
  --enablement=enabled
```
A definição de ativação é necessária quando usa a CLI gcloud e tem de ser definida como enabled ou disabled.

Opcional: para ver as definições atuais do ajuste de quota, execute o seguinte comando:

gcloud beta quotas adjuster settings describe --project=RESOURCE_PROJECT_ID

O resultado é semelhante ao seguinte exemplo:

enablement: ENABLED
etag: 8izmJp6EI__mOfLyhkQU9
name: projects/RESOURCE_PROJECT_ID/locations/global/quotaAdjusterSettings
updateTime: '2025-01-10T17:22:37.883221181Z'

Para ativar o ajustador de quotas para vários projetos de cliente, siga os passos 5 a 8 anteriores. Ao fazê-lo, certifique-se de que as seguintes condições são cumpridas:

A API Cloud Quotas está ativada no projeto do cliente.
Certifique-se de que a conta de serviço tem a cloudquotas.admin função do IAM em todos os projetos de recursos nos quais quer ativar o ajustador de quotas.

Outros serviços com comandos da CLI gcloud relacionados com a quota

Além do gcloud beta quotas, alguns serviços têm o seu próprio acesso à linha de comandos a informações de utilização de recursos e quotas.

Por exemplo, o Compute Engine permite-lhe aceder às informações de quota. Para mais detalhes, consulte as seguintes secções do Compute Engine:

Quotas de atribuição
A vista geral do Compute da CLI gcloud
A secção gcloud CLI compute da referência do SDK Google Cloud.

O que se segue?

Para resolver problemas com comandos gcloud beta quotas, consulte o artigo Resolva problemas de erros da CLI gcloud.
Para ver detalhes sobre os comandos e as flags gcloud beta quotas, consulte a secção gcloud beta quotas da referência da CLI do Google Cloud.
Para mais informações sobre a terminologia de quotas, consulte o artigo Compreenda a terminologia de quotas e limites do sistema.

Faça a gestão de quotas através da CLI gcloud beta Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Limitações

Antes de começar

Instale e inicialize a CLI gcloud

Encontre o ID da quota

Consola

gcloud

Exemplos de comandos de informações de quotas gcloud

Veja informações sobre quotas de um serviço específico

Veja informações sobre quotas de uma organização

Exemplos de comandos gcloud quota preferences

Verifique se existem preferências

Verifique se existem preferências com ajustes de quota pendentes

Peça um ajuste de aumento da quota quando ainda não tiver definido uma preferência de quota

Peça um ajuste de aumento da quota quando tiver sido definida uma preferência de quota

Peça um ajuste de aumento da quota através de uma dimensão

Veja uma preferência de quota existente

Ative o ajustador de quota através de um projeto cliente

Outros serviços com comandos da CLI gcloud relacionados com a quota

O que se segue?

Faça a gestão de quotas através da CLI gcloud beta