Вам необходимо внести несколько небольших, некритических обновлений в существующий API, размещенный в APIM. Требования: не нарушать работу существующих вызывающих сторон, иметь возможность откатить изменения в случае необходимости, предоставить документацию для разработчиков об изменениях и разрешить тестирование до публикации. Что вы должны сделать?

Добавление новой ревизии (revision) в API является лучшим решением, поскольку оно позволяет вносить небольшие, некритические изменения в существующий API, не затрагивая текущих потребителей. Ревизии позволяют тестировать изменения перед их публикацией и легко откатываться к предыдущей стабильной версии в случае проблем. Документация для разработчиков автоматически обновляется. Версионирование (на основе заголовков или строки запроса) используется для внесения значительных, ломающих изменений, которые требуют от потребителей явного выбора новой версии. Создание и публикация продукта не является механизмом для управления изменениями в API. Настройка и применение пользовательской политики — это способ изменения поведения API, но не механизм для управления жизненным циклом изменений API с возможностью отката и тестирования.