RollbackToGroupSnapshot

您可以使用 RollbackToGroupSnapshot 将快照组中的所有卷回滚到每个卷各自的快照。

回滚到组快照会创建组快照中每个卷的临时快照。

注：当集群填充度处于第 1、2 或第 3 阶段时，允许创建快照。当集群填充度处于第 4 或第 5 阶段时，不会创建快照。

参数

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

名称	说明	类型	默认值	必需
groupSnapshotID	组快照的唯一 ID。	整型	无	是
attributes	名称-值对的列表，采用 JSON 对象格式。	JSON 对象	无	否
name	如果 saveCurrentState 设置为 true，则为用于创建组快照的卷当前状态的名称。如果未指定名称，则会将快照（组和各个卷）的名称设置为进行回滚时的时间戳。	字符串	无	否
saveCurrentState	指定是否保存上一个活动卷映像。有效值： true：保留上一个活动卷映像。 false：删除上一个活动卷映像。	布尔型	false	否

返回值

此方法具有以下返回值：

名称	说明	类型
members	一个数组，其中包含组快照成员的 volumeID 和 snapshotID。值： checksum：以短字符串表示已存储快照中的数据。此校验和以后可用于比较其他快照，以检测数据中存在的错误。（字符串） snapshotID：从其生成新快照的快照的唯一 ID。快照 ID 必须来自给定卷上的快照。（整型） volumeID：快照的源卷 ID。（整型）	JSON 对象数组
groupSnapshotID	如果 saveCurrentState 设置为 false，则此值为 null。如果 saveCurrentState 设置为 true，则为新建组快照的唯一 ID。	整型
groupSnapshot	如果 saveCurrentState 设置为 false，则此值为 null。如果 saveCurrentState 设置为 true，则为一个对象，其中包含有关 RollbackToGroupSnapshot 刚刚回滚到的组快照的信息。	groupSnapshot

名称

说明

类型

members

一个数组，其中包含组快照成员的 volumeID 和 snapshotID。值：

checksum：以短字符串表示已存储快照中的数据。此校验和以后可用于比较其他快照，以检测数据中存在的错误。（字符串）
snapshotID：从其生成新快照的快照的唯一 ID。快照 ID 必须来自给定卷上的快照。（整型）
volumeID：快照的源卷 ID。（整型）

JSON 对象数组

groupSnapshotID

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

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

整型

groupSnapshot

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

如果 saveCurrentState 设置为 true，则为一个对象，其中包含有关 RollbackToGroupSnapshot 刚刚回滚到的组快照的信息。

groupSnapshot

请求示例

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

{
  "id": 438,
  "method": "RollbackToGroupSnapshot",
  "params": {
    "groupSnapshotID": 1,
    "name": "grpsnap1",
    "saveCurrentState": true
  }
}

响应示例

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

{
  "id": 438,
  "result": {
    "groupSnapshot": {
      "attributes": {},
      "createTime": "2016-04-06T17:27:17Z",
      "groupSnapshotID": 1,
      "groupSnapshotUUID": "468fe181-0002-4b1d-ae7f-8b2a5c171eee",
      "members": [
        {
          "attributes": {},
          "checksum": "0x0",
          "createTime": "2016-04-06T17:27:17Z",
          "enableRemoteReplication": false,
          "expirationReason": "None",
          "expirationTime": null,
          "groupID": 1,
          "groupSnapshotUUID": "468fe181-0002-4b1d-ae7f-8b2a5c171eee",
          "name": "2016-04-06T17:27:17Z",
          "snapshotID": 4,
          "snapshotUUID": "03563c5e-51c4-4e3b-a256-a4d0e6b7959d",
          "status": "done",
          "totalSize": 1000341504,
          "virtualVolumeID": null,
          "volumeID": 2
        }
      ],
      "name": "2016-04-06T17:27:17Z",
      "status": "done"
    },
    "groupSnapshotID": 3,
    "members": [
      {
        "checksum": "0x0",
        "snapshotID": 2,
        "snapshotUUID": "719b162c-e170-4d80-b4c7-1282ed88f4e1",
        "volumeID": 2
      }
    ]
  }
}

发布以下版本后新增

9.6