将指定的本地历史快照(通过其 ID 和关联的标签名定位)上传到当前配置的云端同步服务提供商。
此操作通常用于备份重要的本地快照版本到云端,或者在不同设备间同步特定的快照状态。在只读模式下,此操作被禁止。
参数名 | 类型 | 必需 | 描述 |
---|---|---|---|
id |
string | 是 | 要上传的本地历史快照的唯一标识 ID。 |
tag |
string | 是 | 与此本地快照关联的标签名称。上传到云端后,此标签将用于标识该快照。 |
返回标准的 JSON 结构体,包含 code
, msg
, data
三个字段。
code
: 返回码,0
表示成功,其他值(如 -1
)表示失败。msg
: 返回信息,成功时通常为空字符串,失败时为具体的错误提示信息。data
: 返回的具体数据,成功时通常为 null
。成功时:
{
"code": 0,
"msg": "",
"data": null
}
失败时 (例如,云端服务未配置或上传失败):
{
"code": -1,
"msg": "具体错误信息,例如:upload to cloud failed: ... 或 provider not config",
"data": null
}