全部产品
Search
文档中心

Alibaba Cloud Linux:GetGpuClusterArgsOptions - 获取GPU资源拓扑选项参数API

更新时间:Sep 14, 2026

获取GPU集群参数列表

接口说明

为目标 ACK 集群安装组件后:

  1. 首先,初次纳管集群,会为集群当前包含的所有 ECS 安装组件(如果集群节点超过 50 台,第一批次只会安装 50 台);

  2. 其次,操作系统控制台会周期性的检查被纳管集群的扩缩容情况,一旦有新的 ECS 被添加到集群中,操作系统控制台会为其自动安装组件无需用户干预。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

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 下的指定通道下的拓扑类型

instance_id_list

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": "cluster1" }

返回参数

名称

类型

描述

示例值

object

Schema of Response

code

string

code 为'Success'或'Sysom.ServerError'

Success Fail

data

any

返回参数获取结果

["instance1", "instance2"]

message

string

code 不为'Success'时,message 为出错信息

some error msg while fail,“” if success

requestId

string

Id of the request

return real request id

total

integer

返回数量

10

示例

正常返回示例

JSON格式

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

错误码

HTTP status code

错误码

错误信息

描述

400 Sysom.ServerError Server error, please correct the code according to the error message. %s. 服务端错误,请根据错误提示信息修正代码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。