Limitar a simultaneidade

APLICA-SE A: Todas as camadas de gerenciamento de API

A limit-concurrency política impede que as políticas anexadas sejam executadas por mais do que o número especificado de solicitações a qualquer momento. Quando esse número for excedido, novas solicitações falharão imediatamente com o código de 429 status Solicitações Demais.

Nota

Defina os elementos da política e os elementos filho na ordem fornecida na declaração de política. Saiba mais sobre como definir ou editar 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	Description	Necessário	Predefinição
key	Uma cadeia de caracteres. Especifica o escopo de simultaneidade. Pode ser compartilhado por várias políticas. São permitidas expressões de política.	Sim	N/A
contagem máxima	Um inteiro. Especifica um número máximo de solicitações que têm permissão para entrar na política. Expressões de política não são permitidas.	Sim	N/A

Utilização

• Seções de política: entrada, saída, back-end, no erro
• Âmbitos de política: global, área de trabalho, produto, API, operação
• Gateways: clássico, v2, consumo, auto-hospedado

Exemplo

O exemplo a seguir demonstra como limitar o número de solicitações encaminhadas para 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

• Limitação das taxas e quotas

Conteúdos relacionados

Para obter mais informações sobre como trabalhar com políticas, consulte:

• Tutorial: Transforme e proteja sua API
• Referência de política para uma lista completa de declarações de política e suas configurações
• Expressões de política
• Definir ou editar políticas
• Reutilizar configurações de política
• Recompra de trechos de política
• Criar políticas usando o Microsoft Copilot no Azure