Cotas

Neste documento, listamos as cotas e limites que se aplicam ao App Engine.

Uma cota restringe quanto de um determinado recurso compartilhado do Google Cloud o projeto do Cloud pode usar, incluindo hardware, software e componentes de rede.

As cotas fazem parte de um sistema que:

• monitora o uso ou o consumo de produtos e serviços do Google Cloud;
• restringe o consumo desses recursos por motivos que incluem garantir a equidade e a redução dos picos de uso;
• mantém as configurações que aplicam automaticamente restrições prescritas;
• fornece maneiras de fazer ou solicitar alterações na cota.

Quando uma cota é excedida, na maioria dos casos, o sistema bloqueia imediatamente o acesso ao respectivo recurso do Google, e a tarefa que você está tentando executar falha. Na maioria dos casos, as cotas se aplicam a todos os projetos do Cloud. Além disso, elas são compartilhadas entre todos os aplicativos e endereços IP que usam esse projeto.

Também há limites para os recursos do App Engine. Esses limites não estão relacionados ao sistema de cotas. Não é possível mudar os limites, a menos que seja indicado de outra forma.

Um aplicativo do App Engine pode consumir recursos até determinadas cotas. É possível ver o consumo diário do seu aplicativo na página "Detalhes da cota" do console do Google Cloud.

Tipos de cotas

Os seguintes tipos de cotas são válidos para aplicativos do App Engine:

• Cotas gratuitas fornecem ao aplicativo uma quantidade gratuita de cada recurso. Depois que o aplicativo ultrapassar a cota gratuita, você receberá a cobrança por todo o uso extra desse recurso.

  Apenas o ambiente padrão do App Engine oferece cotas gratuitas.

• As cotas diárias protegem a integridade do sistema do App Engine, garantindo que nenhum aplicativo consuma demais um recurso em detrimento de outros apps. Se você ultrapassar esses limites, um erro será exibido. As cotas diárias são atualizadas diariamente à meia-noite do horário do Pacífico.
• As cotas por minuto protegem o aplicativo de consumir todos os recursos em períodos muito curtos e evitam que outros apps monopolizem um determinado recurso. Se o aplicativo consumir um recurso rápido demais e esgotar a cota por minuto, a palavra "Limitado" será exibida ao lado da cota correspondente na página Cotas do console do Google Cloud. As solicitações dos recursos que atingirem o máximo por minuto serão negadas.

Proprietários do projeto e administradores de faturamento podem ativar o faturamento de um projeto.

Quando você ativa o faturamento do aplicativo, os limites de segurança dele aumentam. Consulte a seção Recursos para detalhes.

Para detalhes sobre o que acontece quando uma cota é excedida e como lidar com as condições de excesso de cota, consulte Quando um recurso está esgotado.

Dica: as cotas máximas por minuto acomodam altos níveis de tráfego para lidar com um aumento no tráfego do seu site se ele for mencionado em algum conteúdo. Se você acredita que determinada cota não atende a esse requisito, envie feedback no rastreador de problemas. Enviar feedback não é uma solicitação para aumentar sua cota, mas isso nos ajudará a entender qual cota será possivelmente muito baixa para os casos de uso geral.

Se você espera níveis muito altos de tráfego, ou seu aplicativo exige cotas particularmente elevadas, por exemplo, devido ao lançamento de produtos significativos ou testes de carga grandes, é recomendado se inscrever em um pacote de suporte.

Como os recursos são renovados

O App Engine rastreia o uso dos recursos de seu aplicativo em comparação às cotas do sistema. O App Engine redefine todas as medições de recursos no início de cada dia (exceto para dados armazenados, que sempre representam a quantidade de armazenamento de dados em uso).

As cotas diárias são renovadas diariamente à meia-noite do horário do Pacífico. As cotas por minuto são atualizadas a cada 60 segundos.

Quando um recurso está esgotado

Quando todo o recurso alocado é consumido por um aplicativo, ele fica indisponível até que a cota seja renovada. Isso significa que o aplicativo não funcionará até que a cota seja renovada.

