ArkClaw 企业版
ArkClaw 企业版
文档指南
请输入
- 文档首页
ArkClaw 企业版ArkClaw 企业版开发者指南API 参考UserSeatQuotaListUserSeatQuotas - 批量查询用户席位配额详情
复制全文
下载 pdfListUserSeatQuotas - 批量查询用户席位配额详情
文档反馈
问问助手批量查询用户席位配额详情。
请求参数
Action string 必选 示例值：ListUserSeatQuotas
要执行的操作，取值：ListUserSeatQuotas。
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******
本次调用返回的查询凭证值，返回为空表示该页为末页。
SeatQuotas object[] 示例值：--
每个用户的席位配额信息。
Quotas object[] 示例值：--
用户的席位配额信息。
Quota integer 示例值：267
该席位类型的最终生效配额。
SeatType string 示例值：Starter
ArkClaw实例席位类型。取值：
- Starter：轻量版。
- Standard：标准版。
- Premium：高级版。
- Ultimate：旗舰版。
UserId string 示例值：d4bc986c-6474-****
用户ID。
请求示例
GET /?Action=ListUserSeatQuotas&Version=2026-05-01&MaxResults=20&NextToken=Y2kteWVqMXJreTVma3F0YzM4e******&SpaceId=csi-yehw6ow1kwa5g0****&UserIds.1=d4bc986c-6474-****&UserIds.2=45ecd46c-25e2-**** HTTP/1.1
Host: https://arkclaw.cn-beijing.volcengineapi.com
X-Date: 20260624T100242Z
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260624/cn-beijing/arkclaw/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f
返回示例
{
"ResponseMetadata": {
"RequestId": "20260624180245187030****",
"Action": "ListUserSeatQuotas",
"Version": "2026-05-01",
"Service": "arkclaw",
"Region": "cn-beijing"
},
"Result": {
"NextToken": "Y2kteWVqMXJreTVma3F0YzM4e******",
"SeatQuotas": [
{
"Quotas": [
{ "SeatType": "Starter", "Quota": 267 },
{ "SeatType": "Standard", "Quota": 0 },
{ "SeatType": "Premium", "Quota": 0 },
{ "SeatType": "Ultimate", "Quota": 1 }
],
"UserId": "d4bc986c-6474-****"
},
{
"Quotas": [
{ "SeatType": "Starter", "Quota": 53 },
{ "SeatType": "Standard", "Quota": 3 },
{ "SeatType": "Premium", "Quota": 0 },
{ "SeatType": "Ultimate", "Quota": 0 }
],
"UserId": "45ecd46c-25e2-****"
}
]
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
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
这个页面对您有帮助吗？
有用
有用
无用
无用