特定の製品を別の製品で置き換える
API Manager を使用すれば、公開済みの製品を別の製品 IBM® API Connect に置き換え、同時にすべてのサブスクリプションを移行することができます。 この操作により、ソース製品が廃止され、ターゲット製品が公開されます。
開始前に
置き換えられる製品は「公開済み」状態になっている必要があり、新しく置き換わる製品は「ステージング済み」、「公開済み」、または「非推奨」状態になっている必要があります。
記載されているプロダクト管理タスクを実行するには、API プロバイダー組織の所有者であるか、または当該プロダクトが含まれるカタログ内のプロダクトに対して「管理」権限が割り当てられている必要があります。 製品の表示権限が割り当てられている場合、製品管理ページへの読み取り専用アクセス権限のみを持つことになります。 カタログの製品管理権限の設定については、 「カタログの作成と設定」 を参照してください。
のシンジケーション機能により IBM API Connect 、商品をカタログ内の特定のスペースに配置することができます。 この場合、このトピックで説明されているプロダクト管理タスクを実行するには、API プロバイダー組織の所有者であるか、またはそのプロダクトが含まれるスペースにおいてプロダクトの「管理」権限が割り当てられている必要があります。 スペースの製品管理権限の設定については、 「スペースでのユーザーアクセス管理」 を参照してください。
このタスクについて
- 置き換え後の製品が公開されます。
- 置き換え後の製品の可視性とサブスクライブ可能性の設定で、アクセス権限の制限が元の製品と同じであるか、それよりも緩やかである場合は、置き換え後の製品での設定が使用されます。 置き換え後の製品の設定で、制限が元の製品よりも厳しい場合 (つまり、製品を表示またはサブスクライブできるコンシューマー組織の数が少なくなる場合)、置き換え操作は失敗します。 表示設定および購読設定の詳細については、 「製品の公開設定の変更」 を参照してください。
- 元の製品に対するサブスクライバーが、置き換え後の製品にマイグレーションされます。
- 元の製品の状態が「廃棄済み」に変わります。 「販売終了 」状態の製品は、アプリケーション開発者には表示されなくなり、それらに対するすべてのサブスクリプションはキャンセルされます。 ただし、必要な場合は、製品を再度ステージングできます。
開発用カタログへの公開は可能ですが、開発用カタログはテスト目的でのみ使用してください。 カタログに関する詳細については、 「カタログの操作」 を参照してください。
手順
- API Manager UI のナビゲーション ペインで、 [カタログの管理]
をクリックし、操作したいカタログを選択します。カタログの「 製品 」ページが開き、そのカタログで入手可能なすべての製品が表示されます。 - 置き換えたい製品のバージョンの横にあるオプションアイコンをクリックし、 [置き換え
] をクリックします。「 置換 」ウィンドウが開きます。 - 「置換」をクリックします。このカタログ内の製品を置換するために承認が必要な場合は、承認要求が送信され、製品が「保留」状態に移行します。製品は、要求が承認されたときに置換されます。 承認が不要な場合は、製品が直ちに置換されます。 カタログの製品ライフサイクル承認の設定については、 「カタログの作成と設定」 を参照してください。 リクエストの承認に関する詳細については、 「製品ライフサイクルおよびサブスクリプションのリクエストを承認する」 を参照してください。注:
- カタログ内の製品のライフサイクルの状態変更の承認は、デフォルトで無効になっています。 実施するには、ライフサイクル状態変更を明示的に有効にする必要があります。
- 製品ライフサイクルの承認は、カタログ・レベルでのみ構成できます。 この機能は、 スペース ・レベルでは使用できません。
- サブスクリプションのタスク履歴を表示するには、以下の手順を実行してください：
- API Manager UI のナビゲーション ペインで、 [管理] をクリックし、操作したいカタログを選択します。
- [タスク] タブをクリックします。
- ナビゲーションペインから 「承認履歴」 をクリックします。
- 対象の製品横 にあるオプションアイコンをクリックし、 「承認履歴を表示」 を選択すると、その製品のライフサイクルに関するリクエストと承認の履歴を確認できます。
結果
新規製品が「公開済み」の状態になり、元の製品は「廃棄済み」の状態になりました。
新規製品が、選択した組織またはコミュニティーに公開されます。 選択されたグループ内のアプリケーション開発者は、製品内の API を表示して使用することができます。製品の使用を求めるアプリケーション開発者要求はすべて、該当するカタログの「承認」タブに表示されます。このタブで、要求を承認または拒否できます。