调用ListFreeNodes获取未使用节点列表_人工智能平台 PAI(PAI)-阿里云帮助中心

查询未使用节点列表。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

eflo:ListFreeNodes

get

*Node

acs:eflo:{#regionId}:{#accountId}:node/*

无

请求参数

名称	类型	必填	描述	示例值
NextToken	string	否	查询凭证（Token），取值为上一次 API 调用返回的 NextToken 参数值。	a3f2224a5ec7224116c4f5246120abe4
MaxResults	integer	否	分页查询时每页行数，默认值为 20。	20
MachineType	string	否	机型枚举值： efg1.nvga1 : efg1.nvga1 efg1.nvga1n : efg1.nvga1n efg1.nvga4 : efg1.nvga4 efg2.C48cA3sen : efg2.C48cA3sen efg2.56NHmcn : efg2.56NHmcn efg1.nvga8n : efg1.nvga8n efg2.C48cNHmcn : efg2.C48cNHmcn	mock-machine-type2
HpnZone	string	否	集群编号	A1
ResourceGroupId	string	否	资源组 id 枚举值： rg-acfmvqmpwbwecli : rg-acfmvqmpwbwecli rg-acfm25os62qi5fq : rg-acfm25os62qi5fq rg-acfmoiyerhvhrvq : rg-acfmoiyerhvhrvq rg-acfmwaateahzoii : rg-acfmwaateahzoii rg-acfmwfm33rlt6zi : rg-acfmwfm33rlt6zi rg-acfm2zkwhkns57i : rg-acfm2zkwhkns57i	rg-acfmxno4vh5muoq
Tags	array<object>	否	标签信息
	object	否	标签信息
Key	string	否	标签 key	my_key
Value	string	否	标签 value	129
OperatingStates	array	否	表示返回的未使用节点类型
	string	否	表示返回的未使用节点类型 *：匹配所有类型未使用 Unused 使用中 Using 扩容中 Extending 缩容中 Cutting 操作中 Operating 未使用节点停服中 UnusedNodeStopping 未使用节点已停服 UnusedNodeStopped 未使用节点维修审批停服中 UnusedNodeApprovalPendingRenew 未使用节点维修停服中 UnusedNodeRepairingPendingRenew 集群节点停服中 ClusterNodeStopping 集群节点已停服 ClusterNodeStopped 集群节点维修待审批已停服 ClusterNodeApprovalPendingRenew 集群节点维修已停服 ClusterNodeRepairingPendingRenew 未使用节点恢复中 UnusedNodeRecovering 集群节点恢复中 ClusterNodeRecovering 待释放 ReleaseLocking 释放中 Releasing 诊断中 Diagnosing 跨 ASI 集群切换中 Switching 集群节点维修恢复中 RecoveringClusterNode 集群节点维修预处理 PreparationForRepairingClusterNode 未使用节点维修恢复中 RecoveringUnusedNode 未使用节点维修预处理 PreparationForRepairingUnusedNode 集群节点维修中 ClusterNodeRepairing 未使用节点维修中 UnusedNodeRepairing 集群节点维修待审批 ClusterNodeRepairPendingApproval 未使用节点维修待审批中 UnusedNodeRepairPendingApproval 节点替换中 Replacing 软件恢复中 SoftwareRestoring 软件启动中 SoftwareInitializing 集群节点重启待审批 ClusterNodeRebootPendingApproval 集群节点关机中 ClusterNodeShuttingDown 集群节点已关机 ClusterNodeShutdown 集群关机节点停服中 ClusterNodeStoppingShutdown 集群关机节点已停服 ClusterNodeStoppedShutdown 集群关机节点维修待审批 ClusterNodeRepairPendingApprovalShutdown 集群关机节点维修预处理 PreparationForRepairingClusterNodeShutdown 集群关机节点维修中 ClusterNodeRepairingShutdown 集群关机节点维修待审批已停服 ClusterNodeApprovalPendingRenewShutdown 集群关机节点维修已停服 ClusterNodeRepairingPendingRenewShutdown 集群关机节点重启待审批 ClusterNodeRebootPendingApprovalShutdown 集群关机节点停服恢复中 ClusterNodeRecoveringShutdown 集群关机节点维修恢复上线中 RecoveringClusterNodeShutdown	Unused

返回参数

名称	类型	描述	示例值
	object	出参
RequestId	string	请求 id	AA14CB86-70C4-5CB7-9E7B-6CCA77F3512B
Nodes	array<object>	节点列表
	object	节点信息。
ZoneId	string	可用区 id	cn-hangzhou-j
CreateTime	string	创建时间	1652321554
NodeId	string	节点 id	e01-cn-7pp2x193801
MachineType	string	机型	efg1.nvga1
Sn	string	机器 sn	sn_pozkHBgicd
ExpiredTime	string	机器过期时间	1673107200
HpnZone	string	集群编号	A1
ResourceGroupId	string	资源组 id	rg-aekzkkbrpl4owgy
OperatingState	string	节点状态	Extending
CommodityCode	string	商品码	bccluster_eflocomputing_public_cn
Tags	array<object>	标签列表
	object	标签信息
Key	string	标签 key	alarm_xdc
Value	string	标签值。	true
HyperNodeId	string	超节点 ID	e01-cn-zvp2tgykr08
NextToken	string	本次调用返回的查询凭证值。	a3f2224a5ec7224116c4f5246120abe4

示例

正常返回示例

JSON格式

{
  "RequestId": "AA14CB86-70C4-5CB7-9E7B-6CCA77F3512B",
  "Nodes": [
    {
      "ZoneId": "cn-hangzhou-j",
      "CreateTime": "1652321554",
      "NodeId": "e01-cn-7pp2x193801",
      "MachineType": "efg1.nvga1",
      "Sn": "sn_pozkHBgicd",
      "ExpiredTime": "1673107200",
      "HpnZone": "A1",
      "ResourceGroupId": "rg-aekzkkbrpl4owgy",
      "OperatingState": "Extending",
      "CommodityCode": "bccluster_eflocomputing_public_cn",
      "Tags": [
        {
          "Key": "alarm_xdc",
          "Value": "true"
        }
      ],
      "HyperNodeId": "e01-cn-zvp2tgykr08"
    }
  ],
  "NextToken": "a3f2224a5ec7224116c4f5246120abe4"
}

错误码

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

变更历史

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