すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud Linux:GetGpuClusterArgsOptions

最終更新日:Sep 15, 2026

GPU クラスターパラメーターのリストを取得します。

操作説明

対象の ACK クラスターにコンポーネントをインストールした後:

  1. まず、クラスターの管理を開始する最初のタイミングで、現在クラスター内に存在するすべての ECS インスタンスにコンポーネントがインストールされます。クラスターのノード数が 50 を超える場合、最初のバッチでは 50 個のインスタンスのみが対象となります。

  2. その後、オペレーティングシステムコンソールは管理対象クラスターのスケーリングステータスを定期的に確認します。新しい ECS インスタンスがクラスターに追加されると、ユーザーの操作を必要とせず、オペレーティングシステムコンソールによってコンポーネントが自動的にインストールされます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

GET /api/v1/aiTopology/topology/listClusterTopologyOptions HTTP/1.1

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

filterType

string

必須

  1. クラスターのインスタンスリストを照会します。 取得タイプを comm_instance_id_list または instance_id_list に設定します。 comm_instance_id_list: 指定されたクラスターで集合通信に参加するインスタンスのみを取得します。 instance_id_list: 指定されたクラスター内のすべてのインスタンスを取得します。

  2. クラスターの AI タスクリストを照会します。 取得タイプを comm_task_id_list または task_id_list に設定します。 comm_task_id_list: 指定されたクラスターで集合通信を含むタスクのみを取得します。 task_id_list: 指定されたクラスター内のすべてのタスクを取得します。

  3. クラスターの AI タスク Pod リストを照会します。 取得タイプを comm_pod_list または pod_list に設定します。 comm_pod_list: 指定されたクラスターで集合通信に参加する Pod のみを取得します。 pod_list: 指定されたクラスター内のすべての Pod を取得します。

  4. 集合通信トポロジーを照会します。 communication: すべての通信グループ ID を取得します。 channel: 指定された通信グループ ID の下のチャンネルリストを取得します。 topoType: 指定された通信グループ ID の指定されたチャンネルの下のトポロジータイプを取得します。

インスタンス ID リスト

filterValues

any

任意

フィルター条件。値は JSON オブジェクトです。cluster_id (クラスター) フィールドは必須です。以下のオプションのフィルター条件のリストがサポートされています (インスタンス、タスク、チャンネルなどの条件を含みます):

  • instance_id_list

  • comm_instance_id_list

  • pod_list

  • comm_pod_list

  • communication

  • task_id_list

  • comm_task_id_list

  • channel

  • topoType

{ "cluster_id": "クラスター1" }

レスポンスフィールド

フィールド

型

説明

例

object

応答のスキーマ。

code

string

応答コード。有効な値: Success、Sysom.ServerError。

Success Fail

data

any

パラメーター取得の結果。

["インスタンス1", "インスタンス2"]

message

string

コードが Success ではない場合に返されるエラーメッセージ。

失敗時はエラーメッセージ、成功時は ""

requestId

string

リクエストの ID。

実際のリクエスト ID

total

integer

返されるエントリの総数。

10

例

成功レスポンス

JSONJSON

{
  "code": "Success  Fail",
  "data": "[\"instance1\", \"instance2\"]",
  "message": "some error msg while fail,“” if success",
  "requestId": "return real request id",
  "total": 10
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 Sysom.ServerError Server error, please correct the code according to the error message. %s.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。