Entenda a cota, os valores e os limites do sistema

As cotas são definidas por um serviço do Google Cloud para especificar a quantidade de um recurso compartilhado e contável que pode ser usado. Os limites do sistema são valores fixos que não podem ser alterados.

O Google Cloud fornece ferramentas para que você possa monitorar o uso desses recursos, criar alertas e solicitar ajustes. As cotas do Cloud usam vários termos que você precisa conhecer.

A tabela a seguir lista a terminologia e as definições de cota.

Termo

Descrição

Ajustável

Um recurso que pode ter o valor ajustado de quota para cima ou para baixo.

Contabilizável

Um recurso que pode ser rastreado e, portanto, contado para o valor alocado pelo sistema de cotas.

Dimensão

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.

A API Cloud Cotas representa as dimensões como pares de chave-valor, em que a chave é o nome da dimensão, e o valor é o valor da dimensão nomeada, por exemplo, {"key" : "region", "value" : "us-central1"}.

Cota

A quantidade de um recurso contável e compartilhado que pode ser usado.

Ajuste de cota

Solicitação para aumentar ou diminuir um valor de cota. Os ajustes de aumento de cota estão sujeitos à aprovação e ao atendimento. Os ajustes de redução de cota são aprovados imediatamente.

Informações de cota

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. O recurso QuotaInfo contém:

  • Metadados, como nome e dimensão.
  • Valores de cota para diferentes dimensões de cota.
  • As cotas do Cloud recebem informações das cotas definidas pelos serviços do Google Cloud e dos ajustes de cota que você iniciar.

    Observação: como QuotaInfo é construído incorporando informações de fontes diferentes, existe uma configuração de cota padrão mesmo que você não tenha criado um recurso QuotaPreference. Até que você expresse um estado preferencial por quotaPreference.create ou quotaPreference.update, o QuotaInfo vai depender das informações de cota padrão disponíveis para determinar qual valor de cota será aplicado.

    Preferência de cota

    O recurso QuotaPreference representa sua preferência por uma determinada combinação de dimensões. Use este recurso para fazer ajustes de aumento de cota nas cotas dos projetos e diminuir as cotas nos projetos, pastas ou organizações. Os ajustes de aumento de cota estão sujeitos à aprovação e ao atendimento. As reduções de cota são realizadas imediatamente. Use a interface ou a API do console de cotas do Cloud para definir uma preferência de cota.

    Limite do sistema

    Um valor fixo, normalmente uma restrição de arquitetura. Os limites do sistema não podem ser ajustados.

    No entanto, alguns limites do sistema são contáveis e, nesses casos, as cotas do Cloud oferece ferramentas para que você possa monitorar seu uso em relação a esses valores e criar alertas.

    Tipo

    Um campo que indica um recurso como uma cota (ajustável) ou um limite do sistema (não ajustável). Algumas cotas podem não ser ajustáveis.

    Valor

    O máximo efetivo atual que foi aplicado a um limite contável ou limite do sistema. As cotas geralmente são ajustáveis, e você pode modificar o valor de uma cota por meio de ajustes manuais ou automatizados.

    Gerenciar cota

    A quantidade de um recurso compartilhado que você pode usar é específica para seu projeto e sua organização. Por exemplo, se você estiver usando uma conta de avaliação gratuita, talvez tenha cotas mais baixas para alguns recursos em comparação com uma conta faturada. Quando você ativa o faturamento no projeto, a cota aumenta para a maioria dos serviços. O uso do Google Cloud ao longo do tempo também aumenta as cotas para a maioria dos serviços.

    Algumas cotas são ilimitadas, ou seja, você pode usar esse recurso quanto quiser. Por outro lado, não é possível aumentar algumas cotas dos valores padrão. Por exemplo, quando o uso mais alto é contraprodutivo ou quando os recursos são muito limitados. Essas limitações geralmente são documentadas na página Cotas e limites do sistema relevante do serviço em questão. Por exemplo, a documentação sobre limites de taxa do Cloud Run functions.

    Fora desses casos extremos, os recursos compartilhados são definidos com um valor padrão suficiente para a maioria dos projetos. No entanto, se o projeto precisar de mais de um recurso específico do que o permitido pelos valores atuais, defina uma preferência de cota para um valor mais alto ou se quiser limitar ) um recurso, é possível definir uma preferência de cota para um valor menor. Para solicitar mais cota, consulte Como solicitar um valor de cota maior.

    Quando a cota acabar

    Normalmente, se você esgotar a cota, a tarefa que está tentando executar falhará e receberá um erro de cota. As tarefas que geram esse erro podem incluir a implantação de um aplicativo, a criação de um novo projeto ou a chamada de uma API. Depois disso, a tarefa continuará falhando até que você libere recursos (para cota de alocação), o período de tempo será redefinido (para cota de taxa) ou você receberá um aumento de cota.

    A forma como o erro de cota aparece depende da ferramenta ou do cliente que você usa para interagir com o Google Cloud. Veja os detalhes dos erros de cota em Erros de cota.

    Para evitar erros de cota, tente o seguinte:

    • Use o ajustador de cotas para criar automaticamente solicitações de aumento de cota antes de exceder a cota.
    • Criar um alerta quando estiver se aproximando do valor máximo da cota. Para mais informações, consulte Configure alertas de cota.

    Sobre os ajustes de cota

    A maioria das solicitações de aumento de cota é avaliada por sistemas automatizados. A decisão deles é baseada em critérios, incluindo a disponibilidade de recursos, o período em que você usou o Google Cloud e outros fatores. As solicitações que não atenderem a estes critérios serão negadas.

    Os critérios de avaliação para avaliações automáticas não são divulgados para garantir a imparcialidade de todos os clientes e evitar tentativas de manipulação do processo. Às vezes, as solicitações de aumento de cota são encaminhadas para revisores humanos, que também seguem critérios, mas podem considerar circunstâncias exclusivas.

    Talvez você precise pagar antecipadamente por alguns aumentos de cota. Por exemplo, pode ser necessário fazer um pagamento se você solicitar mais projetos que usarão serviços pagos do Google Cloud. O pagamento pode ser aplicado a todas as cobranças que você gerar no futuro e será visível como um crédito na sua conta.

    Para saber como solicitar mais cota, consulte Como solicitar um valor de cota maior. Você não precisa ter um serviço pago de atendimento ao cliente para solicitar um aumento de cota. As solicitações de aumento de cota geralmente são concluídas de dois a três dias úteis. Quando sua solicitação é recebida, um e-mail é enviado e você pode respondê-lo. Use esse recurso se você tiver dúvidas ou quiser fornecer mais informações sobre sua solicitação (por exemplo, se a solicitação de aumento for urgente). Após o processamento da solicitação, você receberá outro e-mail notificando se o aumento da cota foi aprovado ou negado. O e-mail informará a data efetiva do aumento, se aplicável.