API 経由で [エージェント] や [ワークフロー] などの Model Studio アプリを呼び出す場合、対象のアプリとそのワークスペースを識別するための認証情報を提供する必要があります：
-
アプリ ID：すべての API 呼び出しで対象のアプリを識別するために必要です。
-
ワークスペース ID：ドイツ (フランクフルト)、中国 (北京)、日本 (東京)、シンガポール、または中国 (香港) リージョンから呼び出す場合に必要です。これは、これらのリージョンではワークスペース ID がベース URL の一部であるためです。詳細については、「リージョンとサービス範囲の選択」をご参照ください。
このトピックでは、コンソールでこれらの認証情報をすばやく見つける方法について説明します。ワークスペースの詳細については、「ワークスペースの権限管理」をご参照ください。
現在、アプリ ID とワークスペース ID はコンソールから手動でのみ取得できます。これらの ID は、API および CLI による照会には対応していません。
アプリ ID の取得
API 経由でいずれかのアプリを呼び出す際には、その一意の App ID を提供する必要があります。
-
アプリ管理ページに移動します。
-
アプリ一覧で、対象のアプリを見つけ、その
App IDをコピーします。
ワークスペース ID の取得
Workspace ID は、ワークスペースの一意の識別子です。ドイツ (フランクフルト)、中国 (北京)、日本 (東京)、シンガポール、または中国 (香港) リージョンから呼び出す場合、API リクエストに Workspace ID を含める必要があります。これは、これらのリージョンではワークスペース ID が ベース URL の一部であるためです。
現在のワークスペース ID の取得
このセクションでは、現在のワークスペースの ID をすばやく見つける方法について説明します。
-
Model Studio コンソールのホームページに移動し、対象のリージョンを選択します。
-
ページの右上隅にある
アイコンをクリックします。 -
表示されたダイアログボックスで、[ビジネススペースID] を表示してコピーできます。
デフォルトでは、RAM サブアカウントは、参加しているワークスペースの ID のみ表示できます。
すべてのワークスペース ID の照会
この手順は、メインアカウント配下のすべてのワークスペースを照会または管理するためのものです。このタスクを実行できるのは、スーパー管理者のみです。
-
メインアカウント または 権限が付与されたサブアカウント を使用して Model Studio コンソールにログインします。
-
右上隅の
アイコンをクリックして、ワークスペース管理ページに移動します。 -
ワークスペース ID 列で、目的のワークスペースの ID を確認し、コピーします。
この操作には、メインアカウント、または AliyunBailianFullAccess もしくは AliyunBailianControlFullAccess 権限を持つ RAM サブアカウントが必要です。必要な権限がない場合、ページにアクセスしようとすると、コンソールに権限不足のエラーが表示されます。権限の付与方法については、「権限の管理」をご参照ください。
次のステップ
認証情報を取得したら、「ワークフローおよびレガシーエージェントアプリケーション API DashScope API リファレンス」ドキュメントを参照して、API リクエストを構築して送信します。
よくある質問
Q： RAM サブアカウントとして「ワークスペース管理」ページにアクセスしようとすると、なぜエラーが発生するのですか？
A： このページへのアクセスには、スーパー管理者権限が必要です。このページを表示するには、スーパー管理者である必要があります。