全部产品
Search
文档中心

Alibaba Cloud Linux:GetListGpuCluster - 获取GPU集群列表

更新时间:Sep 14, 2026

获取GPU集群列表

接口说明

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

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

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

调试

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

调试

授权信息

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

请求语法

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

请求参数

名称

类型

必填

描述

示例值

timeRegion

any

否

查询的时间范围,单位 ms,[start,end],如:[13254125000, 52451241000]

[1757820000, 1757823600]

regionId

string

否

要查询的目标 region-id

cn-hangzhou

返回参数

名称

类型

描述

示例值

object

返回体信息

code

string

code 为'Success'或'Sysom.ACKClusterNotFound'

Success

data

any

返回集群列表

["cluster1", "cluster2"]

message

string

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

success

requestId

string

Id of the request

1234567890

total

integer

返回数量

10

示例

正常返回示例

JSON格式

{
  "code": "Success",
  "data": "[\"cluster1\", \"cluster2\"]",
  "message": "success",
  "requestId": "1234567890",
  "total": 10
}

错误码

HTTP status code

错误码

错误信息

描述

400 Sysom.ServerError Server error, please correct the code according to the error message. %s. 服务端错误,请根据错误提示信息修正代码
400 Sysom.ACKClusterNotFound The specified ACK cluster was not found. %s. 指定的 ACK 集群未找到

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

变更历史

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