Simultaneidade de limite
APLICA-SE A: todas as camadas do Gerenciamento de API
A política limit-concurrency impede que políticas fechadas sejam executadas por mais do que o número especificado de solicitações a qualquer momento. Ao exceder esse número, novos pedidos falharão imediatamente com o código de status 429 Número excessivo de solicitações.
Cuidado
Devido à natureza distribuída da arquitetura de limitação, a limitação de taxa nunca é completamente precisa. A diferença entre o número configurado e o número real de solicitações permitidas varia de acordo com o volume e a taxa de solicitação, a latência de back-end e outros fatores.
Observação
Defina os elementos da política e os elementos filho na ordem fornecida na declaração da política. Saiba mais sobre como definir e editar as políticas de Gerenciamento de API.
Declaração de política
<limit-concurrency key="expression" max-count="number">
<!— nested policy statements -->
</limit-concurrency>
Atributos
| Atributo | Descrição | Obrigatório | Padrão |
|---|---|---|---|
| chave | Uma cadeia de caracteres. Especifica o escopo de simultaneidade. Pode ser compartilhado por várias políticas. Expressões de política são permitidas. | Sim | N/D |
| max-count | Um inteiro. Especifica um número máximo de solicitações que são permitidas para inserir a política. Expressões de política não são permitidas. | Sim | N/D |
Uso
- Seções da política: entrada, saída, back-end, em caso de erro
- Escopos de política: global, espaço de trabalho, produto, API, operação
- Gateways: clássico, v2, consumo, auto-hospedado, espaço de trabalho
Observações de uso
- O número máximo de solicitações impostas pelo Gerenciamento de API é menor quando várias unidades de capacidade são implantadas em uma região.
Exemplo
O exemplo a seguir demonstra como limitar o número de solicitações encaminhadas a um back-end com base no valor de uma variável de contexto.
<policies>
<inbound>…</inbound>
<backend>
<limit-concurrency key="@((string)context.Variables["connectionId"])" max-count="3">
<forward-request timeout="120"/>
</limit-concurrency>
</backend>
<outbound>…</outbound>
</policies>
Políticas relacionadas
Conteúdo relacionado
Para obter mais informações sobre como trabalhar com políticas, consulte:
- Tutorial: Transformar e proteger sua API
- Referência de Política para uma lista completa das instruções de política e suas configurações
- Expressões de política
- Definir ou editar políticas
- Reutilizar configurações de política
- Repositório de snippets de política
- Kit de ferramentas de políticas do Gerenciamento de API do Azure
- Criar políticas usando o Microsoft Copilot no Azure