Заметка
Доступ к этой странице требует авторизации. Вы можете попробовать войти в систему или изменить каталог.
Доступ к этой странице требует авторизации. Вы можете попробовать сменить директорию.
ОБЛАСТЬ ПРИМЕНЕНИЯ: все уровни Управление API
Политика xml-to-json преобразует текст запроса или ответа в формате XML в формат JSON. Эту политику можно использовать для модернизации интерфейсов API, основанных на серверных веб-службах (только XML).
Примечание.
Задайте элементы политики и дочерние элементы в порядке, указанном в правиле политики. Узнайте, как устанавливать или изменять политики службы управления API.
Правило политики
<xml-to-json kind="javascript-friendly | direct" apply="always | content-type-xml" consider-accept-header="true | false" always-array-child-elements="true | false"/>
Атрибуты
| Атрибут | Описание | Обязательное поле | По умолчанию. |
|---|---|---|---|
| добрый | Для атрибута нужно задать одно из следующих значений: - javascript-friendly — преобразованный JSON имеет понятное для разработчиков JavaScript форму.- direct — преобразованный JSON отражает структуру исходного XML-документа.Допустимы выражения политики. |
Да | Н/П |
| применить | Для атрибута нужно задать одно из следующих значений: - always — всегда преобразуйте.- content-type-xml — преобразуется только в том случае, если заголовок Content-Type ответа указывает на наличие XML.Допустимы выражения политики. |
Да | Н/П |
| заголовок | Для атрибута нужно задать одно из следующих значений: - true — примените преобразование, если JSON запрашивается в заголовке accept запроса.- false -всегда применять преобразование.Допустимы выражения политики. |
нет | true |
| always-array-child-elements | Для атрибута нужно задать одно из следующих значений: - true — Всегда преобразуйте дочерние элементы в массив JSON.- false — Преобразуйте только несколько дочерних элементов в массив JSON. Преобразуйте один дочерний элемент в объект JSON.Допустимы выражения политики. |
нет | false |
Использование
- Разделы политики: входящий трафик, исходящий трафик, при возникновении ошибок
- Области политики: глобальная, рабочая область, продукт, API, операция
- Шлюзы: классическая, версия 2, потребление, локальное размещение, рабочая область
Пример
<policies>
<inbound>
<base />
</inbound>
<outbound>
<base />
<xml-to-json kind="direct" apply="always" consider-accept-header="false" />
</outbound>
</policies>
Связанные политики
Связанный контент
Дополнительные сведения о работе с политиками см. в нижеуказанных статьях.
- Руководство. Преобразование и защита API
- Полный перечень операторов политик и их параметров см. в справочнике по политикам.
- Выражения политики
- Настройка или изменение политик
- Повторное использование конфигураций политик
- Репозиторий фрагментов политик
- Репозиторий игровой площадки политики
- Набор средств политики Управление API Azure
- Получите помощь Copilot для создания, объяснения и устранения неполадок в политике