Inventory service V2 API およびイベントへのアップグレード

在庫管理に可用性、予約、イベントAPIの V1 をご利用の場合は、 Inventory service に対応する V2 のAPIとイベントにアップグレードする必要があります。

このタスクについて

在庫管理用の V2 APIとイベントにアップグレードする方法を計画し、環境を整えてください。 IBM からアップグレードをリクエストし、環境のアップグレードを完了する必要があります。

手順

  1. V1の URLとイベント識別子を置き換える新しい V2の URLとイベント識別子を確認してください。 詳細については、 V1 および V2 のAPI URLとイベント識別子をご覧ください。
  2. V1 イベントを使用している場合は、お客様の環境で次のいずれかの手順を実行してください。
  3. V2 API を使用するようにクライアント・サイドの実装を更新し、新規イベント・コンシューマーを開始して V2 イベントを listen します。
    注:
    • クライアントは、ネットワーク予約のノード優先動作を有効にする必要があります。 詳しくは、ノードの優先動作を使用した予約を参照してください。
    • APIの更新に関する詳細は、 Update settings APIを参照し、 placeNodeLevelReservationForDg の値を true に設定してください。
    • ノード優先度の動作を有効にした後、V2 network reservation APIを使用してV1ネットワーク予約を再作成します。 これにより、すべてのネットワーク予約がノードごとに優先され、在庫のオーバーブッキングがなくなる。 V2 reservation APIは、 が設定されていない場合、またはfalseの場合に例外をスローする予定です。 詳細については、 placeNodeLevelReservationForDg
      日付による予約（ ） V2 を参照してください。 変更が完了したら、V2のネットワーク予約の使用を開始できます。
    • システムの中断を最小限に抑えるため、V1からV2にAPI URLを切り替える際には、ダウンタイムの計画を立てることをお勧めします。
  4. アップグレード・プロセスを開始するには、サポート・チケットをオープンしてください。 詳細については、 IBM® サポートをご覧ください。
  5. 新しいイベントエンドポイント（ IBM Cloud Object Storage ）とウェブフックをサポートチケットに提供してください。
    注:
    • 有効化する必要のあるすべての v2 イベントを指定します。
    • 失敗したイベントが消費されているかどうかを指定します。
    • COSエンドポイントをご利用の場合は、APIキーとパブリックエンドポイント URL の詳細を共有することができます。
  6. お客様の非本番環境が V1 のデータセンターに配備されており、 V2 への移行が必要な場合、 IBM は V2 の機能とともに新しいデータセンターに設定されます。 本番環境以外の環境に該当する場合は、 IBM Software Support までお問い合わせください。
    移行の場合、 IBM はすべての設定データを新しいデータセンターに移行します。 ただし、トランザクションデータは移行されません。
    • すべての構成データは、3 日間にわたってマイグレーションされます。 この間は環境にアクセスしないでください。
    • 供給データ、需要データ、および予約データを含むトランザクション・データは、完了時にリセットされます。
      注意： この環境アップグレードは、非本番環境および本番前環境のみに適用され、本番環境には影響しません。
  7. IBM V2 のアップグレードが完了すると、サポートから連絡があります。
    その間、 V1 のAPIとイベントは引き続きご利用いただけます。
    注： V2 のアップグレードが完了すると、 V2 の予約APIにすでにアクセスできるようになっているはずです。 環境は新しいデータを2つのパイプラインに分岐させます。古いパイプラインは V1、新しいパイプラインは V2 です。これは、 V2 のアップグレード手順中のみ有効です。
  8. ステップ3で完了したクライアント側の実装の更新に応じて、すべてのクライアントアプリケーションの V2 APIとイベントに切り替えます。 IBM のアップグレードが完了次第、 V2 のAPIに切り替えることができます。 アップグレードが完了すると、 IBM は V1 機能をオフにします。
    注意： IBM がアップグレード作業を完了した後、 V2 への移行には7日間の猶予期間があります。 この期間中、 V1 と V2 の可用性APIは利用可能ですが、 V1 のAPI応答は古くなります。 したがって、できるだけ早く切り替えることを強くお勧めします。
  9. クライアント側のV2カットオーバーが完了したことをIBMに通知する。
    注： V2 の移行が完了したことを確認すると、 V1 はアカウントから廃止され、古いAPIへのアクセスはできなくなります。 この時点で、 V1 のパイプラインは IBM によってオフにされます。

Order Management System Software のオンプレミス環境のみ、ステップ10を完了します。

  1. V2 API およびイベントを処理するために Order Management System Software インスタンスで環境をセットアップするには、以下の手順を実行します。
    1. アプリケーション・サーバーおよびエージェント・サーバーを停止します。
    2. customer.overrides.properties ファイルで、 IVApiVersion パスと URL パスを更新します。
    3. アプリケーション・サーバーおよびエージェント・サーバーを再始動します。
    4. 環境のセットアップが完了したら、 IBM に通知してください。
    詳細については、「日付別内訳による可用性の利用を可能にするための統合アダプタ（フェーズ2）の有効化 」を参照してください。
    注： このステップはアダプターフェーズ2のみに適用されます。 フェーズ1で、カスタム実装によりIV V1 の可用性および予約APIを呼び出している場合は、 V2 のAPI URLを V1 のURLに置き換える必要があります。