ScaleOutNodeGroup - 扩容节点组--E-MapReduce-火山引擎

文档中心

E-MapReduce

节点组管理

ScaleOutNodeGroup - 扩容节点组

扩容节点组

使用说明

调用 ScaleOutNodeGroup，扩容一个 E-MapReduce（EMR）集群的一个节点组。

注意事项

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

请求说明

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

调试

API Explorer

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

去调试

请求参数

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

参数	类型	是否必填	示例值	描述
Action	String	是	ScaleOutNodeGroup	要执行的操作，取值：ScaleOutNodeGroup。
Version	String	是	2023-08-15	API的版本，取值：2023-08-15。
ClientToken	String	否	xxx	调用方生成的唯一标识这次请求的标识，用来保证幂等
ClusterId	String	是	emr-xxx	集群ID
NodeGroupId	String	是	core-1.emr-xxx	节点组ID
ScaleOutNodeCount	Integer	是	1	待扩容的节点数量
ElasticScheduledInstanceType	String	否	ESI	弹性预约实例类型，取值：ESI（默认）：弹性预约实例 Segmented：弹性预约实例-时段型
ElasticScheduledInstanceDeliveryType	String	否	Immediate	弹性预约实例-时段型交付类型，取值： Reserve（默认）：预约交付 Immediate：立即交付说明: 仅ElasticScheduledInstanceType取值为Segmented时，需传入该参数。
ElasticScheduledInstanceAutoReleaseAt	String	否	2023-03-29T17:50:00+08:00	实例自动释放时间，必须为10分钟整点。当ElasticScheduledInstanceType取值为Segmented时，需传入该参数，取值范围： DeliveryType取值为Reserve时，实例最早释放时间为预约的交付时间段+1小时。 DeliveryType取值为Immediate时，实例最早释放时间为当前时间的下一个整十分钟时间点。例如当前时间5:02，则最早自动释放时间为5:20。
ElasticScheduledInstanceEndDeliveryAt	String	否	2023-03-29T17:50:00+08:00	预约付费实例的付费设置,实例结束交付时间，必须为10分钟整点，且与StartDeliveryAt的间隔时间为10分钟。当chargeType=SCHEDULED时，必填
ElasticScheduledInstanceStartDeliveryAt	String	否	2023-03-29T17:50:00+08:00	预约付费实例的交付起始时间设置,实例开始交付时间，必须为10分钟整点。当chargeType=SCHEDULED时，必填

返回参数

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

参数	类型	示例值	描述
ClusterId	String	emr-xxx	集群ID
OperationId	String	emr-xxx	集群操作ID
ResultData	Object	null	返回结果

请求示例

{
    "RequestId":null,
    "RegionId":"cn-beijing",
    "UserId":5xxx,
    "AccountId":21000xxx,
    "ClientToken":"12xxx",
    "ClusterId":"emr-xxx",
    "NodeGroupId":"core-1.emr-xxx",
    "ScaleOutNodeCount":3
}

返回示例

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

错误码

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

状态码	错误码	错误信息	说明
400	InvalidClusterId	cluster id {clusterId} not found	集群不存在
400	InvalidRequest	Access Denied {clusterId}	对该集群没有权限

最近更新时间：2026.03.23 11:22:03

这个页面对您有帮助吗？

有用

无用

E-MapReduce

使用说明 #

注意事项 #

请求说明 #

调试 #

请求参数 #

返回参数 #

请求示例 #

返回示例 #

错误码 #