You need to enable JavaScript to run this app.
E-MapReduce

E-MapReduce

Copy page
Download PDF
Node group management
UpdateNodeGroupChargeType - Update node group charge type
Copy page
Download PDF
UpdateNodeGroupChargeType - Update node group charge type

Update node group charge type

Note

Call UpdateNodeGroupChargeType to modify the charge type of a node group in an E-MapReduce (EMR) cluster.

important notes

You must have a Volcano Engine account and have enabled EMR permissions.

Note

Request method: POST
Request URL: https://emr.cn-beijing.volcengineapi.com/?Version=2023-08-15&Action=UpdateNodeGroupChargeType

Debug

request parameters

The table below lists only the unique request parameters for this API and some common parameters. For more information, see common parameters.

const columns = [ 
  { 
    width: '9%', 
title: 'Parameter', 
    dataIndex: 'Name', 
  }, 
  { 
    width: '9%', 
title: 'Type', 
    dataIndex: 'DataType', 
  }, 
  { 
    width: '9%', 
title: 'Required', 
    dataIndex: 'IsRequired', 
  }, 
  { 
    width: '18%', 
title: 'Example value', 
    dataIndex: 'Example', 
  }, 
  { 
    width: '55%', 
title: 'Description', 
    dataIndex: 'Description', 
  }, 
]; 

const data = [ 
  { 
    rowKey: '->Action', 
    Name: 'Action', 
    DataType: 'String', 
IsRequired: 'Yes', 
    Example: <RenderMd content={"UpdateNodeGroupChargeType"} />, 
Description: <RenderMd content={"Operation to be performed. Value: UpdateNodeGroupChargeType"} />, 
    children: [ 
    ] 
  }, 
  { 
    rowKey: '->Version', 
    Name: 'Version', 
    DataType: 'String', 
IsRequired: 'Yes', 
    Example: <RenderMd content={"2023-08-15"} />, 
Description: <RenderMd content={"API version. Value: 2023-08-15"} />, 
    children: [ 
    ] 
  }, 
  { 
    rowKey: '->ClusterId', 
    Name: 'ClusterId', 
    DataType: 'String', 
IsRequired: 'Yes', 
    Example: <RenderMd content={"emr-xxx"} />, 
Description: <RenderMd content={"Cluster ID"} />, 
    children: [ 
    ] 
  }, 
  { 
    rowKey: '->NodeGroupIds', 
    Name: 'NodeGroupIds', 
    DataType: 'Array of String', 
IsRequired: 'Yes', 
    Example: <RenderMd content={"["task-1.emr-xxx"]"} />, 
Description: <RenderMd content={"List of node group IDs"} />, 
    children: [ 
    ] 
  }, 
  { 
    rowKey: '->ChargeType', 
    Name: 'ChargeType', 
    DataType: 'String', 
IsRequired: 'Yes', 
    Example: <RenderMd content={"PRE"} />, 
Description: <RenderMd content={"Charge type of the node group"} />, 
    children: [ 
    ] 
  }, 
  { 
    rowKey: '->ChargePreConfig', 
    Name: 'ChargePreConfig', 
    DataType: 'ChargePreConfig', 
IsRequired: 'No', 
    Example: <RenderMd content={"xxx"} />, 
Description: <RenderMd content={"Configuration for subscription billing"} />, 
    children: [ 
        { 
          rowKey: '->ChargePreConfig->ChargeType', 
          Name: 'ChargeType', 
          DataType: 'String', 
IsRequired: 'Yes', 
          Example: <RenderMd content={""} />, 
Description: <RenderMd content={"Charge type, enumerated value."} />, 
          children: [ 
          ] 
        }, 
        { 
          rowKey: '->ChargePreConfig->ChargePeriodUnit', 
          Name: 'ChargePeriodUnit', 
          DataType: 'String', 
IsRequired: 'No', 
          Example: <RenderMd content={""} />, 
Description: <RenderMd content={"When chargeType=PRE, default value=Month. Unit for subscription duration, enumerated value."} />, 
          children: [ 
          ] 
        }, 
        { 
          rowKey: '->ChargePreConfig->ChargePeriod', 
          Name: 'ChargePeriod', 
          DataType: 'Integer', 
IsRequired: 'No', 
          Example: <RenderMd content={""} />, 
Description: <RenderMd content={"When chargeType=PRE, default value=1. Unit for subscription duration."} />, 
          children: [ 
          ] 
        }, 
        { 
          rowKey: '->ChargePreConfig->AutoRenew', 
          Name: 'AutoRenew', 
          DataType: 'Boolean', 
IsRequired: 'No', 
          Example: <RenderMd content={""} />, 
Description: <RenderMd content={"Whether to enable auto-renewal"} />, 
          children: [ 
          ] 
        }, 
        { 
          rowKey: '->ChargePreConfig->AutoRenewPeriodUnit', 
          Name: 'AutoRenewPeriodUnit', 
          DataType: 'String', 
IsRequired: 'No', 
          Example: <RenderMd content={""} />, 
Description: <RenderMd content={"Unit for renewal duration when auto-renewal is triggered. When autoRenew=true, default value=Month."} />, 
          children: [ 
          ] 
        }, 
        { 
          rowKey: '->ChargePreConfig->AutoRenewPeriod', 
          Name: 'AutoRenewPeriod', 
          DataType: 'Integer', 
IsRequired: 'No', 
          Example: <RenderMd content={""} />, 
Description: <RenderMd content={"Renewal duration when auto-renewal is triggered. When autoRenew=true, default value=1."} />, 
          children: [ 
          ] 
        }, 
    ] 
  }, 
  { 
    rowKey: '->ClientToken', 
    Name: 'ClientToken', 
    DataType: 'String', 
IsRequired: 'No', 
    Example: <RenderMd content={"xxx"} />, 
Description: <RenderMd content={"Unique identifier generated by the caller for this request, used to ensure idempotency."} />, 
    children: [ 
    ] 
  }, 
  
]; 

return (<Table 
  rowKey="rowKey" 
  columns={columns} 
  data={data} 
  border={ { cell: true, wrapper: true } } 
  pagination={false} 
/>);

response parameters

The table below lists only the unique response parameters for this API. For more information, see response structure

Parameter
Type
Example value
Description
ClusterId
String

emr-xxxx

Cluster ID

OperationId
String

xxx

Cluster operation ID

sample request

{ 
    "RequestId":null, 
    "RegionId":"cn-beijing", 
    "UserId":5xxx, 
    "AccountId":2xxx, 
    "ClusterId":"emr-xxx", 
    "NodeGroupName":"CoreGroup-test", 
    "NodeGroupId":"core-1.emr-xxx" 
}

sample response

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

error codes

The table below lists the error codes related to the business logic of this API. For common error codes, see the common error codes documentation.

HttpCode
Error code
Error message
Note
400
IllegalOperationForCluster
The cluster id {clusterId} does not support the operation

Illegal operation. This cluster does not support this operation.

400
InvalidClusterId
cluster id {clusterId} not found

Cluster does not exist.

400
InvalidRequest
Access Denied {clusterId}

No permission for this cluster.

Last updated: 2026.06.01 17:04:20