Limites de taxa de API

Os limites de taxa de API definem o número de solicitações que podem ser feitas para a API Compute Engine. As limitações de taxa de API são aplicadas por projeto. Ao usar gcloud compute ou o Console do Google Cloud, você também está fazendo solicitações à API. Essas solicitações são contabilizadas na limitação de taxa de API. Se você usar as contas de serviço para acessar a API, isso também será contabilizado no limite de taxa.

Os limites de taxa são aplicados e recarregados automaticamente a intervalos de 100 segundos. Por exemplo, uma limitação de taxa de 20 solicitações/segundo seria convertida para 2.000 solicitações em 100 segundos. Isso significa que, se você atingir um limite específico a qualquer momento dentro de 100 segundos, precisará aguardar até que seu bucket de cota seja atualizado para fazer mais solicitações. Se você exceder a limitação de taxa de um intervalo, receberá um erro 403 com a mensagem de erro rateLimitExceeded. Para resolver esse erro, aguarde um minuto e tente sua solicitação novamente. A solicitação provavelmente terá sucesso depois desse período.

Atualmente, os projetos são limitados às categorias de limitação de taxa da API a seguir. Cada categoria de limite é contada separadamente. Dessa maneira, você atinge o limite máximo em cada categoria simultaneamente.

  • Consultas: limites padrão para qualquer método não listado:
    • Taxa por projeto: 20 solicitações/segundo
    • Taxa por usuário: 20 solicitações/segundo
  • Solicitações de leitura: limites para os métodos *.get:
    • Taxa por projeto: 20 solicitações/segundo
    • Taxa por usuário: 20 solicitações/segundo
  • Solicitações de listagem: limites para os métodos *.list:
    • Taxa por projeto: 20 solicitações/segundo
    • Taxa por usuário: 20 solicitações/segundo
  • Solicitações de leitura de operações: limites para os métodos globalOperations.get, globalOrganizationOperations.get, regionOperations.get e zonalOperations.get:
    • Taxa por projeto: 20 solicitações/segundo
    • Taxa por usuário: 20 solicitações/segundo
  • Solicitações de leitura pesadas: limites para os métodos *.aggregatedList:
    • Taxa por projeto: 10 solicitações/segundo
    • Taxa por usuário: 10 solicitações/segundo
  • Solicitações de mutação pesadas: limites para os métodos patch, delete e insert dos recursos interconnects e interconnectAttachments:
    • Taxa por projeto: 10 solicitações/segundo
    • Taxa por usuário: 10 solicitações/segundo
  • Solicitações SimulateMaintenanceEvent de instâncias: limites para os métodos *.simulateMaintenanceEvent:
    • Taxa por projeto: 2 solicitações/segundo
    • Taxa por usuário: 2 solicitações/segundo
    • Taxa diária por projeto: 30 solicitações/dia
  • Solicitações de inserção de licença: limites para o método licenses.insert:
    • Taxa por projeto: 2 solicitações/segundo
    • Taxa por usuário: 2 solicitações/segundo
  • Solicitações globais de mutação de recursos - Limites para métodos disks.createSnapshot, snapshots.delete, snapshots.setLabels, images.insert, images.delete, images.deprecate, images.setLabels, machineImages.insert e machineImages.delete:
    • Taxa por projeto: 5 solicitações/segundo
    • Taxa por usuário: 5 solicitações/segundo
  • Solicitações comuns de metadados de instância do conjunto de projetos - Limites para o método projects.setCommonInstanceMetadata:
    • Taxa por projeto: 0,5 solicitações/segundo
    • Taxa por usuário: 0,5 solicitações/segundo

Siga as práticas recomendadas da API Compute Engine para preservar os limites de taxa da API para reduzir os efeitos das limitações de taxa da API.

Se você precisar de uma limitação de taxa mais alta para as solicitações de API, analise o uso atual e solicite um aumento na página de cotas da API Compute Engine no Console do Google Cloud. Saiba mais sobre cotas.