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

E-MapReduce

Copy page
Download PDF
User group management
GetClusterUserGroups - Cluster user group details
Copy page
Download PDF
GetClusterUserGroups - Cluster user group details

Cluster user group details

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={"GetClusterUserGroups"} />, 
Description: <RenderMd content={"The operation to be performed. Value: GetClusterUserGroups."} />, 
    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: '->UserGroupNames', 
    Name: 'UserGroupNames', 
    DataType: 'Array of String', 
IsRequired: 'Yes', 
    Example: <RenderMd content={"["emr_usergroup"]\n\n"} />, 
Description: <RenderMd content={"User group name"} />, 
    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

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

Parameter
Type
Example value
Description
Items
Array of Object

[
{
"ClusterId": "emr-xxx",
"UserGroupName": "emr_usergroup",
"Description": "emr用户组",
"Members": [
"emr_user"
]
}
]

User group details

sample request

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

sample response

{ 
  "ResponseMetadata": { 
    "RequestId": "2024071716185520704402009795159A", 
    "Action": "GetClusterUserGroups", 
    "Version": "2023-08-15", 
    "Service": "emr", 
    "Region": "cn-beijing" 
  }, 
  "Result": { 
    "Items": [ 
      { 
        "ClusterId": "emr-xxx", 
        "UserGroupName": "emr_usergroup", 
"Description": "emr用户组", 
        "Members": [ 
          "emr_user" 
        ] 
      } 
    ] 
  } 
}

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 does not exist

Last updated: 2026.06.01 17:04:20