Создание версий API¶

С появлением версий API (API Revisions) и версий продуктов API (API Product Revisions) ранее связанные между собой операции публикации и развертывания были разделены. Издатель API получает больше контроля над развертыванием API, а также возможность вносить восстанавливаемые изменения в проект API. Версии API похожи на контрольную точку во времени, фиксируя текущее состояние API на момент создания версий. Если изменения окажут негативное влияние на API после его развертывания в среде шлюза, вы сможете быстро восстановить прежнее состояние API. Кроме того, даже если вы хотите протестировать новую конфигурацию среды выполнения, эта концепция дает возможность протестировать ее на независимом шлюзе, прежде чем применять то же изменение на всех шлюзах.

Архитектурные изменения и ключевые характеристики

Возможность использования новой версии вносит несколько архитектурных характеристик.

При изменении состояния жизненного цикла на «Опубликовано» API будет отображаться только на портале разработчика и не будет выполнять развертывание.
Развертывание API в шлюзе требует дополнительных действий. Издатель должен создать версию и развернуть эту версию в требуемой среде (средах) шлюза.
Один API или API-продукт может иметь несколько версий (максимум 5, и по достижении максимального лимита необходимо удалить версию перед созданием новой).
Если существует несколько шлюзов, у вас есть возможность развернуть одну и ту же версию на всех шлюзах или разные версии API на каждом шлюзе. Каждый шлюз будет обрабатывать запросы API по-разному в зависимости от развернутой версии.
Создайте и разверните API в шлюзе, не меняя состояние жизненного цикла на «Опубликовано».
Версии нельзя редактировать.
Для отмены последних изменений вы можете восстановить API до определенной версии.