Limite concorrenza

SI APPLICA A: Tutti i livelli di Gestione API

Il criterio limit-concurrency impedisce ai criteri racchiusi di eseguire un numero maggiore di richieste in qualsiasi momento rispetto a quello specificato. Quando tale numero viene superato, le nuove richieste avranno subito esito negativo con codice di stato 429 - Troppe richieste.

Attenzione

A causa della natura distribuita dell'architettura di limitazione, la limitazione della velocità non è mai completamente accurata. La differenza tra il numero configurato di richieste consentite e il numero effettivo varia a seconda del volume e della frequenza delle richieste, della latenza back-end e di altri fattori.

Nota

Impostare gli elementi e gli elementi figlio del criterio nell'ordine specificato nell'istruzione del criterio. Altre informazioni su come impostare o modificare i criteri di API Management.

Istruzione del criterio

<limit-concurrency key="expression" max-count="number">
        <!— nested policy statements -->
</limit-concurrency>

Attributi

Attributo	Descrizione	Richiesto	Valore predefinito
chiave	Stringa . Specifica l'ambito di concorrenza. Può essere condivisa da più criteri. Le espressioni di criteri sono consentite.	Sì	N/D
numero max	Valore intero. Specifica un numero massimo di richieste autorizzate ad accedere al criterio. Le espressioni di criteri non sono consentite.	Sì	N/D

Utilizzo

• Sezioni del criterio: inbound, outbound, backend, on-error
• Ambiti del criterio: globale, area di lavoro, prodotto, API, operazione
• Gateway: classico, v2, consumo, self-hosted, area di lavoro

Note sull'utilizzo

• Il numero massimo di richieste applicate da Gestione API è inferiore quando più unità di capacità vengono distribuite in un'area.

Esempio

Nell'esempio seguente viene illustrato come limitare il numero di richieste inoltrate a un back-end in base al valore di una variabile di contesto.

<policies>
  <inbound>…</inbound>
  <backend>
    <limit-concurrency key="@((string)context.Variables["connectionId"])" max-count="3">
      <forward-request timeout="120"/>
    </limit-concurrency>
  </backend>
  <outbound>…</outbound>
</policies>

Criteri correlati

• Limitazione della frequenza e quote

Contenuto correlato

Per ulteriori informazioni sull'utilizzo dei criteri, vedere:

• Esercitazione: trasformare e proteggere l'API
• Informazioni di riferimento sui criteri per un elenco completo delle istruzioni dei criteri e delle relative impostazioni
• Espressioni di criteri
• Impostare o modificare criteri
• Riutilizzare le configurazioni dei criteri
• Repository dei frammenti di criteri
• Repository del playground dei criteri
• Toolkit dei criteri di Azure Gestione API
• Ottenere assistenza da Copilot per creare, spiegare e risolvere le politiche