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

Importante

L'accesso collegato non viene controllato quando un frammento di policy viene citato usando fragment-id. Un utente che ha il permesso di scrivere una policy può fare riferimento a qualsiasi frammento di policy disponibile e far sì che API Management esegue le sue dichiarazioni di policy, anche se l'utente non ha accesso di lettura alla risorsa del frammento della policy. Questo non concede l'accesso per visualizzare o modificare la definizione del frammento di policy.

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

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
• repository di esempi Policy
• Toolkit dei criteri di Azure Gestione API
• Ottenere assistenza da Copilot per creare, spiegare e risolvere le politiche