为指定的本地历史快照(通过其 ID 定位)创建一个标签(通过名称指定)。标签可以帮助用户快速定位到重要的历史版本。
在只读模式下,此操作被禁止。
参数名 | 类型 | 必需 | 描述 |
---|---|---|---|
id |
string | 是 | 要打标签的本地历史快照的唯一标识 ID。 |
name |
string | 是 | 要为该快照设置的标签名称。 |
返回标准的 JSON 结构体,包含 code
, msg
, data
三个字段。
code
: 返回码,0
表示成功,其他值表示失败。msg
: 返回信息,成功时为空字符串,失败时为错误提示。data
: 返回的具体数据。
null
。{"closeTimeout": 5000}
,提示操作失败并可能在一段时间后关闭相关提示。例如,当标签创建失败时,msg
字段会包含如 "tag snapshot failed: [具体错误信息]" 的内容。
{
"code": 0,
"msg": "",
"data": null
}
失败时 (例如,内部错误):
{
"code": -1,
"msg": "tag snapshot failed: 具体错误原因",
"data": {"closeTimeout": 5000}
}