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

E-MapReduce

Copy page
Download PDF
User group management
CreateClusterUserGroup - Create a cluster user group
Copy page
Download PDF
CreateClusterUserGroup - Create a cluster user group

Create a cluster user group

Debugging

request parameters

The following table lists only the unique request parameters for 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={"CreateClusterUserGroup"} />, 
Description: <RenderMd content={"The operation to be performed. Value: CreateClusterUserGroup."} />, 
    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={"User group members"} />, 
    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 unique response parameters. For more information, see response structure.

sample request

POST /?Action=CreateClusterUserGroup&Version=2023-08-15 HTTP/1.1 
Host: emr.cn-beijing.volcengineapi.com 
Content-Type: application/json; charset=UTF-8 
X-Date: 20240701T021738Z 
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"

sample response

{ 
  "ResponseMetadata": { 
    "RequestId": "2024070110175113408721519715AD55", 
    "Action": "CreateClusterUserGroup", 
    "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.InvalidUserName
Invalid username. The username can only contain letters, numbers, and underscores (_) and can have a maximum of 64 characters.

Invalid username. The username can only contain letters, numbers, and underscores (_), and supports up to 64 characters.

Last updated: 2026.06.01 17:04:20