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

CreateNodeGroup - 创建节点组

最近更新时间：2024.04.16 16:47:34

首次发布时间：2024.01.22 15:48:39

我的收藏

创建节点组

使用场景

调用 CreateNodeGroup，创建一个 E-MapReduce（EMR）集群的一个节点组。

注意事项

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

请求说明

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

调试

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

请求参数

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

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

CreateNodeGroup

要执行的操作，取值：CreateNodeGroup。

Version
String
是

2023-08-15

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

ClusterId
String
是

emr-xxx

ClusterId

ZoneId
String
否

cn-beijing-b

zoneId，为空时默认复用集群的zoneId

NodeGroupName
String
是

test-group

节点组名称

NodeGroupType
String
是

TASK

节点组类型

NodeCount
Integer
是

1

节点数量。取值范围：1~1000

WithPublicIp
Boolean
否

false

ecs是否附带公网ip

ChargeType
String
是

POST

付费类型

EcsInstanceTypes
Array of String
是

["ecs.g3i.2xlarge"]

ecs的实力规格列表

SubnetIds
Array of String
否

["subnet-xxx"]

子网id列表

SystemDisk
SystemDisk
是

{
"VolumeType": "ESSD_FlexPL",
"Size": 80
}

系统盘

DataDisks
Array of DataDisk
是

[
{
"VolumeType": "ESSD_FlexPL",
"Size": 80,
"Count": 1
}
]

数据盘，具体参考创建集群时的数据盘约束

ApplicationLayouts
Array of ApplicationLayout
否

[{
"ApplicationName": "HDFS",
"LayoutComponentNames": ["NMAENODE","DATANODE"]
}]

当前节点组可布局的组件名称列表

ClientToken
String
否

xxx

调用方生成的唯一标识这次请求的标识，用来保证幂等

返回参数

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

参数
类型
示例值
描述
ClusterId
String

emr-xxx

集群ID

OperationId
String

Order7xxx

集群操作ID

请求示例

{
    "RequestId":null,
    "RegionId":"cn-beijing",
    "UserId":5xxx,
    "AccountId":210xxx,
    "ClusterId":"emr-xxx",
    "NodeGroupName":"createNodeGroup-test",
    "NodeGroupType":"TASK",
    "ChargeType":"POST",
    "EcsInstanceTypes":[
                "ecs.g2i.2xlarge"
            ],
    "SystemDisk":{
                "Size":120,
                "VolumeType":"ESSD_PL0"
    },
    "DataDisks":[
                {
                    "Size":80,
                    "VolumeType":"ESSD_PL0",
                    "Count":1
                }
            ],
    "NodeCount":1
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202312042119240BF21498512xxx",
        "Action": "CreateNodeGroup",
        "Version": "2023-08-15",
        "Service": "emr",
        "Region": "cn-beijing",
        "Error": null,
        "Deprecated": false
    },
    "Result": {
        "OperateId": "xxx",
        "ClusterId": "emr-xxx",
        "ResultData": "task-1.emr-xxx"
    }   
}

错误码

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

状态码
错误码
错误信息
说明
400
InvalidRequest
Access Denied {clusterId}

对该集群没有权限

400
InvalidClusterId
cluster id {clusterId} not found

集群不存在