O Cloud Endpoints fornece quotas que lhe permitem controlar a taxa à qual as aplicações podem chamar a sua API. A definição de uma quota permite-lhe especificar limites de utilização para proteger a sua API de um número excessivo de pedidos de aplicações de chamadas. Os pedidos excessivos podem ter sido causados por um simples erro de digitação ou por um sistema concebido de forma ineficiente que faz chamadas desnecessárias à sua API. Independentemente da causa, o bloqueio do tráfego de uma origem assim que atinge um determinado nível é necessário para a integridade geral da sua API. Ao definir uma quota, garante que uma aplicação não pode afetar negativamente outras aplicações que usam a sua API.
Esta página oferece uma vista geral da funcionalidade principal fornecida pelas quotas.
Os pedidos estão associados ao projeto do consumidor
Depois de configurar uma quota, o Endpoints acompanha o número de pedidos por minuto por projeto do consumidor Google Cloud . Cada aplicação que chama a sua API tem de:
- Ter um projeto do Google Cloud .
- Ativou a API no respetivo Google Cloud projeto.
- Envie uma chave da API. com cada pedido à sua API. Isto permite que os Endpoints identifiquem o projeto ao qual a aplicação de chamada está associada e incrementem o contador de pedidos para o projeto Google Cloud .Google Cloud
Para obter informações sobre como configurar uma chave da API, consulte o seguinte:
- Java: restringir o acesso à API com chaves da API
- Python: restringir o acesso à API com chaves da API
Pode fazer com que os consumidores da API criem os seus próprios projetos naGoogle Cloud consola ou pode criar os projetos por eles. Uma vez que os Endpoints aplicam quotas por projeto, tem de ter um projeto para cada consumidor da API.
Limite o número de pedidos por minuto
Ao definir uma quota, pode limitar o número de pedidos por minuto a toda a API ou apenas a métodos específicos. Se o código do cliente de um projeto de consumidor exceder o limite que configurou, o pedido é rejeitado antes de chegar à sua API, e é devolvido um código de estado HTTP de 429 too many
requests. As aplicações de chamadas têm de processar o código de estado 429 e usar o recuo exponencial ou outra lógica de repetição para diminuir a taxa de chamadas para a sua API.
Configure uma ou mais quotas
Pode configurar uma ou mais quotas com nome e especificar um limite de taxa diferente para cada quota. Por exemplo, pode ter alguns métodos na sua API que exigem muitos recursos (como um método que executa uma consulta complexa e devolve uma grande lista de resultados) e outros métodos que são rápidos e leves. Pode querer configurar duas quotas com limites de taxa diferentes e associar os métodos com utilização intensiva de recursos a uma quota e os métodos simples à outra quota.
Configure um custo
Quando associa um método a uma quota, especifica sempre um custo para o pedido. Isto permite que diferentes métodos consumam a mesma quota a taxas diferentes. Pode usar os custos como alternativa à configuração de diferentes quotas. Por exemplo, suponha que configura uma quota com um limite de 1000 pedidos por minuto. Para os métodos simples, configura um custo de 1, o que significa que os clientes podem chamar os métodos simples 1000 vezes por minuto. Para os métodos com utilização intensiva de recursos, configura um custo de 2, o que significa que, sempre que o cliente chama o método, o contador de pedidos é incrementado em 2, até atingir o limite de 1000. Na prática, isto limita os métodos que consomem muitos recursos a 500 pedidos por minuto.
Substitua a quota configurada
A página Endpoints > Serviços apresenta a quota configurada para cada método na sua API. Se necessário, pode substituir o limite configurado para um projeto de consumidor específico. Para definir uma substituição, tem de introduzir o número do projeto de consumidor na página Endpoints > Serviços. Se não tiver acesso ao projeto de consumidor que quer substituir, tem de contactar alguém que tenha acesso para obter o número do projeto.