Поделиться через

Редакции в службе "Управление API Azure"

ОБЛАСТЬ ПРИМЕНЕНИЯ: все уровни управления API

Редакции позволяют вносить изменения в API с помощью управляемого и безопасного способа. Если необходимо внести изменения, создайте новую редакцию. Затем вы можете редактировать и тестировать API, не вызывая помех для пользователей API. Когда вы будете готовы, вы сделаете вашу редакцию текущей. В то же время вы можете при необходимости опубликовать запись в журнал изменений, чтобы пользователи API обновлялись с внесенными изменениями. Журнал изменений публикуется на вашем портале разработчика.

Примечание.

Портал разработчика недоступен в тарифе Consumption.

С помощью исправлений можно:

  • Вносите изменения в определения и политики API безопасно, не нарушая работы продуктивного API.
  • Попробуйте выполнить изменения перед их публикацией.
  • Задокументируйте внесенные изменения, чтобы разработчики могли понять, что нового.
  • Выполните откат, если найдете проблемы.

Начните редактирование, следуя нашему пошаговому руководству.

Доступ к определенным редакциям

Доступ к каждой версии вашего API можно получить с помощью специально сформированного URL-адреса. Добавьте ;rev={revisionNumber} в конец URL-адреса API, но перед строкой запроса, чтобы получить доступ к определенной редакции этого API. Например, этот URL-адрес можно использовать для доступа к версии 3 customers API:

https://apis.contoso.com/customers;rev=3/leads?customerId=123

По умолчанию каждая редакция имеет те же параметры безопасности, что и текущая редакция. Вы можете намеренно изменить политики для конкретной редакции, если вы хотите применить разные средства безопасности для каждой редакции. Например, может потребоваться добавить политику фильтрации IP-адресов, чтобы предотвратить доступ внешних вызывающих к редакции, находящейся в разработке.

Примечание.

Добавьте ;rev={id} к идентификатору API, а не к пути URI.

Текущая редакция

Одну редакцию можно назначить текущей. Эта редакция используется для всех запросов API, которые не указывают явный номер редакции в URL-адресе. Вы можете выполнить откат к предыдущей редакции, задав эту редакцию как текущую.

Вы можете задать версию в качестве текущей с помощью портала Azure. При работе в PowerShell можно воспользоваться командлетом New-AzApiManagementApiRelease.

Описания изменений

При создании редакции вы можете установить описание для собственных целей отслеживания. Описания не отображаются пользователям API.

Когда вы устанавливаете редакцию в качестве текущей версии, вы можете по желанию также указать заметку к общедоступному журналу изменений. Журнал изменений включен на портал разработчика для просмотра пользователей API. Вы можете изменить заметку журнала изменений с помощью командлета Update-AzApiManagementApiRelease PowerShell.

Осторожность

Если вы редактируете устаревшую версию API, нельзя изменить следующие свойства:

  • Имя
  • Тип
  • Описание
  • Требуется подписка
  • Версия API
  • Описание версии API
  • Путь
  • Протоколы

Эти свойства можно изменить только в текущей редакции. Если ваши изменения изменяют любое из этих свойств в не текущей редакции, отображается сообщение Can't change property for non-current revision об ошибке.

Использование редакции в автономном режиме

Версия может быть переведена в офлайн-режим, что делает ее недоступной для пользователей, даже если они пытаются получить доступ к ней через ее URL-адрес. Вы можете пометить редакцию как автономную с помощью портала Azure.

Примечание.

Мы рекомендуем переводить редакции в автономный режим, когда вы их не используете для тестирования.

Версии и редакции

Версии и редакции различаются особенностями. Каждая версия может иметь несколько редакций, как и неверсивный API. Вы можете использовать изменения без использования версий или наоборот. Как правило, версии используются для разделения версий API с критическими изменениями, а ревизии обычно можно использовать для незначительных и некритических изменений в API.

Если ваша ревизия содержит критические изменения или если вы хотите официально превратить свою ревизию в бета-версию или тестовую версию, можно создать версию на основе ревизии. На портале Azure выберите "Создать версию из ревизии" в контекстном меню ревизии на вкладке "Ревизии".

  • Last updated on