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

请求示例

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

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