Fragment einschließen

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 –

Wichtig

Verknüpfter Zugriff wird nicht überprüft, wenn ein Policy-Fragment mit Verwendung fragment-idreferenziert wird. Ein Nutzer, der die Berechtigung hat, eine Richtlinie zu schreiben, kann auf jedes verfügbare Richtlinienfragment verweisen und API-Management dazu bringen, dessen Richtlinienanweisungen auszuführen, selbst wenn der Benutzer keinen Lesezugriff auf die Richtlinienfragmentressource hat. Dies gewährt keinen Zugriff, um die Definition des Policy-Fragments anzusehen oder zu ändern.

Verwendung

Beispiel

Im folgenden Beispiel wird das Richtlinienfragment myFragment im Abschnitt „inbound“ einer Richtliniendefinition hinzugefügt.

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

Zugehöriger Inhalt

Weitere Informationen zum Arbeiten mit Richtlinien finden Sie hier:

  • Last updated on