文档中心

ArkClaw 企业版

UserSeatQuota

UpdateUserSeatQuotas - 批量更新用户级席位配额

批量更新用户级席位配额。

请求参数

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

Action string 必选示例值：UpdateUserSeatQuotas

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

Version string 必选示例值：2026-05-01

API的版本，取值：2026-05-01。

Quotas object[] 必选示例值：{"Quotas":[{"SeatType":"Premium","Quota":100},{"SeatType":"Starter","Quota":20}]}

填写需要更新的席位类型和对应配额。

不能为空，最大长度为 4，即最多覆盖四种席位类型，至少支持更新一种席位类型。

如果同一种席位类型填写了多条互相冲突的配额，请求会失败，请修正后重试。

SeatType string 必选示例值：Starter

ArkClaw实例席位类型。取值：

Starter：轻量版。

Standard：标准版。

Premium：高级版。

Ultimate：旗舰版。

Quota string 必选示例值：10

席位配额值。设置后将覆盖当前配置，单位为席位数。

取值须大于等于0。

取值不能超过当前Space下对应席位类型的最大配额限制。

UserIds string[] 必选示例值：["93b84820****", "37e87775****"]

目标用户ID。不能为空，最大长度为 100。

SpaceId string 必选示例值：csi-yei8347ta8xmf5qd****

ArkClaw实例所属空间ID。可以在ArkClaw控制台“空间概览”页面的“基本信息”获取。

返回参数

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

OperationDetails object[] 示例值：{"OperationDetails":[{"UserId":"user-xxx1"},{"UserId":"user-xxx2","Error":{"Code":"InvalidUser.NotFound","Message":"The specified User does not exist."}}]}

逐用户、逐席位类型席位更新处理结果。

UserId string 示例值：93b84820****

用户ID。

Error object 示例值：{"OperationDetails":[{"UserId":"user-xxx1"},{"UserId":"user-xxx2","Error":{"Code":"InvalidUser.NotFound","Message":"The specified User does not exist."}}]}

单个用户结果项处理失败时返回的错误描述，主要用于展示和排查问题；成功时为空或不返回。

Code string 示例值：InvalidUser.NotFound

错误码。

Message string 示例值：The specified User does not exist.

错误信息。

请求示例

POST /?Action=UpdateUserSeatQuotas&Version=2026-05-01 HTTP/1.1​
Host: arkclaw.cn-beijing.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260527T032636Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260527/cn-beijing/arkclaw/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
  "Quotas": [​
    {​
      "SeatType": "Starter",​
      "Quota": "10"​
    }​
  ],​
  "UserIds": [​
    "93b84820****",​
    "37e87775****"​
  ],​
  "SpaceId": "csi-yei8347ta8xmf5qd****"​
}​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "20260527112733****",​
        "Action": "UpdateUserSeatQuotas",​
        "Version": "2026-05-01",​
        "Service": "arkclaw",​
        "Region": "cn-beijing"​
    },​
    "Result": {​
        "OperationDetails": [{​
            "UserId": "93b84820****",​
            "Error": null​
        },​
        {​
            "UserId": "37e87775****",​
            "Error": {​
                "Code": "InvalidUser.NotFound",​
                "Message": "The specified User does not exist."​
            }​
        }]​
    }​
}​

错误码

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

状态码	错误码	错误信息	说明
400	InvalidQuota.Malformed	The specified parameter Quota is invalid.	Quotas.Quota 必须是大于等于 0 的整数。该错误仅表示参数格式或基础取值域非法，不用于表达已用席位约束等业务资源限制。
400	InvalidQuotas.Malformed	The specified parameter Quotas is invalid.	Quotas 必须是对象数组，数组长度不能超过 4，且不能存在重复或冲突的 SeatType。
400	InvalidSeatType.Malformed	The specified parameter SeatType is invalid.	参数SeatType不合法。
400	InvalidUserIds.Malformed	The specified parameter UserIds is invalid.	UserIds 必须是非空字符串数组，且不能包含空字符串。
400	LimitExceeded.MaximumSeatQuota	The number of specified seat quota exceeds the maximum limit.	指定的Quota值过大。
400	LimitExceeded.MaximumUserIds	The number of UserIds exceeds the maximum allowed limit.	UserIds 的数量超过了允许的最大限制。
400	LimitExceeded.UsedQuota	The requested quota cannot be less than the currently used seat count.	指定的Quota值低于当前已使用量。
400	MissingParameter.Quota	The required parameter Quota is not supplied.	参数Quota不能为空。
400	MissingParameter.Quotas	The required parameter Quotas is not supplied.	参数Quotas不能为空。
400	MissingParameter.SeatType	The required parameter SeatType is not supplied.	参数SeatType不能为空。
400	MissingParameter.SpaceId	The required parameter SpaceId is not supplied.	参数SpaceId不能为空。
400	MissingParameter.UserIds	The required parameter UserIds is not supplied.	参数UserIds不能为空。
404	InvalidSpace.NotFound	The specified space does not exist.	指定的ClawSpace不存在。
404	InvalidUser.NotFound	The specified User does not exist.	指定的用户不存在。
429	FlowLimitExceeded	The request was rejected due to flow control.	请求触发限流。
500	InternalError	An internal error has occurred.	内部错误，请重试。如果多次尝试失败，请提交工单。

最近更新时间：2026.06.16 22:27:08

这个页面对您有帮助吗？

有用

无用