Quando os recursos necessários para iniciar uma solicitação se esgotarem, o App Engine retornará por padrão um código de erro HTTP 403 ou 503 para a solicitação em vez de chamar um gerenciador. Esse comportamento é válido para o recurso instância/horas.

Dica: configure o aplicativo para que ele exiba uma página de erro personalizada ao exceder uma cota. Para mais detalhes, consulte a referência do arquivo de configuração para Python (2.7, 3), Java, Go, PHP (5.5, 7) ou Node.js .

Quando qualquer outro recurso está esgotado, uma tentativa de consumi-lo no aplicativo resulta em uma exceção. Essa exceção pode ser capturada pelo aplicativo e processada, por exemplo, com a exibição de uma mensagem de erro amigável para o usuário. Na API Python, essa exceção é apiproxy_errors.OverQuotaError. Na API para Java, essa exceção é com.google.apphosting.api.ApiProxy.OverQuotaException. Na API Go, a função appengine.IsOverQuota informa se um erro representa uma falha na chamada da API, devido à insuficiência de uma cota disponível.

O exemplo a seguir ilustra como detectar o erro OverQuotaError, que pode ser gerado pelo método SendMessage() se uma cota relacionada a e-mails tiver sido excedida:

try:
    mail.SendMessage(to='test@example.com', from='admin@example.com',
            subject='Test Email', body='Testing')
except apiproxy_errors.OverQuotaError, message:
    # Log the error. logging.error(message)
    # Display an informative message to the user.
    self.response.out.write('The email could not be sent. '
            'Please try again later.')

Seu aplicativo está ultrapassando os limites padrão? Se você precisar de uma cota de e-mails maior, use o SendGrid para enviar e-mails. Para qualquer outro aumento de cota, se você tiver um pacote de suporte Silver, Gold ou Platinum, entre em contato com um representante para solicitar limites maiores de capacidade.

Cotas para o ambiente flexível do App Engine

Quando você implanta um aplicativo no ambiente flexível do App Engine, alguns recursos do Google Cloud são consumidos. Talvez não seja possível modificá-los, mas eles contam para a cota.

Recursos

Um aplicativo pode usar os recursos a seguir, sujeitos às cotas. Os recursos medidos em comparação com os limites faturáveis são indicados com "(faturável)". A quantidade de recursos representa uma alocação em um período de 24 horas.

O custo dos recursos extras está listado na página Preços.

Bucket padrão do Cloud Storage

O bucket padrão do Cloud Storage tem uma cota grátis para uso diário, conforme mostrado abaixo. Você cria esse bucket padrão sem custos na página App Engine do console do Google Cloud de seu projeto.

As cotas a seguir aplicam-se especificamente ao uso do bucket padrão. Consulte os preços dos buckets multirregionais do Cloud Storage para uma descrição dessas cotas.

Blobstore

As cotas a seguir se aplicam especificamente ao uso do Blobstore.

Dados armazenados no Blobstore

A quantidade total de dados armazenados no Blobstore. Disponível para aplicativos pagos e gratuitos.

Armazenamento de dados estáticos e códigos

Limite de dados estáticos

Em todas as linguagens, exceto em Go, nenhum arquivo de dados estático pode ser maior do que 32 MB. O limite em Go é de 64 MB.

Armazenamento total

A cota de armazenamento se aplica à quantidade total de códigos e dados estáticos armazenados por todas as versões do aplicativo. O tamanho total armazenado de códigos e arquivos estáticos está listado na tabela "Painel principal". Os tamanhos individuais são exibidos nas telas "Versões" e "Back-ends", respectivamente. Nos aplicativos, serão cobrados US$ 0,026 por GB ao mês para qualquer armazenamento de dados estáticos e códigos que ultrapasse 1 GB.

Firestore no modo Datastore (Datastore)

A cota de dados armazenados (faturável) refere-se a todos os dados armazenados para o aplicativo no Datastore e Blobstore. Outras cotas na seção "Datastore" da tela Detalhes da cota no console do Google Cloud se referem especificamente ao serviço do Datastore.

Dados armazenados (faturáveis)

