Skip to main content
Element Software
本产品推出了新版本。
简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

RollbackToSnapshot

贡献者
PDF

您可以使用 RollbackToSnapshot 方法为活动卷映像创建现有快照。此方法将从现有快照创建新快照。

新快照将变为活动状态，现有快照将保留，直到手动删除为止。除非将 saveCurrentState 参数设置为 true ，否则会删除先前活动的快照。

  • 集群填充度 *

备注

  • 如果集群填充度处于第 1 ， 2 或 3 阶段，则可以创建快照。当集群填充度达到第 4 或第 5 阶段时，您无法创建快照。

  • 如果正在执行分区同步、则将卷回滚到快照可能会失败。重试 RollbackToSnapshot 同步完成后。

Parameters

此方法具有以下输入参数：

Name Description Type 默认值 Required

volumeId

卷的卷 ID 。

整型

无

是的。

属性

名称 - 值对列表，采用 JSON 对象格式。

JSON 属性

无

否

name

快照的名称。如果未指定名称，则会使用要回滚到的快照的名称，并在名称末尾附加 "- copy" 。

string

无

否

snapshotId

先前在给定卷上创建的快照的 ID 。

整型

无

是的。

saveCurrentState

指定是否保存上一个活动卷映像。有效值：

  • true ：保留上一个活动卷映像。

  • false ：删除上一个活动卷映像。

boolean

false

否

返回值

此方法具有以下返回值：

Name

Description

Type

校验和

已存储快照中的数据的一个小字符串表示。

string

snapshotId

如果 saveCurrentState 设置为 false ，则此值为 null 。

如果 saveCurrentState 设置为 true ，则为新创建的快照的唯一 ID 。

整型

Snapshot

如果 saveCurrentState 设置为 false ，则此值为 null 。

如果 saveCurrentState 设置为 true ，则为包含新创建快照的相关信息的对象。

Snapshot

请求示例

此方法的请求类似于以下示例：

{
 "method": "RollbackToSnapshot",
 "params": {
    "volumeID": 1,
    "snapshotID": 3114,
    "saveCurrentState": true
  },
  "id": 1
}

响应示例

此方法返回类似于以下示例的响应：

{
  "id": 1,
  "result": {
    "checksum": "0x0",
    "snapshot": {
      "attributes": {},
      "checksum": "0x0",
      "createTime": "2016-04-04T17:27:32Z",
      "enableRemoteReplication": false,
      "expirationReason": "None",
      "expirationTime": null,
      "groupID": 0,
      "groupSnapshotUUID": "00000000-0000-0000-0000-000000000000",
      "name": "test1-copy",
      "snapshotID": 1,
      "snapshotUUID": "30d7e3fe-0570-4d94-a8d5-3cc8097a6bfb",
      "status": "done",
      "totalSize": 5000658944,
      "virtualVolumeID": null,
      "volumeID": 1
    },
    "snapshotID": 1
  }
}

自版本以来的新增功能

9.6