Configurar as dimensões do Cloud Quotas

As dimensões do Cloud Quotas representam maneiras diferentes de medir recursos no Google Cloud. As dimensões geralmente são um atributo de região, zona, usuário do Google Cloud ou produto.

A API Cloud Cotas representa as dimensões como pares de chave-valor. key é o nome da dimensão (por exemplo, region). value é o valor atribuído para a dimensão (por exemplo, uma região como us-central1).

Por exemplo, o Compute Engine mede o uso da VM usando dimensões diferentes. A dimensão region mede o número de VMs que você tem em uma determinada região. O Compute Engine também tem várias dimensões de atributo do produto, incluindo gpu_family. A dimensão gpu_family mede o número de GPUs de uma determinada família no seu projeto do Google Cloud.

Abrir dimensões

É possível conferir as dimensões de cotas e limites do sistema no console do Google Cloud, usando a CLI do Google Cloud, consultando a API REST ou bibliotecas de cliente. Para conferir dimensões para as quais você não especificou um valor, use a gcloud CLI. Use também a gcloud CLI para conferir as dimensões de cotas e limites do sistema que não têm dimensões regionais ou zonais se o projeto ainda não usa o recurso associado. Esta seção mostra como visualizar dimensões usando o console e a gcloud CLI.

Console

  1. Acesse a página Cotas e limites do sistema:

    Acesse "Cotas e limites do sistema

    A tabela mostra as dimensões na coluna Dimensões.

  2. Se a coluna Dimensões não aparecer, siga estas etapas. Caso contrário, pule esta etapa.

    1. Clique em Opções de exibição de coluna.
    2. Selecione Dimensões.
    3. Clique em OK. A coluna Dimensões aparece na tabela.

  3. Para filtrar os resultados, insira um nome ou valor de propriedade no campo ao lado de Filtro.

    • Para filtrar por produto, comece a digitar o nome do produto e selecione na lista que aparece.
    • Para filtrar por dimensão, insira a dimensão usando o seguinte formato: dimension_name:dimension_value. Por exemplo, para conferir as cotas e os limites do sistema definidos para a região us-central1, digite: region:us-central.

Entender as dimensões em branco

Às vezes, a coluna Dimensões fica vazia. Isso pode acontecer pelos seguintes motivos:

  • O valor da cota ou do limite do sistema é o valor padrão e é aplicado a todas as dimensões. Para algumas cotas e limites do sistema, o console mostra uma linha que lista o valor padrão da cota ou do limite do sistema para referência. Como o padrão se aplica a todos os valores de dimensão, a coluna Dimensões fica em branco. Observe a coluna Nome para identificar essas entradas. A coluna Name indica essas entradas com a palavra "default" entre parênteses no final do nome da cota ou do limite do sistema.

    Por exemplo, a cota SetIamPolicyRequestsPerMinutePerProject é definida na dimensão region. O console mostra uma entrada de referência e uma entrada para cada região. Na coluna Nome, a entrada de referência é listada como "Solicitações de SetIAMPolicy por minuto e região (padrão)". Para essa entrada, a coluna Dimensões está vazia.

  • Nenhuma dimensão é aplicável. Por exemplo, a cota do Compute Engine NETWORKS-per-project não está associada a um atributo de região, zona ou produto. Portanto, não há dimensões para exibir.

gcloud

É possível usar a gcloud CLI para conferir as dimensões de uma única cota ou limite do sistema ou de todas as cotas e limites do sistema associados a um determinado produto. A visualização de dimensões de uma única cota ou limite do sistema geralmente é mais rápida do que a visualização de dimensões de todas as cotas e limites do sistema associados a um produto. A resposta a uma consulta para uma única cota geralmente tem cerca de 200 linhas. A resposta a uma consulta de um produto pode exceder 2.000 linhas.

Conferir dimensões de uma única cota ou limite do sistema com o gcloud

