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
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.
Se a coluna Dimensões não aparecer, siga estas etapas. Caso contrário, pule esta etapa.
- Clique em Opções de exibição de coluna.
- Selecione Dimensões.
- Clique em OK. A coluna Dimensões aparece na tabela.
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ãoregion
. 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:- Encontre o ID usando o console, conforme descrito em Encontrar o ID da cota.
- 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:- Para encontrar o ID do projeto usando o console, consulte Como identificar projetos.
- 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:- Para encontrar o ID do projeto usando o console, consulte Como identificar projetos.
- 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:
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.
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:
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.
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.
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.
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.
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.