You need to enable JavaScript to run this app.
导航
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

调试

请求参数

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

参数
类型
是否必填
示例值
描述
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

集群不存在