APIM でホストされている既存の API に対して、いくつかの小さな非破壊的更新を行う必要があります。既存の呼び出し元を中断せず、必要に応じて変更をロールバックでき、変更に関する開発者向けドキュメントを提供し、公開前にテストできるようにする必要があります。どうすればよいですか？

既存のAPIに非破壊的な更新を行い、既存の呼び出し元を中断せず、ロールバック可能にし、開発者向けドキュメントを提供し、公開前にテストできるようにするには、APIリビジョンを追加するのが最適な方法です。リビジョンを使用すると、APIの複数のバージョンを同時に管理でき、変更をステージングしてテストし、準備ができたときにのみ公開できます。ヘッダーベースまたはクエリ文字列ベースのバージョン管理は、APIの異なるメジャーバージョンを管理するために使用されますが、既存のAPIへの小さな非破壊的変更には適していません。製品はAPIのグループ化と公開に使用され、カスタムポリシーはAPIの動作を変更しますが、これらの要件には直接対応しません。