GPU クラスターのトポロジーを取得します。
操作説明
対象の Container Service for Kubernetes (ACK) クラスターにコンポーネントをインストールした後：
クラスターを初めて管理する場合、コンポーネントをクラスター内の現在あるすべての ECS インスタンスにインストールします。クラスターに 50 を超えるノードが存在する場合、最初のバッチでは最初の 50 ノードのみを処理します。
オペレーティングシステムのコンソールは、管理対象クラスターのスケーリング状態を定期的にチェックします。新しい ECS インスタンスがクラスターに追加されると、コンソールは手動での介入を必要とせず、自動的にコンポーネントをインストールします。
今すぐお試しください
テスト
RAM 認証
リクエスト構文
GET /api/v1/aiTopology/topology/clusterTopology HTTP/1.1リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| clusterId |
string |
必須 |
クラスター名。GetListGpuCluster API によって返されるクラスターリストからクラスターを選択します。 |
"cluster1" |
| startTime |
string |
任意 |
クエリのタイムスタンプ。デフォルトは現在時刻です。秒単位のタイムスタンプである必要があります。 |
1709740800 |
| instanceIdList |
any |
任意 |
指定したインスタンスリストの GPU トポロジー情報。 |
["instance1", "instance2","instance3"] |
| podList |
any |
任意 |
指定した Pod リストの GPU トポロジー情報。 |
["pod1", "pod2","pod3"] |
| taskIdList |
any |
任意 |
指定したタスク ID に関連するノードの GPU トポロジー情報。 |
["task1", "task2"] |
| communicationId |
string |
任意 |
集合通信トポロジーを表示する際に使用します。指定した通信グループ ID のトポロジー関係 (通信グループ内のランク間通信トポロジー (ツリー トポロジーまたはリングトポロジー) など) を指定します。 ⚠️ GetGpuClusterArgsOptions API の通信フィルタータイプを使用して、 |
communicationId =0x412523235123 channelId=1 topoType=ring |
| channelId |
string |
任意 |
集合通信トポロジーを表示する際に使用します。通信グループ内の指定したチャネル ID のトポロジー関係 (ランク間通信トポロジー (ツリー トポロジーまたはリングトポロジー) など) を指定します。 ⚠️ GetGpuClusterArgsOptions API のチャネルフィルターパラメーターを使用して、指定した |
communicationId =0x412523235123 channelId=1 topoType=ring |
| topoType |
string |
任意 |
集合通信トポロジーを表示する際に使用します。通信グループとチャネル内の指定したトポロジータイプのトポロジー関係 (ランク間通信トポロジー (ツリー トポロジーまたはリングトポロジー) など) を指定します。 ⚠️ GetGpuClusterArgsOptions API の topoType フィルターパラメーターを使用して、指定した |
communicationId =0x412523235123 channelId=1 topoType=ring |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスボディ。 |
||
| code |
string |
結果コード。有効な値： |
Fail/Success |
| data |
object |
操作によって返されるデータ。 |
|
| data |
object |
クラスター トポロジーのデータ構造。 |
|
| edges |
any |
トポロジー構造内のエッジデータ。 |
"edges": [ { "type": "GPU", "src_id": "00534a88", "dst_id": "260525e9", "values": { "Exception": [ { "key": "NCCL HANG", "value": "error0" } ], "Metric": [ { "key": "a", "value": "372201199012283428" } ], "Basic": [ { "key": "NCCL Version", "value": "v2.22.3" } ] }, "style": { "lineWidth": "0.01", "opacity": "1", "selectedStyle": "\"{\\\"opacity\\\": 1, \\\"lineWidth\\\": 1}\"", "stroke": "#e94242\n" } } ] |
| nodes |
any |
トポロジー構造内のノードデータ。 |
"nodes": [ { "id": "i-xxxxxx", "name": "i-xxxxxx", "gpu_list": [ { "id": "6cc37fbc", "name": "GPU0", "style": { "fill": "#e94242", "opacity": "0.1" }, "values": { "Metric": [ { "key": "0", "value": "gpu_util(%)" } ], "Basic": [ { "key": "1", "value": "Gpu Number" } ], "Exception": [ { "key": "NCCL HANG", "value": "error0" } ] } } ], "style": { "fillOpacity": "0.5", "fill": "#e94242" }, "values": { "Exception": [ { "key": "NCCL HANG", "value": "error0" } ], "Basic": [ { "key": "podList", "value": "podname1" } ], "Metric": [ { "key": "instance", "value": "i-xxxxxx" } ] } } ], |
| total |
integer |
返された GPU カードの総数。 |
36 |
| message |
string |
|
some error msg if not success，“” if success |
| requestId |
string |
リクエスト ID。 |
return real request ID |
例
成功レスポンス
JSONJSON
{
"code": "Fail/Success\n",
"data": {
"data": {
"edges": " \"edges\": [\n {\n \"type\": \"GPU\",\n \"src_id\": \"00534a88\",\n \"dst_id\": \"260525e9\",\n \"values\": {\n \"Exception\": [\n {\n \"key\": \"NCCL HANG\",\n \"value\": \"error0\"\n }\n ],\n \"Metric\": [\n {\n \"key\": \"a\",\n \"value\": \"372201199012283428\"\n }\n ],\n \"Basic\": [\n {\n \"key\": \"NCCL Version\",\n \"value\": \"v2.22.3\"\n }\n ]\n },\n \"style\": {\n \"lineWidth\": \"0.01\",\n \"opacity\": \"1\",\n \"selectedStyle\": \"\\\"{\\\\\\\"opacity\\\\\\\": 1, \\\\\\\"lineWidth\\\\\\\": 1}\\\"\",\n \"stroke\": \"#e94242\\n\"\n }\n }\n ]",
"nodes": "\"nodes\": [\n {\n \"id\": \"i-xxxxxx\",\n \"name\": \"i-xxxxxx\",\n \"gpu_list\": [\n {\n \"id\": \"6cc37fbc\",\n \"name\": \"GPU0\",\n \"style\": {\n \"fill\": \"#e94242\",\n \"opacity\": \"0.1\"\n },\n \"values\": {\n \"Metric\": [\n {\n \"key\": \"0\",\n \"value\": \"gpu_util(%)\"\n }\n ],\n \"Basic\": [\n {\n \"key\": \"1\",\n \"value\": \"Gpu Number\"\n }\n ],\n \"Exception\": [\n {\n \"key\": \"NCCL HANG\",\n \"value\": \"error0\"\n }\n ]\n }\n }\n ],\n \"style\": {\n \"fillOpacity\": \"0.5\",\n \"fill\": \"#e94242\"\n },\n \"values\": {\n \"Exception\": [\n {\n \"key\": \"NCCL HANG\",\n \"value\": \"error0\"\n }\n ],\n \"Basic\": [\n {\n \"key\": \"podList\",\n \"value\": \"podname1\"\n }\n ],\n \"Metric\": [\n {\n \"key\": \"instance\",\n \"value\": \"i-xxxxxx\"\n }\n ]\n }\n }\n ],"
},
"total": 36
},
"message": "some error msg if not success，“” if success",
"requestId": "return real request ID"
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | Sysom.ServerError | Server error, please correct the code according to the error message. %s. | |
| 400 | Sysom.InvalidParameter | Invalid parameters passed when calling the interface. %s. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。