特定の製品を別の製品で取り替える

オンラインで編集する

「supersede」オプションを使用すると、製品Aを製品Bに置き換え、すべてのサブスクリプションは後日移行することができます。このアクションは、 API Manager を使用して、ソース製品を非推奨とし、宛先製品を公開します。非推奨となった製品では新規のサブスクリプションは受け付けられませんが、既存のサブスクリプションは移行が完了するまで引き続き利用可能です。ユーザーは、都合の良いタイミングで、すべてのサブスクリプションをまとめて、または個別に移行することができます。

開始前に

取り替えられる製品は、「公開済み」状態である必要があります。取り替え先の製品は、「ステージング済み」、「公開済み」、または「非推奨」の状態になっている必要があります。

記載されているプロダクト管理タスクを実行するには、API プロバイダー組織の所有者であるか、または当該プロダクトが含まれるカタログ内のプロダクトに対して「管理」権限が割り当てられている必要があります。製品の表示権限が割り当てられている場合、製品管理ページへの読み取り専用アクセス権限のみを持つことになります。カタログの製品管理権限の設定については、「カタログの作成と設定」を参照してください。

のシンジケーション機能により IBM® API Connect 、商品をカタログ内の特定のスペースに配置することができます。この場合、このトピックで説明されているプロダクト管理タスクを実行するには、API プロバイダー組織の所有者であるか、またはそのプロダクトが含まれるスペースにおいてプロダクトの「管理」権限が割り当てられている必要があります。スペースの製品管理権限の設定については、「スペースでのユーザーアクセス管理」を参照してください。

このタスクについて

特定の製品を別の製品で取り替えると、以下のアクションが実行されます。

取り替え先の製品が公開されます。
取り替え先の製品の可視性とサブスクライブ可能性の設定で、アクセス権限の制限が元の製品と同じであるか、それよりも緩やかである場合は、取り替え先の製品での設定が使用されます。
置き換えられる製品の設定により、アクセスがより制限され、その結果、その製品を閲覧または購読できる消費者団体が少なくなる場合、置き換えられた操作は失敗します。表示設定および購読設定の詳細については、「製品の公開設定の変更」を参照してください。
元の製品の状態が「非推奨」に変わります。
非推奨になった製品を既にサブスクライブしているアプリケーション開発者は引き続きその製品を使用できますが、新規の開発者がその製品をサブスクライブすることはできなくなります。
非推奨の製品は、必要に応じて再度公開できます。

開発用カタログへの公開は可能ですが、開発用カタログはテスト目的でのみ使用してください。カタログに関する詳細については、「カタログの操作」を参照してください。

注：このトピックにおける「カタログ」への言及は、特に断りがない限り、カタログ内の「スペース」にも適用されます。

手順

製品を取り替えるには、以下のステップを実行します。

API Manager UI のナビゲーションペインで、 [カタログの管理] をクリックし、操作したいカタログを選択します。
カタログの「製品」ページが開き、そのカタログで入手可能なすべての製品が表示されます。
操作したい製品が特定のスペースに含まれている場合は、以下の手順に従って該当するスペースを選択してください：
1. 「スペース」タブをクリックします。
2. 作業したい領域を選択してください。
そのスペースの「商品」ページが開き、そのスペースで利用可能なすべての商品が表示されます。
置き換えたい製品バージョンの横にあるオプションアイコンをクリックし、 [置き換え ] をクリックします。
置き換え後の製品を選択して、「次へ」をクリックします。
ドロップダウンメニューから、新しい製品のどのプランが、旧製品のどのプランに対応するかを選択してください。
「取り替え」をクリックします。
このカタログ内の製品を取り替えるために承認が必要な場合は、承認要求が送信され、製品が「保留」状態に移行します。製品は、要求が承認されたときに取り替えられます。承認が不要な場合は、製品が直ちに取り替えられます。カタログの製品ライフサイクル承認の設定については、「カタログの作成と設定」を参照してください。リクエストの承認に関する詳細については、「製品ライフサイクルおよびサブスクリプションのリクエストを承認する」を参照してください。
注:
- カタログ内の製品のライフサイクルの状態変更の承認は、デフォルトで無効になっています。実施するには、ライフサイクル状態変更を明示的に有効にする必要があります。
- 製品ライフサイクルの承認は、カタログ・レベルでのみ構成できます。この機能は、スペース・レベルでは使用できません。
- サブスクリプションのタスク履歴を表示するには、以下の手順を実行してください：
  
  API Manager UI のナビゲーションペインで、 [管理] をクリックし、操作したいカタログを選択します。
  
  [タスク] タブをクリックします。
  
  ナビゲーションペインから「承認履歴」をクリックします。
- 対象の製品横にあるオプションアイコンをクリックし、「承認履歴を表示」を選択すると、その製品のライフサイクルに関するリクエストと承認の履歴を確認できます。

結果

取り替え先の製品が「公開済み」の状態になりました。

取り替えられた製品は「非推奨」の状態になります。

取り替え先の製品が、選択した組織またはコミュニティーに公開されます。選択されたグループ内のアプリケーション開発者は、製品内の API を表示して使用することができます。元の製品は非推奨になります。

製品の使用を求めるアプリケーション開発者要求はすべて、該当するカタログの「承認」タブに表示されます。このタブで、要求を承認または拒否できます。