RollbackToSnapshot

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

新快照将变为活动，现有快照将保留直至用户手动将其删除为止。系统会删除先前的活动快照，除非您将 saveCurrentState 参数设置为 true。

CLUSTER_FULLNESS

注：当集群填充度处于第 1、2 或第 3 阶段时，您可以创建快照。当集群填充度达到第 4 或第 5 阶段时，您不能创建快照。

参数

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

名称	说明	类型	默认值	必需
volumeID	卷的卷 ID。	整型	无	是
attributes	名称-值对的列表，采用 JSON 对象格式。	JSON 属性	无	否
name	快照的名称。如果未指定任何名称，则会使用将回滚到的快照的名称并在该名称的结尾附加“- copy”。	字符串	无	否
snapshotID	先前在给定卷上创建的快照的 ID。	整型	无	是
saveCurrentState	指定是否保存上一个活动卷映像。有效值： true：保留上一个活动卷映像。 false：删除上一个活动卷映像。	布尔型	false	否

返回值

此方法具有以下返回值：

名称	说明	类型
checksum	以短字符串表示已存储快照中的数据。	字符串
snapshotID	如果 saveCurrentState 设置为 false，则此值为 null。如果 saveCurrentState 设置为 true，则为新建快照的唯一 ID。	整型
snapshot	如果 saveCurrentState 设置为 false，则此值为 null。如果 saveCurrentState 设置为 true，则为一个对象，其中包含有关新建快照的信息。	snapshot

名称

说明

类型

checksum

以短字符串表示已存储快照中的数据。

字符串

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
  }
}