IBM Cloud Docs
エンドポイント URL を watsonplatform.net から新しいものに更新する

エンドポイント URL を watsonplatform.net から新しいものに更新する

watsonplatform.net の各 Watson API エンドポイント URL は、随時変更されていて、それらが廃止された後は機能しません。 ご使用の呼び出しを、より新しいエンドポイント URL を使用するように更新します。

watsonplatform.net エンドポイント URL は、2021 年 5 月 26 日に廃止されました。 ご使用の API 呼び出しを、新しい URL を使用するように更新してください。

各 Watson サービスが 2019 年 12 月に発表されたように、新しいエンドポイント URL のパターンは api.{location}.{offering}.watson.cloud.ibm.com です。 例えば、ワシントン DC でホストされている各 Watson Assistant サービスでは、message エンドポイントは https://gateway-wdc.watsonplatform.net/assistant/api/v1/workspaces/{workspace_id}/message から https://api.us-east.assistant.watson.cloud.ibm.com/instances/{instance_id}/v1/workspaces/{workspace_id}/message に変更されます。 新しいエンドポイントでは、ドメイン、ロケーション、およびオファリング識別子は異なっています。

Watson API を呼び出す際に、ご使用の Watson オファリングに対応し、ご使用のサービス・インスタンスがホストされているロケーションに対応している新しいベース URL を使用してください。

エンドポイント URL の検索および更新

ご使用のサービス・インスタンスの URL は、サービス資格情報を使用して見つけることができます。 また、同じ場所でエンドポイント URL と API キーを更新することもできます。

  1. リソース・リストでサービスの名前をクリックします。
  2. 資格情報で watsonplatform.net というドメインが含まれる URL を見つけた場合は、その資格情報を次のようにして更新します。
    1. **「サービス資格情報」タブをクリックしてから、「新規資格情報」**をクリックします。
    2. 新規資格情報を展開して、対象の url を探します。 パターンは api.{location}.{offering}.watson.cloud.ibm.com です。
    3. 新規資格情報で apikey を探します。
  3. セットの 「削除」 アイコン 「削除」アイコン をクリックして、古い資格情報を削除します。
  4. ご使用の API 呼び出しを、watson.cloud.ibm.com URL と API キー値を使用するように更新します。

API 呼び出しの更新

2021 年 5 月 26 日以降、watsonplatform.net を使用するアプリケーションと API 呼び出しは、接続することができません。

クライアント・アプリケーションを、同じ資格情報のセットから、api.{location}.{offering}.watson.cloud.ibm.com というパターンを持つ更新されたエンドポイント URL と API キーを使用するように更新します。 既存の API キーは、古い資格情報を削除するまで、新しいエンドポイント URL で機能しますが、一部の Watson ツールでは、古い URL が存在している限り、それを使用し続けることがあります。 古い資格情報セットを削除することで、呼び出しが成功しない可能性を減らします。

Watson SDK での URL の設定について詳しくは、ご使用のサービスの API リファレンスのエンドポイント URL のセクションを参照してください。