AWS 上のサービスとしてwatsonx.governanceの REST API を使用するには、API にアクセス権を付与する必要があります。

開始する前に、IBM SaaSConsole でアカウント ビューアー、サブスクリプション ビューアー、およびサービス管理者のロールがあることを確認してください。

REST APIにサービスへのアクセスを許可するには、以下の手順を実行する：

1. アクセスを提供したいインスタンスのサービスIDとAPIキーを生成する。 APIキーは後で使用するために保管しておく。 詳細については、「 IBM SaaSコンソールからサービス ID および API キーを使用してアクセスを許可する」を参照してください。

2. IBM SaaSConsoleのInstancesタブで、使用するサービス・インスタンスのIDを取得します。

3. HTTPリクエストを使ってアクセストークンを生成する。 例えば、次のようなcURLコマンドが使える：

   curl -X POST -H "Accept: application/json" -H "Content-Type: application/json" \
   -d '{ "apikey" : "<APIkey>" }' \
   https://account-iam.platform.saas.ibm.com/api/2.0/services/<instanceID>/apikeys/token
   

   <APIkey>生成したAPIキー、<instanceID>は使用するサービス・インスタンスのIDである。

4. アクセストークンを使用してREST APIエンドポイントにアクセスします。 例えば、次のようなcURLコマンドが使える：

   curl -L -H "Authorization: Bearer <access_token>" --header "Accept: application/json" \
   "<applicationURL>/opgrc/api/v2/types"
   

   <access_token>生成したアクセストークン、<applicationURL>は Governance コンソールの固定 URL です。

   固定 URL の取得方法の詳細については、Governance コンソール URL の共有を参照してください。

使用できる REST API エンドポイントのリストは、「IBM OpenPagesREST APIV2forOpenPagesas a Service」を参照してください。

親トピック AWSでのwatsonx.governance環境の管理 (継続的なメンテナンス)