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

E-MapReduce

Copy page
Download PDF
User group management
UpdateClusterUserGroup - Update cluster user group
Copy page
Download PDF
UpdateClusterUserGroup - Update cluster user group

Update cluster user group

Debug

request parameters

The following table lists only the request parameters specific to this API and some common parameters. For more information, see common parameters.

const columns = [ 
  { 
    width: '20%', 
title: 'Parameter', 
    dataIndex: 'Name', 
    className: 'openapi-doc-parameter-table-name' 
  }, 
  { 
    width: 130, 
title: 'Type', 
    dataIndex: 'DataType', 
    className: 'openapi-doc-parameter-table-type' 
  }, 
  { 
    width: 90, 
title: 'Required', 
    dataIndex: 'IsRequired', 
    className: 'openapi-doc-parameter-table-required' 
  }, 
  { 
    width: '20%', 
title: 'Example value', 
    dataIndex: 'Example', 
    className: 'openapi-doc-parameter-table-example' 
  }, 
  { 
title: 'Description', 
    dataIndex: 'Description', 
    className: 'openapi-doc-parameter-table-description' 
  }, 
]; 

const data = [ 
  { 
    rowKey: '->Action', 
    Name: 'Action', 
    DataType: 'String', 
IsRequired: 'Yes', 
    Example: <RenderMd content={"UpdateClusterUserGroup"} />, 
Description: <RenderMd content={"The operation to be performed. Value: UpdateClusterUserGroup."} />, 
    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: '->UserGroupName', 
    Name: 'UserGroupName', 
    DataType: 'String', 
IsRequired: 'Yes', 
    Example: <RenderMd content={"emr_usergroup"} />, 
Description: <RenderMd content={"User group name"} />, 
    children: [ 
    ] 
  }, 
  { 
    rowKey: '->Description', 
    Name: 'Description', 
    DataType: 'String', 
IsRequired: 'No', 
Example: <RenderMd content={"User group description"} />, 
Description: <RenderMd content={"User group description"} />, 
    children: [ 
    ] 
  }, 
  { 
    rowKey: '->Members', 
    Name: 'Members', 
    DataType: 'Array of String', 
IsRequired: 'No', 
    Example: <RenderMd content={"["emr_user"]"} />, 
Description: <RenderMd content={"Users included in the user group"} />, 
    children: [ 
    ] 
  }, 
  
]; 

return (<Table 
  rowKey="rowKey" 
  className="openapi-doc-parameter-table" 
  columns={columns} 
  data={data} 
  border={ { cell: true, wrapper: true } } 
  scroll={ { x: "auto" } } 
  pagination={false} 
/>);

response parameters

This API has no specific response parameters. For more information, see response structure.

sample request

POST /?Action=UpdateClusterUserGroup&Version=2023-08-15 HTTP/1.1 
Host: emr.cn-beijing.volcengineapi.com 
Content-Type: application/json; charset=UTF-8 
X-Date: 20240701T014138Z 
X-Content-Sha256: 287e874e******d653b44d21e 
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240701/cn-beijing/emr/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f 

{ 
  "ClusterId": "emr-xxx", 
  "UserGroupName": "emr_usergroup", 
"Description": "emr user group", 
  "Members": [ 
    "emr_user" 
  ] 
}

sample response

{ 
  "ResponseMetadata": { 
    "RequestId": "20240701094202027037132149C4CFE3", 
    "Action": "UpdateClusterUserGroup", 
    "Version": "2023-08-15", 
    "Service": "emr", 
    "Region": "cn-beijing" 
  }, 
  "Result": null 
}

error codes

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

Status code
Error code
Error message
Note
400
InvalidClusterId
cluster id {clusterId} not found

Cluster does not exist

400
USER.UserGroupNameNotExist
User group {usergroup} does not exist.

User group {0} does not exist

Last updated: 2026.06.01 17:04:20