ArkClaw 企业版
ArkClaw 企业版
文档指南
请输入
- 文档首页
ArkClaw 企业版ArkClaw 企业版开发者指南API 参考ClawInstanceGetClawInstanceSnapshot - 获取ArkClaw实例备份详情
复制全文
下载 pdfGetClawInstanceSnapshot - 获取ArkClaw实例备份详情
文档反馈
问问助手获取ArkClaw实例备份详情。
请求参数
Action string 必选 示例值：GetClawInstanceSnapshot
要执行的操作，取值：GetClawInstanceSnapshot。
Version string 必选 示例值：2026-05-01
API的版本，取值：2026-05-01。
SnapshotId string 必选 示例值：snp-yep5dw9t6ory0vsz****
SpaceId string 必选 示例值：csi-yei8347ta8xmf5q****
ArkClaw实例所属空间ID。可以在ArkClaw控制台“空间概览”页面的“基本信息”获取。
返回参数
Snapshot object 示例值：--
单个备份记录详情。
CreatedAt string 示例值：2026-07-07 03:00:00
ArkClaw实例备份记录创建时间，时间格式为：time.RFC3339。
DisplayName string 示例值：自动备份
ArkClaw实例备份记录的显示名称。
ExpireAt string 示例值：2026-07-09 03:00:00
ArkClaw实例备份记录的过期时间，时间格式为：time.RFC3339。
InstanceId string 示例值：ci-yenklf05q8a9xf1s****
ArkClaw实例ID。
Name string 示例值：auto-2026-07-07-03-00
ArkClaw实例备份记录的原始名称。
RecoveryTime string 示例值：2026-07-07 03:00:00
ArkClaw实例备份记录的可恢复时间点，时间格式为：time.RFC3339。
SnapshotId string 示例值：snp-yep5dw9t6ory0vsz****
备份记录ID。
Source string 示例值：Auto
ArkClaw实例备份记录的来源，取值：
- Admin：管理员手动备份。
- User：员工手动备份。
- Auto：系统自动备份。
Status string 示例值：Ready
实例备份记录状态。取值：
- Ready：备份记录已创建完成，可用于恢复实例。
- Creating：备份记录正在创建中。
- Restoring：正在基于该备份记录执行实例恢复。
- Failed：备份记录创建失败。
请求示例
GET /?Action=GetClawInstanceSnapshot&Version=2026-05-01&SnapshotId=snp-yep5dw9t6ory0vsz****&SpaceId=csi-yei8347ta8xmf5q**** HTTP/1.1
Host: https://arkclaw.cn-beijing.volcengineapi.com
X-Date: 20260717T061228Z
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260717/cn-beijing/arkclaw/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f
返回示例
{
"ResponseMetadata": {
"RequestId": "20260717141235044253****",
"Action": "GetClawInstanceSnapshot",
"Version": "2026-05-01",
"Service": "arkclaw",
"Region": "cn-beijing"
},
"Result": {
"Snapshot": {
"CreatedAt": "2026-07-07 03:00:00",
"DisplayName": "自动备份",
"ExpireAt": "2026-07-09 03:00:00",
"InstanceId": "ci-yenklf05q8a9xf1s****",
"Name": "auto-2026-07-07-03-00",
"RecoveryTime": "2026-07-07 03:00:00",
"SnapshotId": "snp-yep5dw9t6ory0vsz****",
"Source": "Auto",
"Status": "Ready"
}
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
400 | MissingParameter.SpaceId | The required parameter SpaceId is not supplied. | 参数SpaceId不能为空。 |
400 | MissingParameter.SnapshotId | The required parameter SnapshotId is not supplied. | 未提供备份记录ID。 |
404 | InvalidSpace.NotFound | The specified Space does not exist. | 指定ArkClaw空间不存在。 |
404 | InvalidSnapshot.NotFound | The specified SnapshotId does not exist. | 指定备份记录不存在。 |
最近更新时间：2026.07.17 17:50:16
这个页面对您有帮助吗？
有用
有用
无用
无用