Para conferir as dimensões de uma única cota ou limite do sistema usando a gcloud CLI, execute o seguinte comando no terminal:

gcloud alpha quotas info describe QUOTA_ID --project=PROJECT_ID --service=SERVICE_ID

Substitua:

  • QUOTA_ID: o ID da cota ou do limite do sistema. Se você não souber o ID da cota, escolha uma das seguintes opções:

    1. Encontre o ID usando o console, conforme descrito em Encontrar o ID da cota.
    2. Confira todas as dimensões do produto associado à cota ou ao limite do sistema em que você tem interesse. Esse comando não requer o ID da cota. Consulte a seção Conferir as dimensões de um produto com a gcloud CLI.

  • PROJECT_ID: o ID de seu projeto do Google Cloud. Para encontrar o ID do projeto, escolha uma das seguintes opções:

    1. Para encontrar o ID do projeto usando o console, consulte Como identificar projetos.
    2. Se você definiu o projeto atual como padrão na configuração da gcloud CLI, encontre o ID do projeto executando o seguinte comando do gcloud no terminal: 
      gcloud config get-value project

  • SERVICE_ID: o ID do serviço do produto associado à cota ou ao limite do sistema. Por exemplo, se a cota for para CPUs A2 do Compute Engine, o ID do serviço será compute.googleapis.com.

Conferir as dimensões de um produto com a CLI gcloud

Para conferir as dimensões de uma única cota ou limite do sistema usando a gcloud CLI, execute o seguinte comando no terminal:

gcloud alpha quotas info list --project=PROJECT_ID --service=SERVICE_ID

Substitua:

  • PROJECT_ID: o ID de seu projeto do Google Cloud. Para encontrar o ID do projeto, escolha uma das seguintes opções:

    1. Para encontrar o ID do projeto usando o console, consulte Como identificar projetos.
    2. Se você definiu o projeto atual como padrão na configuração da gcloud CLI, encontre o ID do projeto executando o seguinte comando do gcloud no terminal: 
      gcloud config get-value project

  • SERVICE_ID: o ID do serviço do produto associado à cota ou ao limite do sistema. Por exemplo, se a cota for para CPUs A2 do Compute Engine, o ID do serviço será compute.googleapis.com.

Precedência da dimensão

Alguns casos de uso da API Cloud Cotas têm configurações de dimensão complexas. As cotas podem ser configuradas em um nível mais granular que apenas regiões e zonas. Você pode conseguir essa granularidade ao usar dimensões específicas do serviço. Por exemplo, gpu_family e network_id são dimensões específicas do serviço no Compute Engine. As dimensões são definidas por serviço individual, e cada serviço pode ter um conjunto diferente de dimensões específicas.

Ao trabalhar com dimensões de local ou dimensões específicas do serviço, a seguinte precedência é aplicada:

  1. Uma configuração de preferência de cota com todas as dimensões específicas de local e serviço especificadas tem precedência sobre qualquer outra configuração.

  2. As configurações que especificam dimensões de local só têm precedência sobre aquelas que contêm apenas dimensões específicas do serviço.

Combinar dimensões

Em uma configuração de preferência de cota, é possível combinar dimensões das seguintes maneiras:

  1. A configuração pode conter ambas as dimensões de local e as específicas do serviço. Essa é a ordem de precedência mais alta.

  2. A configuração somente pode conter dimensões de local. Essa configuração se aplica a todas as dimensões específicas de serviços, exceto as explicitamente configuradas com o método 1.

  3. A configuração pode conter apenas dimensões específicas de serviços. Essa configuração se aplica a todos os locais, exceto aqueles explicitamente configurados com os métodos 1 ou 2.

  4. Se a configuração contiver alguma dimensão específica de serviço, ela precisará conter todas as dimensões específicas do serviço.

  5. Você pode ter configurações sem dimensões. Essas configurações se aplicam a todos os locais e a todas as dimensões específicas do serviço, exceto as configuradas explicitamente.