Includi frammento

SI APPLICA A: Tutti i livelli di Gestione API

Il criterio include-fragment inserisce il contenuto di un frammento di criterio creato in precedenza nella definizione del criterio. Un frammento di criterio è un frammento di codice di un criterio XML riutilizzabile e gestito centralmente che può essere incluso nelle definizioni di criteri nell'istanza di Gestione API.

Il criterio inserisce il frammento di criterio così come si trova nella posizione selezionata all’interno della definizione dei criteri.

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

<include-fragment fragment-id="fragment" />

Attributi

Attributo	Descrizione	Richiesto	Valore predefinito
fragment-id	Stringa . Specifica l'identificatore (nome) di un frammento di criterio creato nell'istanza di Gestione API. 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

Esempio

Nell'esempio seguente, il frammento di criterio denominato myFragment viene aggiunto nella sezione in ingresso di una definizione di criteri.

<inbound>
    <include-fragment fragment-id="myFragment" />
    <base />
</inbound>
[...]

Criteri correlati

• Controllo e flusso dei criteri

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
• Creare criteri usando Microsoft Copilot in Azure