如何调用ListNodeGroups API查询集群下的节点分组-人工智能平台 PAI-阿里云-人工智能平台 PAI(PAI)-阿里云帮助中心

查询集群下的节点分组信息。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

eflo:ListNodeGroups

list

*Cluster

acs:eflo:{#regionId}:{#accountId}:cluster/{#ClusterId}

无

请求参数

名称	类型	必填	描述	示例值
NodeGroupId	string	否	节点组 id	ng-ec3c96ff0aa4c60d
NextToken	string	否	下一页的 NextToken，请求下一页时带上此返回值	a3f2224a5ec7224116c4f5246120abe4
ClusterId	string	否	集群 id	i119982311660892626523
MaxResults	integer	否	分页查询时每页行数。最大值为 100。默认值： •当不设置值或设置的值小于 20 时，默认值为 20。 •当设置的值大于 100 时，默认值为 100。	20

返回参数

名称	类型	描述	示例值
	object
RequestId	string	Id of the request	887FA855-89F4-5DB3-B305-C5879EC480E6
NextToken	string	下一页的 NextToken，请求下一页时带上此返回值	563d42ae0b17572449ec8c97f7f66069
Groups	array<object>	集群分组信息
	object
ClusterId	string	集群 id	i113952461729854708648
ClusterName	string	集群名称	wzq-exclusivelite-71
CreateTime	string	创建时间	2024-02-27T13:16:31.599
Description	string	描述	created by ga2_prepare
GroupId	string	组 ID。	238276221
GroupName	string	组名称。	backend-group
ImageId	string	镜像 id	i194015071707321240258
ImageName	string	镜像名称	CentOS_7.9_x86_64_FULL_20221110
MachineType	string	机型	efg1.nvga1n
NodeCount	integer	节点数	2
UpdateTime	string	更新时间	2023-09-22T00:03:05.114
ZoneId	string	可用区 id	cn-shenzhen-c
FileSystemMountEnabled	boolean	是否支持文件存储挂载
VirtualGpuEnabled	boolean	是否支持 GPU 虚拟化切分	false

示例

正常返回示例

JSON格式

{
  "RequestId": "887FA855-89F4-5DB3-B305-C5879EC480E6",
  "NextToken": "563d42ae0b17572449ec8c97f7f66069",
  "Groups": [
    {
      "ClusterId": "i113952461729854708648",
      "ClusterName": "wzq-exclusivelite-71",
      "CreateTime": "2024-02-27T13:16:31.599",
      "Description": "created by ga2_prepare",
      "GroupId": "238276221",
      "GroupName": "backend-group",
      "ImageId": "i194015071707321240258",
      "ImageName": "CentOS_7.9_x86_64_FULL_20221110",
      "MachineType": "efg1.nvga1n",
      "NodeCount": 2,
      "UpdateTime": "2023-09-22T00:03:05.114",
      "ZoneId": "cn-shenzhen-c",
      "FileSystemMountEnabled": true,
      "VirtualGpuEnabled": false
    }
  ]
}

错误码

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

变更历史

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