CreateClusterUser - 创建集群用户--E-MapReduce-火山引擎

文档中心

立即注册

导航

E-MapReduce

CreateClusterUser - 创建集群用户

最近更新时间：2024.07.24 15:19:57首次发布时间：2024.07.24 15:19:57

创建集群用户

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	CreateClusterUser	要执行的操作，取值：CreateClusterUser。
Version	String	是	2023-08-15	API的版本，取值：2023-08-15。
ClusterId	String	是	emr-xxx	集群ID
UserName	String	是	emr_user	要新建的用户的名称。该参数只能由字母、数字、下划线（_）、"."、"-"组成，最多支持64字符
Password	String	是	Password123!	要新建的用户的登录密码。密码的长度需在8-20个字符之间，支持数字，字母，-，_ 且至少包含1个数字和1个字母。
UserGroupNames	Array of String	否	["emr_usergroup"]	需要绑定用户组（用户组名称只能以字母开头，后跟零个或多个字母、数字或下划线组成的字符串，最多支持64字符）
Description	String	否	用户描述	要新建的用户的备注信息

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

POST /?Action=CreateClusterUser&Version=2023-08-15 HTTP/1.1
Host: open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20240701T024443Z
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",
  "UserName": "emr_user",
  "Password": "Password123!"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202407011045060872172181073BB6B5",
    "Action": "CreateClusterUser",
    "Version": "2023-08-15",
    "Service": "emr",
    "Region": "cn-beijing"
  },
  "Result": null
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidClusterId	cluster id {clusterId} not found	集群不存在
400	USER.InvalidUserName	Invalid username. The username can only contain letters, numbers, and underscores (_) and can have a maximum of 64 characters.	非法用户名，用户名由字母、数字、下划线（_）组成，最多支持64位字符
400	USER.InvalidPassword	Illegal user password. The password must be between 8-30 characters in length and can only contain numbers 0~9, uppercase letters A~Z, lowercase letters a~z, special characters~!@#$%^&*() _-=+\|{}[]:;'<>,.?/, and contains at least three of them, and the password cannot start with "/" or "$6$"	非法用户密码，密码的长度需在8-30个字符之间，只能包含数字0～9，大写字母A～Z，小写字母a～z，特殊字符~!@#$%^&*()_-=+\|{}[]:;'<>,.?/，且至少包含其中三项，同时密码不能以"/"、"$6$"开头
400	USER.InvalidDescription	Invalid description content. The description can have a maximum of 180 characters.	非法描述内容，描述最多支持180位字符