XML zu JSON konvertieren
GILT FÜR: Alle API Management-Ebenen
Die Richtlinie xml-to-json
konvertiert einen Anforderungs- oder Antworttext von XML in JSON. Diese Richtlinie kann verwendet werden, um APIs basierend auf reinen XML-Back-End-Webdiensten zu aktualisieren.
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
<xml-to-json kind="javascript-friendly | direct" apply="always | content-type-xml" consider-accept-header="true | false" always-array-child-elements="true | false"/>
Attribute
Attribut | BESCHREIBUNG | Erforderlich | Standard |
---|---|---|---|
kind | Das Attribut muss auf einen der folgenden Werte festgelegt werden. - javascript-friendly : Die konvertierte JSON hat ein für JavaScript-Entwickler verständliches Format.- direct : Die konvertierte JSON spiegelt die Struktur des ursprünglichen XML-Dokuments wider.Richtlinienausdrücke sind zulässig. |
Ja | – |
apply | Das Attribut muss auf einen der folgenden Werte festgelegt werden. - always : Immer konvertieren.- content-type-xml : Nur konvertieren, wenn der Content-Type-Header der Antwort das Vorhandensein von XML angibt.Richtlinienausdrücke sind zulässig. |
Ja | – |
consider-accept-header | Das Attribut muss auf einen der folgenden Werte festgelegt werden. - true : Konvertierung anwenden, wenn JSON im Accept-Header der Anforderung angefordert wird.- false : Konvertierung immer anwenden.Richtlinienausdrücke sind zulässig. |
No | true |
always-array-child-elements | Das Attribut muss auf einen der folgenden Werte festgelegt werden. - true : konvertiert untergeordnete Elemente immer in ein JSON-Array.- false : konvertiert nur mehrere untergeordnete Elemente in ein JSON-Array. Konvertieren Sie ein einzelnes untergeordnetes Element in ein JSON-Objekt.Richtlinienausdrücke sind zulässig. |
Nein | false |
Verwendung
- Richtlinienabschnitte: inbound, outbound, on-error
- Richtlinienbereiche: global, Arbeitsbereich, Produkt, API, Vorgang
- Gateways: klassisch, v2, Verbrauch, selbstgehostet, Arbeitsbereich
Beispiel
<policies>
<inbound>
<base />
</inbound>
<outbound>
<base />
<xml-to-json kind="direct" apply="always" consider-accept-header="false" />
</outbound>
</policies>
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
- Azure API Management-Richtlinientoolkit
- Erstellen von Richtlinien mit Microsoft Copilot in Azure