更新工作区沙箱配额¶
更新有管理权限的工作区沙箱配额及临时沙箱自动分配策略。设置上限不会删除已有资源。
PATCH https://api.moi.matrixorigin.cn/v5/agent-sandboxes/quota
调用前准备¶
准备目标工作区的个人访问令牌与相应操作权限;环境、令牌、工作区和沙箱 ID 保持一致。公共对象和结果确认说明资源身份、字段及状态。示例的资源值须替换为实际值。
请求¶
curl -X PATCH "https://api.moi.matrixorigin.cn/v5/agent-sandboxes/quota" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
-H 'Content-Type: application/json' \
--data-binary '{"max_managed_count":0,"auto_ephemeral":"inherit"}'
字段 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
integer |
否 |
0~100;0 可用于停止继续分配托管沙箱。 |
|
integer |
否 |
0~100;临时沙箱分配上限。 |
|
string |
否 |
inherit、enabled 或 disabled,分别继承部署设置、启用或禁用自动临时分配。 |
至少提交一个有效字段;省略或 null 保持原值,显式 0 必须保留。请求字符串策略与响应数值 override 使用不同表示,见字段表。更改上限只影响后续准入,不是终止或删除当前沙箱的操作。
成功响应¶
{
"code": "OK",
"msg": "OK",
"data": {
"workspace_id": "workspace-example",
"max_managed_count": 0,
"max_ephemeral_count": 10,
"auto_ephemeral_override": 0,
"updated_by": "user-example",
"updated_at": "2026-11-11T08:00:00Z"
}
}
HTTP 200 的数据含义如下;示例值不是默认配置。
字段 |
类型 |
说明 |
|---|---|---|
|
string |
成功时为 OK。 |
|
string |
响应说明。 |
|
string |
当前工作区 ID。 |
|
integer |
保存的托管上限。 |
|
integer |
保存的临时上限。 |
|
integer |
0 继承、1 显式启用、2 显式禁用。 |
|
string |
最后更新者 ID。 |
|
string |
更新时间,RFC 3339。 |
结果确认¶
检查返回配置与当前托管占用。override:0 仅表示继承,不能单凭它判断部署默认自动策略的最终值。
错误处理¶
按 HTTP 状态及响应 code 判断;公共错误与恢复区分参数、权限、配额、提供商和结果未知。错误不证明尚未产生资源,也不能当成重试或清理已经完成。