Você está lendo a documentação do Apigee Edge.
Acesse a documentação da
Apigee X. info
A política de cotas é usada para contar o número de solicitações recebidas por um proxy de API. Esse recurso permite que os provedores de APIs apliquem limites ao número de chamadas de API feitas por apps em um intervalo de tempo.
A política de cota pode incluir um elemento
identifier que identifica o "bucket" de cota em que cada solicitação é contada.
Antipadrão
Ao usar a política de cota, não use identificadores de alta cardinalidade.
A cardinalidade se refere ao número de valores de dados exclusivos em um conjunto. Um identificador com alta cardinalidade tem um grande número de valores distintos possíveis. Identificadores de alta cardinalidade incluem IDs de solicitação ou de sessão exclusivos que mudam a cada chamada de API.
O uso de identificadores de alta cardinalidade pode prejudicar significativamente a eficácia da aplicação de cotas.
Impacto
Usar identificadores de alta cardinalidade no elemento identificador da política de cota causa:
- Aplicação de cota ineficaz:cada identificador exclusivo é tratado como um contador separado. Se cada solicitação tiver um ID novo e exclusivo, o sistema de cotas criará um novo "bucket" para cada chamada de API. Isso significa que seu limite geral de cota é medido em relação a contadores individuais de uso único, em vez de grupos reais de solicitações que você quer limitar, tornando a política inútil para controle de tráfego.
- Aumento do consumo de recursos:gerar e gerenciar um grande número de contadores de cota exclusivos coloca uma pressão desnecessária na plataforma Apigee, levando a um aumento no uso de recursos e possíveis problemas de desempenho.
- Desafios de monitoramento:fica difícil monitorar e entender as tendências reais de consumo de API quando os dados estão fragmentados em um grande número de identificadores exclusivos. Você não poderá mais saber quais aplicativos, desenvolvedores ou produtos estão consumindo seus recursos de API.
Prática recomendada
Escolha identificadores com cardinalidade baixa a média que também representem um agrupamento estável e significativo para a aplicação de cotas. Elas ajudam você a gerenciar o uso da API de forma eficaz e receber insights sobre seu tráfego. Por exemplo:
- developer.app.name
- client_id
- apiproduct.name
Com identificadores adequados, sua política de cota pode gerenciar o tráfego de API com mais eficiência, evitar excedentes não intencionais e fornecer insights claros sobre padrões de uso.