IBM®
API Connectで製品の新規バージョンが作成されると、サブスクライバーを新規製品のプランに移動する方法がいくつかあります。
このタスクについて
API Manager のUIにある関連カタログ内の製品横 
にあるオプションアイコンを使用することで、製品戦略に応じて、さまざまな方法でユーザーを新しいプランに移行することができます。
手順
製品に修正を適用する場合など、既存のすべてのサブスクライバーを新規製品に自動的に移行させるには、以下のようにします。
- 製品の元のバージョンを製品の新しいバージョンに 置き換える 必要があります。
- 置き換え後の製品が公開されます。
- 元の製品は廃棄されます。
- 元の製品に対するサブスクライバーが、置き換え後の製品に自動的にマイグレーションされます。
製品の交換に関する詳細については、
「製品を別の製品と交換する」 を参照してください。
拡張機能や新機能が追加された場合などに、新規製品への移行をサブスクライバーに促し、新規ユーザーが元の製品をサブスクライブしないようにするには、以下のようにします。
- 製品の元のバージョンを、製品の新しいバージョンに 取り替えます 。
- 入れ替わる新しい製品が公開されます。
- 元の製品は 「非推奨」です。
- 非推奨になった製品を既にサブスクライブしているアプリケーション開発者は引き続きその製品を使用できますが、新規の開発者がその製品をサブスクライブすることはできなくなります。 「 コンシューマー・カタログ 」では、加入者に「 このサブスクリプションを移行する 」というメッセージが表示されます。これをクリックすると、サブスクリプションを移行先へアップグレードできます。
置き換えられる製品に関する詳細については、
「ある製品を別の製品に置き換える」 を参照してください。
製品を実動環境から削除する準備をして、既存のサブスクリプションはそのまま残す場合は、以下のようにします。
- 元の製品を 非推奨 にする必要があります。
- 製品は 非推奨です。
- 非推奨になった製品を既にサブスクライブしているアプリケーション開発者は引き続きその製品を使用できますが、新規の開発者がその製品をサブスクライブすることはできなくなります。
- カタログの「マイグレーション・ターゲットの設定」オプションを使用して、置き換え用の製品を定義できます。 その後、アプリケーション開発者はコンシューマーカタログに 「このサブスクリプションを移行」 というメッセージが表示され、これをクリックすることで、サブスクリプションを移行先へアップグレードできるようになります。
- 「移行先を設定」 オプションを使用すると、 「置き換え 」オプションと同じ機能を実行できます。 これは、サブスクリプションを移行先製品へ移行するための準備を行うものであり、ソース製品を非推奨にするものではありません。 対象の製品は、すでに公開されている必要があります。
注:両 置き換える 方の製品は、すべてのサブスクリプションの移行が完了した後、ソース製品 移行先を設定する は使用されなくなり、今後移行先としても使用されないことを前提としています。
これらのオプションは通常、製品Aの新バージョンが、その製品の旧バージョンに取って代わる場合に使用されます。 送信元と送信先の製品には、それぞれ属性 superseded_by と が付けられています supersedes。
- 「移行対象の実行」 を使用して、旧製品を廃止する前に、その製品からすべてのサブスクリプションの移行を強制的に実行します。
注:「製品の上書き」 および 「移行先の設定」機能は、2つの製品が互いを移行先として指定し合うという循環依存関係を回避するため、移行先を古い製品バージョンに設定できないようにします。
移行先を以前のバージョンにリセットするには、まず「製品の置き換え」 または 「移行先の設定」 によって作成された および supersedes の設定 superseded_by を削除してください。 次に、 「移行ターゲットの実行」 を実行して、すべてのサブスクリプションを移行先製品に移行します。
すべてのサブスクリプションの移行が完了したら、元の製品を廃止してください。 再利用するには、古いバージョンの「 移行先を設定」 を使用する前に、再ステージングして再公開してください。
「Products」の非推奨に関する詳細については、
「Productsの非推奨」 を参照してください。