Sobre cotas

O gateway de API oferece cotas que permitem controlar a taxa em que os aplicativos podem chamar sua API. Ao definir uma cota, você especifica limites de uso para proteger a API contra um número excessivo de solicitações de aplicativos de chamada. Essas solicitações em excesso podem ser causadas por um simples erro de digitação ou por um sistema projetado incorretamente que faz chamadas desnecessárias para sua API.

Seja qual for a causa, bloquear o tráfego de uma fonte específica assim que ele atinge um limite é necessário para garantir a integridade geral da API. Ao definir uma cota, você impede que um aplicativo específico afete negativamente todos os outros aplicativos que usam a API.

As cotas se aplicam a toda a API

Você define métricas e limites de cota em uma configuração de API, mas o gateway de API os aplica à API que possui a configuração, não apenas a ela. Sempre que você cria uma configuração de API, as métricas e os limites declarados substituem os declarados pelas configurações anteriores da API. Somente as métricas e os limites da configuração de API criada mais recentemente são aplicados.

Isso tem duas consequências quando uma API tem mais de uma configuração implantada:

  • A mudança do valor de um limite o altera para todos os gateways da API, incluindo aqueles que atendem a uma configuração anterior.

  • A renomeação ou remoção de uma métrica deixa uma configuração de cota inválida em qualquer gateway que ainda atenda a uma configuração de API anterior. As solicitações para os métodos aplicados à cota desses gateways falham com um erro HTTP 500 e a mensagem Failed to call Service Control Quota.

Para encontrar e corrigir uma configuração de cota inválida, consulte A solicitação de API retorna um erro HTTP 500 para um método aplicado à cota.