You need to enable JavaScript to run this app.
导航
E-MapReduce
  • 文档首页
    • /
  • E-MapReduce

ListNodes - 节点列表

最近更新时间：2024.01.22 15:49:38

首次发布时间：2024.01.22 15:49:38

我的收藏

节点列表查询

使用说明

调用 ListNodes，获取一个 E-MapReduce（EMR）集群节点列表。

注意事项

已拥有火山引擎账号并开通 EMR 权限。

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com/?Version=2023-08-15&Action=ListNodes

调试

API Explorer
您可以通过API Explorer在线发起调用，无需关注签名生成过程，快速获取调用结果。
去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数
类型
是否必填
示例值
描述
Action
String
是

ListNodes

要执行的操作，取值：ListNodes

Version
String
是

2023-08-15

API的版本，取值：2023-08-15

ClusterId
String
是

emr-xxx

集群ID

NodeIds
Array of String
否

["core-1-2.emr-xxx"]

节点ID列表

NodeNames
Array of String
否

["core-1-2.emr-xxx"]

节点名称列表

NodeStates
Array of String
否

["RUNNING"]

节点状态列表

PrivateIps
Array of String
否

["xxx"]

节点私网IP列表

PublicIps
Array of String
否

["xxx"]

公网IP列表

MaxResults
Integer
否

10

返回的最大记录数

NextToken
String
否

46FOxxx

分页查询的下一页token

Fqdns
Array of String
否

["core-1-2.emr-xxx.offline-cn-beijing.emr-volces.com"]

Fqdns列表

NodeGroupIds
Array of String
否

["core-1.emr-xxx"]

节点组ID列表

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数
类型
示例值
描述
ClusterId
String

emr-xxx

集群ID

NodeGroupId
String

core-1.emr-xxx

节点组ID

NodeId
String

core-1-2.emr-xxx

节点ID

NodeName
String

core-1-2.emr-xxx

节点名称

NodeState
String

UNKNOWN,//未知状态
CREATING,//创建中
RUNNING, //运行中
STOPPING, //停止中
STOPPED, //已停止
REBOOTING, //重启中
DELETED; 已删除

节点状态

NodeFqdn
String

core-1-2.emr-xxx.offline-cn-beijing.emr-volces.com

节点fqdn

PrivateIp
String

["xxx"]

内网IP

PublicIp
String

["xxx"]

公网IP

EcsInstanceType
String

ecs.g3i.2xlarge

ecs实例规格

CreateTime
Long

7553422

创建时间

ReadyTime
Long

7553422

准备完毕时间

TerminateTime
String

7553422

集群终止时间

请求示例

{
   "ClusterId":"emr-xxx",
   "NodeId": ["master-1-1.emr-xxx"]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20231205192346B3E08B8D2Fxxx",
        "Action": "ListNodes",
        "Version": "2023-08-15",
        "Service": "emr",
        "Region": "cn-beijing",
        "Error": null,
        "Deprecated": false
    },
    "Result": {
        "Items": [
            {
                "ClusterId": "emr-xxx",
                "NodeGroupId": null,
                "NodeId": "task-1-1.emr-xxx",
                "NodeName": "task-1-1.emr-xxx",
                "NodeState": "CREATING",
                "NodeFqdn": "task-1-1.emr-xxx.offline-cn-beijing.emr-volces.com",
                "PrivateIp": "xxx",
                "PublicIp": null,
                "EcsInstanceType": "ecs.g3i.2xlarge",
                "CreateTime": null,
                "ReadyTime": null,
                "TerminateTime": null
            },
            {
                "ClusterId": "emr-xxx",
                "NodeGroupId": "core-1.emr-xxx",
                "NodeId": "core-1-2.emr-xxx",
                "NodeName": "core-1-2.emr-xxx",
                "NodeState": "RUNNING",
                "NodeFqdn": "core-1-2.emr-xxx.offline-cn-beijing.emr-volces.com",
                "PrivateIp": "xxx",
                "PublicIp": null,
                "EcsInstanceType": "ecs.g3i.2xlarge",
                "CreateTime": null,
                "ReadyTime": null,
                "TerminateTime": null
            },
            {
                "ClusterId": "emr-xxx",
                "NodeGroupId": "core-1.emr-xxx",
                "NodeId": "core-1-1.emr-xxx",
                "NodeName": "core-1-1.emr-xxx",
                "NodeState": "RUNNING",
                "NodeFqdn": "core-1-1.emr-xxx.offline-cn-beijing.emr-volces.com",
                "PrivateIp": "xxx",
                "PublicIp": null,
                "EcsInstanceType": "ecs.g3i.2xlarge",
                "CreateTime": null,
                "ReadyTime": null,
                "TerminateTime": null
            },
            {
                "ClusterId": "emr-xxx",
                "NodeGroupId": "master-1.emr-xxx",
                "NodeId": "master-1-1.emr-xxx",
                "NodeName": "master-1-1.emr-xxx",
                "NodeState": "RUNNING",
                "NodeFqdn": "master-1-1.emr-xxx.offline-cn-beijing.emr-volces.com",
                "PrivateIp": "xxx",
                "PublicIp": "xxx",
                "EcsInstanceType": "ecs.c3i.4xlarge",
                "CreateTime": null,
                "ReadyTime": null,
                "TerminateTime": null
            }
        ],
        "TotalCount": 4,
        "MaxResults": 10,
        "NextToken": "46FOSv9T/1W1lVvcgDm1XQ=="
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

HttpCode
错误码
错误信息
说明
400
InvalidClusterId
cluster id {clusterId} not found

集群不存在

400
InvalidRequest
Access Denied {clusterId}

对该集群没有权限