Include fragment
GILT FÜR: Alle API Management-Ebenen
Die Richtlinie include-fragment
fügt den Inhalt eines zuvor erstellten Richtlinienfragments in die Richtliniendefinition ein. Ein Richtlinienfragment ist ein zentral verwalteter, wiederverwendbarer XML-Richtlinienausschnitt, der in Richtliniendefinitionen in Ihrer API Management-Instanz enthalten sein kann.
Die Richtlinie fügt das Richtlinienfragment unverändert an der Stelle ein, die Sie in der Richtliniendefinition auswählen.
Hinweis
Legen Sie die Elemente und untergeordneten Elemente einer Richtlinie in der Reihenfolge fest, die in der Richtlinienanweisung angegeben ist. Erfahren Sie mehr darüber, wie Sie API Management-Richtlinien festlegen oder bearbeiten.
Richtlinienanweisung
<include-fragment fragment-id="fragment" />
Attribute
Attribut | BESCHREIBUNG | Erforderlich | Standard |
---|---|---|---|
fragment-id | Eine Zeichenfolge. Gibt den Bezeichner (Namen) eines in der API Management-Instanz erstellten Richtlinienfragments an. Richtlinienausdrücke sind nicht zulässig. | Ja | – |
Verwendung
- Richtlinienabschnitte: inbound, outbound, backend, on-error
- Richtlinienbereiche: global, Arbeitsbereich, Produkt, API, Vorgang
- Gateways: klassisch, v2, Verbrauch, selbstgehostet, Arbeitsbereich
Beispiel
Im folgenden Beispiel wird das Richtlinienfragment myFragment im Abschnitt „inbound“ einer Richtliniendefinition hinzugefügt.
<inbound>
<include-fragment fragment-id="myFragment" />
<base />
</inbound>
[...]
Verwandte Richtlinien
Zugehöriger Inhalt
Weitere Informationen zum Arbeiten mit Richtlinien finden Sie hier:
- Tutorial: Transformieren und Schützen Ihrer API
- Unter Richtlinien für die API-Verwaltung finden Sie eine komplette Liste der Richtlinienanweisungen und der zugehörigen Einstellungen.
- Richtlinienausdrücke
- Festlegen oder Bearbeiten von Richtlinien
- Wiederverwenden von Richtlinienkonfigurationen
- Repository für Richtliniencodeausschnitte
- Erstellen von Richtlinien mit Microsoft Copilot in Azure