调用ListClusterNodes查询集群节点列表_人工智能平台 PAI(PAI)-阿里云帮助中心

查询集群节点列表。

调试

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

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
eflo:ListClusterNodes	get	*Cluster `acs:eflo:{#regionId}:{#accountId}:cluster/{#clusterId}`	无	无

请求参数

名称	类型	必填	描述	示例值
ClusterId	string	是	集群 ID。	i15b480fbd2fcdbc2869cd80
NextToken	string	否	查询凭证（Token），取值为上一次 API 调用返回的 NextToken 参数值。	AAAAAdQ3Z+oPlg49gsr2y8jb6wY=
MaxResults	long	否	分页查询时每页行数，默认值为 20。	20
NodeGroupId	string	否	节点组 ID。	ng-ec3c96ff0aa4c60d
Tags	array<object>	否	标签信息
	object	否	标签信息
Key	string	否	节点标签键值	my_key
Value	string	否	节点标签的值	my_value
ResourceGroupId	string	否	资源组 ID	rg-ksld39333ss

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	2BA76272-6608-5AEC-BBA8-B6F0D3D14CDB
NextToken	string	本次调用返回的查询凭证值。	AAAAAXW/ZB9TBvH+0ZK0phtCibQgQmu1RbqplAI6Velo2OKR
Nodes	array<object>	节点列表。
Nodes	object	节点信息
CreateTime	string	创建时间。	1642472468000
ExpiredTime	string	机器过期时间。	1762185600000
Hostname	string	主机名。	72432f80-273e-11ed-b57a-acde48001122
ImageId	string	系统镜像 ID。	i190297201669099844192
MachineType	string	机型。	cn-wulanchabu-b11
NodeGroupId	string	节点组 ID。	ng-e9b74f4d450cf18d
NodeGroupName	string	节点组名称。	emr_master
NodeId	string	节点 ID。	e01-cn-2r42tmj4z02
OperatingState	string	节点状态。枚举值： Extending：扩容中。 UnusedNodeStopped：未使用节点停服中。 UnusedNodeStopping：未使用节点停服处理中。 Unused：未使用。 Using：使用中。 ReleaseLocking：待释放。 Operating：操作中。 Cutting：缩容中。 ClusterNodeStopped：集群节点停服中。 UnusedNodeRecovering：未使用节点恢复中。 ClusterNodeStopping：集群节点停服处理中。 ClusterNodeRecovering：未使用节点恢复中。 Replacing：替换中。	Extending
Sn	string	机器 SN。	sn_tOuUk
ZoneId	string	可用区 ID。	cn-hangzhou-b
Networks	array<object>	网络信息。
Networks	object	网络信息
BondName	string	机器网口名称。	bond0
Ip	string	专有网络内的机器 IP。	192.168.22.2
SubnetId	string	专有网络子网 ID。	subnet-fwekrvg9
VpdId	string	专有网络 ID。	vpd-eoiy88ju
HpnZone	string	集群编号。	A1
VpcId	string	专有网络 ID	vpc-f8zcet5mwerafyqlrhyoi
VSwitchId	string	专有网络交换机 ID	vsw-0jlohur7nhbxd1ttyq8p8
Tags	array<object>	标签信息
标签信息	object	标签对象
Key	string	标签 key	alarm_xdc
Value	string	标签 value	true
TaskId	string	任务 ID	i-skkdsdl83ksxxs3
CommodityCode	string	商品码	bccluster_eflocomputing_public_cn
ImageName	string	镜像名称	Alinux3_x86_gu8xf_P_Host_D3_C7E3_550.127_Legacy_N_241230

示例

正常返回示例

JSON格式

{
  "RequestId": "2BA76272-6608-5AEC-BBA8-B6F0D3D14CDB",
  "NextToken": "AAAAAXW/ZB9TBvH+0ZK0phtCibQgQmu1RbqplAI6Velo2OKR",
  "Nodes": [
    {
      "CreateTime": "1642472468000\n",
      "ExpiredTime": "1762185600000",
      "Hostname": "72432f80-273e-11ed-b57a-acde48001122",
      "ImageId": "i190297201669099844192",
      "MachineType": "cn-wulanchabu-b11",
      "NodeGroupId": "ng-e9b74f4d450cf18d",
      "NodeGroupName": "emr_master",
      "NodeId": "e01-cn-2r42tmj4z02",
      "OperatingState": "Extending",
      "Sn": "sn_tOuUk",
      "ZoneId": "cn-hangzhou-b",
      "Networks": [
        {
          "BondName": "bond0",
          "Ip": "192.168.22.2",
          "SubnetId": "subnet-fwekrvg9",
          "VpdId": "vpd-eoiy88ju"
        }
      ],
      "HpnZone": "A1",
      "VpcId": "vpc-f8zcet5mwerafyqlrhyoi",
      "VSwitchId": "vsw-0jlohur7nhbxd1ttyq8p8",
      "Tags": [
        {
          "Key": "alarm_xdc",
          "Value": "true"
        }
      ],
      "TaskId": "i-skkdsdl83ksxxs3",
      "CommodityCode": "bccluster_eflocomputing_public_cn",
      "ImageName": "Alinux3_x86_gu8xf_P_Host_D3_C7E3_550.127_Legacy_N_241230"
    }
  ]
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2023-09-21	OpenAPI 返回结构发生变更	查看变更详情