A quantidade total de dados armazenados em entidades de armazenamento de dados e índices e no Blobstore.

É importante observar que os dados armazenados no armazenamento de dados podem causar uma sobrecarga significativa. Essa sobrecarga depende do número e dos tipos de propriedades associadas, e inclui o espaço usado pelos índices incorporados e personalizados. Cada entidade armazenada no armazenamento de dados exige os metadados a seguir:

• A chave da entidade, incluindo o tipo, o ID ou o nome da chave, e as chaves dos ancestrais da entidade.
• O nome e o valor de cada propriedade. Como o armazenamento de dados não tem esquema, o nome de cada propriedade precisa ser armazenado com o valor da propriedade de qualquer entidade fornecida.
• As linhas de índice incorporado e personalizado que se referem a essa entidade. Cada linha contém o tipo de entidade, o número de valores da propriedade dependendo da definição do índice e a chave da entidade.

Número de índices

O número de índices atuais do Datastore no aplicativo. Inclui índices criados no passado e que não aparecem mais na configuração do aplicativo, mas não foram excluídos. Consulte a página "Limites de armazenamento de dados" para mais detalhes sobre limites.

Operações de gravação

O número total de operações de gravação do Datastore.

Operações de leitura

O número total de operações de leitura do Datastore.

Operações pequenas

O número total de operações pequenas do Datastore. Operações pequenas incluem chamadas para alocar IDs do Datastore ou consultas somente para chaves.

Observação: as operações do Datastore, geradas pelo Administrador do Datastore e pelo Leitor do Datastore , são contabilizadas na cota do aplicativo.

Implantações

Em cada aplicativo do App Engine, é possível implantar até 10.000 vezes por dia.

A cada implantação, o Cloud Build cria uma imagem de contêiner que é armazenada no Container Registry. Você receberá cobrança se o espaço de armazenamento total consumido pelas imagens exceder o nível gratuito.

Arquivos

A cota a seguir se aplica ao número total de arquivos de implantação do app.

Instância/hora

O uso da instância é cobrado pelo tempo de atividade da instância, a uma determinada taxa por hora.

Há cotas gratuitas separadas para as classes de instâncias "F" e "B", também conhecidas como classes de instâncias de "front-end" e "back-end". Quando você usa os Serviços do App Engine, a classe da instância do serviço determina qual cota é aplicada.

A contagem de instância/hora começa quando a instância é iniciada e termina como descrito abaixo, dependendo do tipo de escalonamento especificado para a instância:

• Escalonamento básico ou automático: a contagem acaba 15 minutos depois que a instância finaliza o processamento da última solicitação.
• Escalonamento manual: a contagem acaba quinze minutos depois que a instância é desligada.

Se o número de instâncias inativas criadas pelo App Engine ultrapassar o máximo especificado na guia "Configurações de desempenho" do console do Google Cloud, as instâncias excedentes não serão contabilizadas no cálculo de instância/hora.

Registros

A API Logs é medida quando os dados do registro são recuperados.

A cota de ingestão de registros se refere a registros de solicitação e dados de registros de um aplicativo. A geração de registros para aplicativos do App Engine é fornecida pelo pacote de operações do Google Cloud. Consulte Preços do Pacote de operações do Google Cloud para mais informações sobre taxas e limites.

E-mail

No App Engine, a conta para uso de e-mail é "por mensagem", contando cada e-mail para cada destinatário. Por exemplo, enviar um e-mail para dez destinatários conta como 10 mensagens.

Mensagens enviadas

O número total de mensagens enviadas pelo aplicativo. Observe que a cota máxima de mensagens enviadas permanece em níveis gratuitos até a primeira cobrança para o aplicativo ser liberada.

Mensagens enviadas ao administrador

O número total de mensagens aos administradores do aplicativo enviadas pelo aplicativo. O limite de tamanho total para cada e-mail de administrador, incluindo cabeçalhos, anexos e corpo, é de 16 KB.

Dados de corpo da mensagem enviados

A quantidade de dados enviados no corpo de mensagens de e-mail.

Anexos enviados

O número total de anexos enviados com mensagens de e-mail.

