You need to enable JavaScript to run this app.
文档中心
文档备案控制台
E-MapReduce

E-MapReduce

请输入
  • 文档首页
    • E-MapReduceAPI 参考EMR on ECS API参考用户管理ListClusterUsers - 获取集群用户列表
复制全文
下载 pdf
我的收藏
用户管理
ListClusterUsers - 获取集群用户列表
复制全文
下载 pdf
我的收藏
ListClusterUsers - 获取集群用户列表

获取集群用户列表

调试

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

请求参数

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

参数
类型
是否必填
示例值
描述
Action
String
是

ListClusterUsers

要执行的操作，取值：ListClusterUsers。

Version
String
是

2023-08-15

API的版本，取值：2023-08-15。

ClusterId
String
是

emr-xxx

集群ID

UserName
String
否

emr_user

集群用户名

Keyword
String
否

emr

关键字，用户名称模糊匹配

UserGroupName
String
否

emr_usergroup

集群用户组名

CreateorName
String
否

creator

创建者名称

UserNameOrder
String
否

ASC，DESC

用户名排序方式

CreateTimeOrder
String
否

ASC，DESC

用户创建时间排序方式

UpdateTimeOrder
String
否

ASC，DESC

用户更新时间排序方式

UserNames
Array of String
否

["emr_user"]

批量查询使用

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数
类型
示例值
描述
items
Array of Object

[
{
"ClusterId": "emr-xxx",
"UserName": "emr_user",
"Description": "用户描述",
"CreatorId": "12345678",
"CreatorName": "creator",
"UserGroupNames": [
"emr_usergroup"
]
}
]

用户集群信息

请求示例 

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

{
  "ClusterId": "emr-xxx"
}

返回示例 

{
  "ResponseMetadata": {
    "RequestId": "202407081019341630311861572E4666",
    "Action": "ListClusterUsers",
    "Version": "2023-08-15",
    "Service": "emr",
    "Region": "cn-beijing"
  },
  "Result": {
    "Items": [
      {
        "ClusterId": "emr-xxx",
        "UserName": "emr_user",
        "Description": "用户描述",
        "CreatorId": "12345678",
        "CreatorName": "creator"
      }
    ]
  }
}

错误码

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

状态码
错误码
错误信息
说明
400
InvalidClusterId
cluster id {clusterId} not found

集群不存在

最近更新时间：2025.09.25 15:24:56
这个页面对您有帮助吗？
有用
有用
无用
无用