更新沙箱出站允许列表¶
替换 limited 沙箱的工具及额外出站端点允许列表。操作会改变后续联网行为,提交时需包含要保留的列表。
PATCH https://api.moi.matrixorigin.cn/v5/agent-sandboxes/{sandbox_id}/network
调用前准备¶
准备目标工作区的个人访问令牌与相应操作权限;环境、令牌、工作区和沙箱 ID 保持一致。公共对象和结果确认说明资源身份、字段及状态。示例的资源值须替换为实际值。
请求¶
curl -X PATCH "https://api.moi.matrixorigin.cn/v5/agent-sandboxes/$SANDBOX_ID/network" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
-H 'Content-Type: application/json' \
--data-binary '{"network_tools":["git"],"egress_endpoints":[{"host":"example.com","ports":[443]}]}'
字段 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
string |
路径必填 |
目标 limited 沙箱 ID。 |
|
string(字符串数组) |
否 |
完整期望工具列表;省略/null/[] 均清空该工具列表。 |
|
object(对象数组) |
否 |
完整期望额外端点列表;省略/null/[] 均清空。 |
这里的 PATCH 替换两份 MOI 管理的列表,不是仅更新出现的字段。和创建时空工具采用默认值不同;省略一份列表会清除它。默认控制通道和其他独立管理规则不由这两个字段删除。该请求没有可更新的 network_mode 字段,也不能把 unrestricted 改为 limited;unrestricted 的允许列表更新会被拒绝。范围与格式见公共网络说明。
成功响应¶
{
"code": "OK",
"msg": "OK",
"data": {
"id": "sbx-example",
"workspace_id": "workspace-example",
"user_id": "user-example",
"name": "audit-runner",
"phase": "ready",
"edge_agent_id": "sbx-example",
"network_mode": "limited",
"network_tools": [
"git"
],
"egress_endpoints": [
{
"host": "example.com",
"ports": [
443
]
}
],
"spec": "medium",
"disk_gi": 10,
"created_at": "2026-11-11T08:00:00Z",
"updated_at": "2026-11-11T08:00:00Z",
"update_available": null
}
}
HTTP 200 的数据含义如下;示例值不是默认配置。
字段 |
类型 |
说明 |
|---|---|---|
|
string |
成功时为 OK。 |
|
string |
响应说明。 |
|
object |
更新后的沙箱与列表。 |
结果确认¶
读取返回值和详情核对策略;必要时验证真实目标访问。服务出错会尝试恢复原策略,但不能把错误响应当作已保证恢复;保存原设置便于核查。
错误处理¶
按 HTTP 状态及响应 code 判断;公共错误与恢复区分参数、权限、配额、提供商和结果未知。错误不证明尚未产生资源,也不能当成重试或清理已经完成。
最后更新于