基于指定备份记录恢复单个ArkClaw实例。 ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 **Action** string 必选 `示例值：RestoreClawInstanceSnapshot` 要执行的操作，取值：RestoreClawInstanceSnapshot。 **Version** string 必选 `示例值：2026-05-01` API的版本，取值：2026\-05\-01。 **ClientToken** string `可选` `示例值：23fa21A8823nfasd7f****` 保证请求幂等性。由客户端自动生成一个参数值，确保不同请求间该参数值唯一，避免当调用API超时或服务器内部错误时，客户端多次重试导致重复性操作。取值：仅支持ASCII字符，且不能超过64个字符。 **DryRun** boolean `可选` `示例值：false` 是否仅做参数和权限检查而不实际执行操作。取值： * true：仅做检查，校验通过返回`DryRunOperation`错误码。 * false（默认）：实际执行操作。 **InstanceId** string 必选 `示例值：ci-yenklf05q8a9xf1s****` ArkClaw实例ID。查询实例ID的方式请参见[ListClawInstances](https://www.volcengine.com/docs/87732/2466959)。 **SnapshotId** string 必选 `示例值：snp-f7b3****` 目标备份记录ID。查询备份记录ID的方式请参见[ListClawInstanceSnapshots](https://www.volcengine.com/docs/87732/2552537)。 **SpaceId** string 必选 `示例值：csi-yei8347ta8xmf5qd****` ArkClaw实例所属空间ID。可以在ArkClaw控制台“空间概览”页面的“基本信息”获取。 ## 返回参数本接口无特有的返回参数。更多信息请见[返回结构](https://www.volcengine.com/docs/6369/80336)。 ## 请求示例 ```json POST /?Action=RestoreClawInstanceSnapshot&Version=2026-05-01 HTTP/1.1 Host: https://arkclaw.cn-beijing.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20260624T143619Z X-Content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260624/cn-beijing/arkclaw/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f { "ClientToken": "23fa21A8823nfasd7f****", "DryRun": false, "InstanceId": "ci-yenklf05q8a9xf1s****", "SnapshotId": "snp-f7b3****", "SpaceId": "csi-yei8347ta8xmf5qd****" } ``` ## 返回示例 ```json { "ResponseMetadata": { "RequestId": "20260624223628153083****", "Action": "RestoreClawInstanceSnapshot", "Version": "2026-05-01", "Service": "arkclaw", "Region": "cn-beijing" }, "Result": {} } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6369/68677)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |400 |InvalidClientToken.Malformed |The specified ClientToken is malformed. |Token 格式非法（非 ASCII 或超过 64 字节） | |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 |同一 Token 但请求参数与首次调用不一致，需更换 Token | |400 |MissingParameter.InstanceId |The required parameter InstanceId is not supplied. |参数InstanceId不能为空。 | |400 |MissingParameter.SnapshotId |The required parameter SnapshotId is not supplied. |参数SnapshotId不能为空。 | |400 |MissingParameter.SpaceId |The required parameter SpaceId is not supplied. |参数SpaceId不能为空。 | |404 |InvalidSpace.NotFound |The specified Space does not exist. |指定ArkClaw空间不存在。 | |404 |InvalidInstance.NotFound |The specified Instance does not exist. |指定ArkClaw实例不存在。 | |404 |InvalidSnapshot.NotFound |The specified SnapshotId does not exist. |指定备份记录不存在 | |412 |IdempotentProcessing |The previous request with the same ClientToken is still processing. |同一 Token 的首次请求仍在处理中，请稍后重试 | |412 |DryRunOperation |The user has the required permissions, so the request would have succeeded, but the DryRun parameter was used. |DryRun检查通过；由于设置了DryRun参数，请求未真正执行。 | |412 |InvalidInstanceStatus |The instance is not in a running state. |实例未处于可恢复状态。 | |412 |InvalidSnapshotStatus |The Snapshot record status does not allow restoration. |备份记录状态不允许恢复（如creating/failed）。 | |429 |FlowLimitExceeded |The request was rejected due to flow control. |请求触发限流。 | |500 |InternalError |An internal error has occurred. |内部错误，请重试。如果多次尝试失败，请提交工单。 |

ArkClaw 企业版