ArkClaw 企业版
ArkClaw 企业版
文档指南
请输入
- 文档首页
ArkClaw 企业版ArkClaw 企业版开发者指南API 参考UserSeatQuotaListUserSeatUsages - 批量查询用户席位使用详情
复制全文
下载 pdfListUserSeatUsages - 批量查询用户席位使用详情
文档反馈
问问助手批量查询用户席位使用详情，包括席位类型等信息，帮助管理员掌握空间内的席位分配与使用概览。
请求参数
Action string 必选 示例值：ListUserSeatUsages
要执行的操作，取值：ListUserSeatUsages。
Version string 必选 示例值：2026-05-01
API的版本，取值：2026-05-01。
MaxResults integer 可选 示例值：20
分页查询时设置的每页行数。
- 最小值：1。
- 最大值：100。
- 默认值：20。
- 若传入非法MaxResults值，会被自动调整为默认值。
NextToken string 可选 示例值：Y2kteWVqMXJreTVma3F0YzM4e******
分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的NextToken参数值。
SpaceId string 必选 示例值：csi-yehw6ow1kwa5g0****
ArkClaw实例所属空间ID。可以在ArkClaw控制台“空间概览”页面的“基本信息”获取。
UserIds.N string[] 可选 示例值：UserIds.1=d4bc986c-6474-****&UserIds.2=45ecd46c-25e2-****
用户ID列表。
- 参数 - N：表示用户ID的序号，取值范围：1～100。
- 多个用户ID之间用&分隔。
- 传入的无效ID将被忽略。
返回参数
NextToken string 示例值：Y2kteWVqMXJreTVma3F0YzM4e******
本次调用返回的查询凭证值，返回为空表示该页为末页。
SeatUsages object[] 示例值：--
每个用户的席位使用详情。
Usages object[] 示例值：--
用户的席位使用详情。
Count integer 示例值：197
已占用的席位数量。
SeatType string 示例值：Starter
ArkClaw席位类型。取值：
- Starter：轻量版。
- Standard：标准版。
- Premium：高级版。
- Ultimate：旗舰版。
UserId string 示例值：d4bc986c-6474-****
用户ID。
请求示例
返回示例
错误码
状态码 | 错误码 | 错误信息 | 说明 |
400 | InvalidNextToken.Malformed | The specified NextToken is malformed. | 无效的NextToken。 |
400 | InvalidUserIds.Malformed | The specified parameter UserIds is invalid. | UserIds 必须是非空字符串数组，且不能包含空字符串。 |
400 | LimitExceeded.MaximumUserIds | The number of UserIds exceeds the maximum allowed limit. | UserIds 的数量超过了允许的最大限制。 |
400 | MissingParameter.SpaceId | The required parameter SpaceId is not supplied. | 参数SpaceId不能为空。 |
404 | InvalidSpace.NotFound | The specified space does not exist. | 指定的ClawSpace不存在。 |
429 | FlowLimitExceeded | The request was rejected due to flow control. | 请求触发限流。 |
500 | InternalError | An internal error has occurred. | 内部错误，请重试。如果多次尝试失败，请提交工单。 |
最近更新时间：2026.06.29 18:59:57
这个页面对您有帮助吗？
有用
有用
无用
无用