ArkClaw 企业版
ArkClaw 企业版
ArkClaw 企业版
文档指南
请输入
ArkClaw 企业版
产品动态
ArkClaw性能说明
员工使用ArkClaw
管理Agent
ArkClaw快捷功能
Hermes Agent
ArkClaw高级功能
管理 ArkClaw 实例
查看 ArkClaw 详情
管理 ArkClaw 插件与连接器
管理企业服务智能体
员工观测ArkClaw
管理员管理ArkClaw
Claw 实例
管理席位下的 Claw 实例
用户管理
网络管理
公网出口
私网出口
安全管理
管理员观测ArkClaw
管理员批量运维ArkClaw
最佳实践
开发者指南
API 参考
ClawSpace
Template
ClawInstance
Image
UserManagement
UserSeatQuota
PrivateEgressService
ArkClaw
产品动态
控制台操作指南
管理 Agent
使用技巧
快捷功能
Hermes Agent
管理 ArkClaw
观测 ArkClaw
常见问题
- 文档首页
ArkClaw 企业版ArkClaw 企业版开发者指南API 参考ClawInstanceDeleteClawInstances - 批量删除ArkClaw实例
复制全文
下载 pdfDeleteClawInstances - 批量删除ArkClaw实例
文档反馈
问问助手批量删除ArkClaw实例。
请求参数
Action string 必选 示例值：DeleteClawInstances
要执行的操作，取值：DeleteClawInstances。
Version string 必选 示例值：2026-05-01
API的版本，取值：2026-05-01。
InstanceIds string[] 必选 示例值：[ci-yemjf738cgwr0****,ci-yem8ac2vi8hxvx****]
- 单次操作至少传入1个，最多传入100个。
- 若传入重复ID，系统将自动去重，不可为空。
Recycle boolean 可选 示例值：true
是否移入回收站。取值：
- true（默认）：将实例移入回收站。
- false：永久删除实例，不可恢复。
SpaceId string 必选 示例值：csi-yei8347ta8xmf5qd****
ArkClaw实例所属空间ID。可以在ArkClaw控制台“空间概览”页面的“基本信息”获取。
ClientToken string 可选 示例值：23fa21A8823nfasd7f****
保证请求幂等性。由客户端自动生成一个参数值，确保不同请求间该参数值唯一，避免当调用API超时或服务器内部错误时，客户端多次重试导致重复性操作。
取值：仅支持ASCII字符，且不能超过64个字符。
DryRun boolean 可选 示例值：true
是否仅做参数和权限检查而不实际执行操作。取值：
- true：仅做检查，校验通过返回DryRunOperation错误码。
- false（默认）：实际执行操作。
返回参数
OperationDetails object[] 示例值：--
每个实例的操作结果列表。
Error object 示例值：--
单个实例的报错信息，成功时为空。
Code string 示例值：InternalError
错误码。
Message string 示例值：internal error
错误信息。
InstanceId string 示例值：ci-yenklf05q8a9xf1s****
ArkClaw实例ID。
请求示例
POST /?Action=DeleteClawInstances&Version=2026-05-01 HTTP/1.1
Host: https://arkclaw.cn-beijing.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20260703T093118Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260703/cn-beijing/arkclaw/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f
{
"InstanceIds": [
"ci-yemjf738cgwr0****",
"ci-yem8ac2vi8hxvx****"
],
"Recycle": true,
"SpaceId": "csi-yei8347ta8xmf5qd****",
"ClientToken": "23fa21A8823nfasd7f****",
"DryRun": true
}
返回示例
{
"ResponseMetadata": {
"RequestId": "2026070317313613****",
"Action": "DeleteClawInstances",
"Version": "2026-05-01",
"Service": "arkclaw",
"Region": "cn-beijing"
},
"Result": {
"OperationDetails": [
{
"Error": {
"Code": "InternalError",
"Message": "internal error"
},
"InstanceId": "ci-yemjf738cgwr0****"
},
{
"Error": null,
"InstanceId": "ci-yem8ac2vi8hxvx****"
}
]
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
状态码 | 错误码 | 错误信息 | 说明 |
400 | MissingParameter.SpaceId | The required parameter SpaceId is not supplied. | 参数SpaceId不能为空。 |
400 | MissingParameter.InstanceIds | The required parameter InstanceIds is not supplied. | 参数InstanceIds不能为空。 |
400 | LimitExceeded.MaximumInstanceIds | The number of specified InstanceIds exceeds the maximum limit. | InstanceIds数量超过最大限制。 |
400 | InvalidClientToken.Malformed | The specified ClientToken is malformed. | 指定的ClientToken不合法。 |
400 | IdempotentParameterMismatch | The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical. | 幂等参数不一致。 |
404 | InvalidSpace.NotFound | The specified Space does not exist. | 指定ArkClaw空间不存在。 |
412 | IdempotentProcessing | The request uses the same client token as a previous one that is still in process. | 先前的幂等请求仍在处理中，请稍后重试。 |
最近更新时间：2026.07.17 17:50:16
这个页面对您有帮助吗？
有用
有用
无用
无用