Dados de anexos enviados

A quantidade de dados enviados como anexos de mensagens de e-mail.

É possível adicionar até 50 remetentes autorizados para a API Mail.

Como enviar e-mails acima da cota diária

Se o aplicativo precisar de cotas mais altas para enviar e-mails, será possível usar um provedor de e-mail de terceiros, como SendGrid, Mailjet ou Mailgun.

Pedidos

Largura de banda de saída (faturável)

A quantidade de dados enviada pelo aplicativo em resposta a solicitações.

Isso inclui:

• dados exibidos em resposta a solicitações seguras e não seguras por servidores de aplicativos, servidores de arquivos estáticos ou pelo Blobstore;
• dados enviados em mensagens de e-mail;
• dados em solicitações HTTP de saída enviadas pelo serviço de busca de URL.

Largura de banda de entrada

A quantidade de dados recebidos pelo aplicativo oriundos de solicitações. Cada solicitação HTTP de entrada pode ter no máximo 32 MB.

Isso inclui:

• dados recebidos pelo aplicativo em solicitações seguras e não seguras;
• uploads para o Blobstore;
• dados recebidos em resposta a solicitações HTTP pelo serviço de busca de URL.

Largura de banda de saída segura

A quantidade de dados enviados pelo aplicativo por uma conexão segura em resposta a solicitações.

Largura de banda de entrada segura

A quantidade de dados recebidos pelo aplicativo por meio de uma conexão segura proveniente de solicitações.

Pesquisa

Cotas gratuitas para Pesquisa estão listadas na tabela abaixo. Para ver a descrição detalhada de cada tipo de chamada de pesquisa, consulte a documentação de Java, Python e Go.

Recursos da API Search são cobrados de acordo com as taxas na tabela de preços.

A seção de cota do console do aplicativo exibe uma contagem bruta de solicitações da API. Observe que, ao indexar vários documentos em uma única chamada, a contagem de chamadas é aumentada pela quantidade de documentos.

A API Search impõe estes limites para garantir a confiabilidade do serviço:

• 100 minutos agregados de tempo de execução da consulta por minuto, dentro de um app e um índice.
• 15.000 documentos adicionados/excluídos por minuto.

Observação: esses limites são aplicados por minuto, mas o console do Google Cloud exibe os totais diários de cada um. Os clientes com suporte Silver, Gold ou Platinum podem solicitar limites de taxa de capacidade maiores. Basta entrar em contato com o representante do suporte.

Fila de tarefas

Chamadas para a API Task Queue

O número total de vezes que o aplicativo chamou a API Task Queue para enfileirar uma tarefa.

Contagem de tarefas armazenadas na fila de tarefas

O número total de tarefas que o aplicativo enfileirou que ainda não foram executadas.

Bytes de tarefas armazenadas na fila de tarefas

Os bytes consumidos por tarefas que o aplicativo enfileirou e ainda não foram executadas.

Quando uma tarefa é executada, os pedidos associados contam para as cotas de solicitação do aplicativo

Esses limites se aplicam a todas as filas de tarefas:

Observação: depois que uma tarefa é executada ou excluída, o armazenamento usado é liberado. A cota de armazenamento é atualizada em intervalos regulares e pode não mostrar o espaço recuperado imediatamente. É possível configurar o limite de bytes de tarefas armazenadas ajustando a configuração da fila. Para mais detalhes, consulte a documentação de Python, Java, Go ou PHP.

Os limites a seguir aplicam-se às filas de tarefas de acordo com o tipo:

Cron

As seguintes cotas são aplicadas aos cron jobs.

Cron jobs

Número de cron jobs.

Busca de URL

Chamadas de API da busca de URL

O número total de vezes que o aplicativo acessou o serviço de busca de URL para executar uma solicitação HTTP ou HTTPS.

Dados de busca de URL enviados

A quantidade de dados enviados ao serviço de busca de URL nas solicitações.

Dados de busca de URL recebidos

A quantidade de dados recebidos do serviço de busca de URL nas respostas. Isto também é computado na cota de Largura de banda de entrada.