XML から JSON への変換
適用対象: すべての API Management レベル
xml-to-json
ポリシーは、要求本文または応答方文を XML から JSON に変換します。 このポリシーを使用すると、XML のみのバックエンド Web サービスに基づく API を最新化することができます。
Note
ポリシーの要素と子要素を、ポリシー ステートメントで指定された順序で設定します。 API Management ポリシーを設定または編集する方法について説明します。
ポリシー ステートメント
<xml-to-json kind="javascript-friendly | direct" apply="always | content-type-xml" consider-accept-header="true | false" always-array-child-elements="true | false"/>
属性
属性 | 説明 | 必要 | Default |
---|---|---|---|
kind | この属性の値は次のいずれかに設定する必要があります。 - javascript-friendly - 変換後の JSON が JavaScript 開発者にとってわかりやすい形になります。- direct - 変換後の JSON に元の XML ドキュメントの構造が反映されます。ポリシー式を使用できます。 |
はい | 該当なし |
apply | この属性の値は次のいずれかに設定する必要があります。 - always - 常に変換します。- content-type-xml - 応答の Content-Type ヘッダーに XML の存在が示されている場合のみ変換を行います。ポリシー式を使用できます。 |
はい | 該当なし |
consider-accept-header | この属性の値は次のいずれかに設定する必要があります。 - true - 要求の Accept ヘッダーで JSON が要求されている場合に変換を適用します。- false - 常に変換を適用します。ポリシー式を使用できます。 |
いいえ | true |
always-array-child-elements | この属性の値は次のいずれかに設定する必要があります。 - true - 子要素を常に JSON 配列に変換します。- false - 複数の子要素のみを JSON 配列に変換します。 1 つの子要素を JSON オブジェクトに変換します。ポリシー式を使用できます。 |
いいえ | false |
使用法
- ポリシー セクション: inbound、outbound、on-error
- ポリシー スコープ: グローバル、ワークスペース、製品、API、操作
- ゲートウェイ: クラシック、v2、従量課金、セルフホステッド、ワークスペース
例
<policies>
<inbound>
<base />
</inbound>
<outbound>
<base />
<xml-to-json kind="direct" apply="always" consider-accept-header="false" />
</outbound>
</policies>
関連ポリシー
関連するコンテンツ
ポリシーに対する処理の詳細については、次のトピックを参照してください。
- チュートリアル:API を変換および保護する
- ポリシー ステートメントとその設定の一覧に関するポリシー リファレンス
- ポリシー式
- ポリシーの設定または編集
- ポリシー構成を再利用する
- ポリシー スニペットのリポジトリ
- Azure で Microsoft Copilot を使用してポリシーを作成する