Configure as dimensões das quotas do Google Cloud

As dimensões das quotas da nuvem representam diferentes formas de medir a utilização de recursos no Google Cloud. Normalmente, as dimensões são uma região,uma zona, Google Cloud um utilizador ou um atributo do produto.

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

Por exemplo, o Compute Engine mede a utilização de VMs através de diferentes dimensões. A dimensão regionmede o número de VMs que tem numa determinada região. O Compute Engine também tem várias dimensões de atributos de produtos, incluindo gpu_family. A dimensão gpu_family mede o número de GPUs de uma determinada família no seu projeto. Google Cloud

Ver dimensões

Pode ver as dimensões das quotas e dos limites do sistema na Google Cloud consola, através da CLI Google Cloud, da consulta da API REST ou das bibliotecas de cliente. Para ver dimensões para as quais não especificou um valor, use a CLI gcloud. Use também a CLI gcloud para ver as dimensões para quotas e limites do sistema que não têm dimensões regionais ou zonais se o seu projeto ainda não usar o recurso associado. Esta secção mostra como ver as dimensões através da consola e da CLI gcloud.

Consola

  1. Na Google Cloud consola, aceda à página IAM e administração > Quotas e limites do sistema:

    Aceda a Quotas e limites do sistema

    A tabela nesta página apresenta dimensões na coluna Dimensões.

  2. Se não vir a coluna Dimensões, siga estes passos. Caso contrário, ignore este passo.

    1. Clique em Opções de apresentação de colunas.
    2. Selecione Dimensões.
    3. Clique em OK. A coluna Dimensões é apresentada na tabela.

  3. Para filtrar os resultados, introduza um nome ou um valor da propriedade no campo junto a Filtrar.

    • Para filtrar por produto, comece a introduzir o nome do produto e selecione-o na lista apresentada.
    • Para filtrar por dimensão, introduza a dimensão no seguinte formato: dimension_name:dimension_value. Por exemplo, para ver as quotas e os limites do sistema definidos para a região us-central1, introduza: region:us-central.

Compreenda as dimensões em branco

Por vezes, a coluna Dimensões está vazia. Isto pode acontecer pelos seguintes motivos:

  • O valor da quota ou do limite do sistema é o valor predefinido e aplica-se a todas as dimensões. Para algumas quotas e limites do sistema, a consola mostra uma linha que indica o valor predefinido da quota ou do limite do sistema para referência. Uma vez que a predefinição se aplica a todos os valores das dimensões, a coluna Dimensões está em branco. Consulte a coluna Nome para identificar estas entradas. A coluna Nome indica estas entradas com a palavra "predefinição" entre parênteses no final do nome do limite do sistema ou da quota.

    Por exemplo, a quota SetIamPolicyRequestsPerMinutePerProject está definida na dimensão region. A consola mostra uma entrada de referência e uma entrada para cada região. Na coluna Nome, a entrada de referência é apresentada como "Pedidos SetIAMPolicy por minuto por região (predefinição)". Para esta entrada, a coluna Dimensões está vazia.

  • Não se aplicam dimensões. Por exemplo, a quota do Compute Engine não está associada a um atributo de região, zona ou produto, pelo que não existem dimensões a apresentar.NETWORKS-per-project

gcloud

Pode usar a CLI gcloud para ver as dimensões de uma única quota ou limite do sistema, ou de todas as quotas e limites do sistema associados a um determinado produto. A visualização de dimensões para uma única quota ou limite do sistema é normalmente mais rápida do que a visualização de dimensões para todas as quotas e limites do sistema associados a um produto. Normalmente, a resposta a uma consulta de uma única quota tem cerca de 200 linhas. A resposta a uma consulta de um produto pode exceder as 2000 linhas.

Veja dimensões para um único limite de sistema ou de quota com o gcloud

Para ver as dimensões de uma única quota ou limite do sistema através da CLI gcloud, execute o seguinte comando no terminal:

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

Substitua o seguinte:

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

    1. Encontre-o através da consola, conforme descrito em Encontre o seu ID de quota.
    2. Veja todas as dimensões do produto associado à quota ou ao limite do sistema no qual tem interesse. Este comando não requer o ID da quota. Consulte a secção Veja as dimensões de um produto com a CLI gcloud.

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

    1. Para encontrar o ID do projeto através da consola, consulte o artigo Identificar projetos.
    2. Se definir o seu projeto atual como o projeto predefinido na configuração da CLI gcloud, encontre o ID do projeto executando o seguinte comando gcloud no seu terminal: 
      gcloud config get-value project

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

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

Para ver as dimensões de uma única quota ou limite do sistema através da CLI gcloud, execute o seguinte comando no terminal:

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

Substitua o seguinte:

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

    1. Para encontrar o ID do projeto através da consola, consulte o artigo Identificar projetos.
    2. Se definir o seu projeto atual como o projeto predefinido na configuração da CLI gcloud, encontre o ID do projeto executando o seguinte comando gcloud no seu terminal: 
      gcloud config get-value project

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

Precedência das dimensões

Alguns exemplos de utilização da API Cloud Quotas têm configurações de dimensões complexas. As quotas podem ser configuradas a um nível mais detalhado do que apenas regiões e zonas. Pode alcançar esta granularidade quando usa dimensões específicas do serviço. Por exemplo, gpu_family e network_id são dimensões específicas do serviço no serviço Compute Engine. As dimensões são definidas por cada serviço individual e cada serviço pode ter um conjunto diferente de dimensões específicas do serviço.

Quando trabalha com dimensões de localização ou dimensões específicas do serviço, é aplicada a seguinte precedência:

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

  2. As configurações que especificam dimensões de localização têm precedência sobre as configurações que contêm apenas dimensões específicas do serviço.

Combinar dimensões

Numa configuração de preferência de quota, pode combinar dimensões das seguintes formas:

  1. A configuração pode conter dimensões de localização e dimensões específicas do serviço. Esta é a ordem de precedência mais elevada.

  2. A configuração só pode conter dimensões de localização. Esta configuração aplica-se a todas as dimensões específicas do serviço, exceto às que foram configuradas explicitamente com o método 1.

  3. A configuração só pode conter dimensões específicas do serviço. Esta configuração aplica-se a todas as localizações, exceto às configuradas explicitamente com o método 1 ou 2.

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

  5. Pode ter configurações sem dimensões. Estas configurações aplicam-se a todas as localizações e a todas as dimensões específicas do serviço, exceto às que foram configuradas explicitamente.