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

E-MapReduce

Copy page
Download PDF
User management
UpdateClusterUser - Modify information of an existing user
Copy page
Download PDF
UpdateClusterUser - Modify information of an existing user

Modify information of an existing user

Debug

request parameters

The table below 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={"UpdateClusterUser"} />, 
Description: <RenderMd content={"The operation to be performed. Value: UpdateClusterUser."} />, 
    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={"EMR cluster ID"} />, 
    children: [ 
    ] 
  }, 
  { 
    rowKey: '->UserName', 
    Name: 'UserName', 
    DataType: 'String', 
IsRequired: 'Yes', 
    Example: <RenderMd content={"emr_user"} />, 
Description: <RenderMd content={"Cluster username (modification not supported)\n"} />, 
    children: [ 
    ] 
  }, 
  { 
    rowKey: '->UserGroupNames', 
    Name: 'UserGroupNames', 
    DataType: 'Array of String', 
IsRequired: 'No', 
    Example: <RenderMd content={"["emr_usergroup"]"} />, 
Description: <RenderMd content={"User groups to which the user belongs"} />, 
    children: [ 
    ] 
  }, 
  { 
    rowKey: '->Description', 
    Name: 'Description', 
    DataType: 'String', 
IsRequired: 'No', 
Example: <RenderMd content={"User description"} />, 
Description: <RenderMd content={"User remarks"} />, 
    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 table below lists only the response parameters specific to this API. For more information, see response structure.

Parameter
Type
Example value
Description
Result
String

null

Update user information

sample request

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

sample response

{ 
  "ResponseMetadata": { 
    "RequestId": "2024070110342609912124619718B8A1", 
    "Action": "UpdateClusterUser", 
    "Version": "2023-08-15", 
    "Service": "emr", 
    "Region": "cn-beijing" 
  }, 
  "Result": 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.

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

Cluster does not exist

400
USER.UserNameNotExist
User {user} not exists

User does not exist

Last updated: 2026.06.01 17:04:20