文档中心

AI 数据湖服务

数据集权限

ListUsersForGroup - 查询用户组下的用户列表

查询用户组下的用户列表

调试

API Explorer

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

去调试

请求参数

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

Action string 必选示例值：ListUsersForGroup

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

Version string 必选示例值：2025-08-15

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

UserGroupName string 必选示例值：example_group

用户组名

NextToken string 可选示例值：nextToken

下一次查询起始Id（不包含）或页码（默认为0）

MaxResults integer 可选示例值：10

单页记录数

返回参数

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

Users object[] 示例值：---

授权对象列表

Id long 示例值：112233

用户ID

UserName string 示例值：zhangsan

用户名

请求示例

POST /?Action=ListUsersForGroup&Version=2025-08-15 HTTP/1.1​
Host: open.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260121T121440Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260121/cn-beijing/las/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
  "UserGroupName": "example_group",​
  "NextToken": "nextToken",​
  "MaxResults": 10​
}​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "2026012120144306123319323032DFA8",​
    "Action": "ListUsersForGroup",​
    "Version": "2025-08-15",​
    "Service": "las",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "Users": [​
      {​
        "Id": 112233,​
        "UserName": "zhangsan"​
      }​
    ]​
  }​
}​

错误码

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

状态码	错误码	错误信息	说明
400	MissingParameter	The required parameter {} is missing.	缺少必需的参数 {}。
400	InvalidParameter	The specified parameter {} is invalid.	指定的参数 {} 无效。
400	InvalidRequestParam	Invalid request param {}, cause {}	非法请求参数 {}, 原因 {}
400	DryRunOperation	The request is validated by a dryrun operation.	该请求通过 dryrun 操作进行验证。
400	IllegalArgument	非法参数	非法参数
500	InternalError	The request has failed due to an unknown error.	由于未知错误，请求失败。

最近更新时间：2026.07.30 19:19:05

这个页面对您有帮助吗？

有用

无用