ListFreeHyperNodes - 查询可用超节点列表_人工智能平台 PAI(PAI)-阿里云帮助中心

可用rack物理机列表。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

eflo:ListFreeHyperNodes

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
NextToken	string	否	查询凭证（Token），取值为上一次 API 调用返回的 NextToken 参数值。	a3f2224a5ec7224116c4f5246120****
MaxResults	integer	否	分页查询时每页行数。最大值为 100。默认值： •当不设置值或设置的值小于 20 时，默认值为 20。 •当设置的值大于 100 时，默认值为 100。	20
MachineType	string	否	机型	efg1.nvga1
HpnZone	string	否	集群编号	A1
ResourceGroupId	string	否	资源组 id	rg-aekzyqdwnfabx6q
Tags	array<object>	否	标签列表
	object	否	标签信息
Key	string	否	标签 key	my_key
Value	string	否	标签值。	129
Status	array	否	返回的未使用节点状态列表
	string	否	返回的未使用节点状态	Unused

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 id	A511C02A-0127-51AA-A9F9-966382C9A1B5
HyperNodes	array<object>	节点列表
	array<object>
ZoneId	string	可用区 id	cn-wulanchabu-a
CreateTime	string	创建时间	2025-08-06T10:11:41.569
HyperNodeId	string	节点 id	e01-cn-7pp2x193801
MachineType	string	机型	efg2.ks01L20Z2
ExpireTime	string	机器过期时间	2025-01-22T23:59:59Z
HpnZone	string	集群编号	A1
ResourceGroupId	string	资源组 ID	rg-acfmwaateahzoii
CommodityCode	string	商品码	bccluster_eflocomputing_public_cn
Tags	array<object>	标签列表
	object	标签信息
Key	string	标签键	Cpu_Usage
Value	string	标签值。	on
Status	string	超节点状态	Using
Hostname	string		alywlcb-lingjun-gpu-0025
NextToken	string	本次调用返回的查询凭证值。	563d42ae0b17572449ec8c97f7f66069
MaxResults	integer	分页查询时每页行数。最大值为 100。默认值： •当不设置值或设置的值小于 20 时，默认值为 20。 •当设置的值大于 100 时，默认值为 100。	20

示例

正常返回示例

JSON格式

{
  "RequestId": "A511C02A-0127-51AA-A9F9-966382C9A1B5",
  "HyperNodes": [
    {
      "ZoneId": "cn-wulanchabu-a",
      "CreateTime": "2025-08-06T10:11:41.569",
      "HyperNodeId": "e01-cn-7pp2x193801",
      "MachineType": "efg2.ks01L20Z2",
      "ExpireTime": "2025-01-22T23:59:59Z",
      "HpnZone": "A1",
      "ResourceGroupId": "rg-acfmwaateahzoii",
      "CommodityCode": "bccluster_eflocomputing_public_cn",
      "Tags": [
        {
          "Key": "Cpu_Usage",
          "Value": "on"
        }
      ],
      "Status": "Using",
      "Hostname": "alywlcb-lingjun-gpu-0025"
    }
  ],
  "NextToken": "563d42ae0b17572449ec8c97f7f66069",
  "MaxResults": 20
}

错误码

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

变更历史

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