CreateGroupSnapshot

您可以使用 CreateGroupSnapshot 创建一组卷的时间点副本。

您可以在以后使用该快照作为备份或回滚，以确保卷组上的数据在创建快照时的时间点是一致的。

CLUSTER_FULLNESS

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

参数

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

名称	说明	类型	默认值	必需
attributes	名称-值对的列表，采用 JSON 对象格式。	JSON 对象	无	否
enableRemoteReplication	指定快照是否会复制到远程存储。可能值： true：快照会复制到远程存储。 false：快照不会复制到远程存储。	布尔型	false	否
name	组快照的名称。如果未输入任何名称，则会使用生成组快照时的日期和时间。允许的最大名称长度为 255 个字符。	字符串	无	否
retention	快照的保留时间。如果留空，则快照会永久保留。请以 HH:mm:ss 格式输入值。	字符串	无	否
snapMirrorLabel	SnapMirror 软件用于在 SnapMirror 端点上指定快照保留策略的标签。	字符串	无	否
volumes	从中进行复制的卷映像的唯一 ID。	volumeID 数组	无	是

返回值

此方法具有以下返回值：

名称	说明	类型
members	组中每个成员的 checksum、volumeIDs 和 snapshotIDs 的列表。有效值： checksum：以短字符串表示已存储快照中的数据。此校验和以后可用于比较其他快照，以检测数据中存在的错误。（字符串） snapshotID：从其生成新快照的快照的唯一 ID。快照 ID 必须来自给定卷上的快照。（整型） volumeID：快照的源卷 ID。（整型）	JSON 对象数组
groupSnapshotID	新的组快照的唯一 ID。	groupSnapshot ID
groupSnapshot	包含新创建组快照的相关信息的对象。	groupSnapshot

请求示例

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

{
   "method": "CreateGroupSnapshot",
   "params": {
      "volumes": [1,2]
   },
   "id": 1
}

响应示例

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

{
  "id": 1,
  "result": {
    "groupSnapshot": {
      "attributes": {},
      "createTime": "2016-04-04T22:43:29Z",
      "groupSnapshotID": 45,
      "groupSnapshotUUID": "473b78a3-ef85-4541-9438-077306b2d3ca",
      "members": [
        {
          "attributes": {},
          "checksum": "0x0",
          "createTime": "2016-04-04T22:43:29Z",
          "enableRemoteReplication": false,
          "expirationReason": "None",
          "expirationTime": null,
          "groupID": 45,
          "groupSnapshotUUID": "473b78a3-ef85-4541-9438-077306b2d3ca",
          "name": "2016-04-04T22:43:29Z",
          "snapshotID": 3323,
          "snapshotUUID": "7599f200-0092-4b41-b362-c431551937d1",
          "status": "done",
          "totalSize": 5000658944,
          "virtualVolumeID": null,
          "volumeID": 1
        },
        {
          "attributes": {},
          "checksum": "0x0",
          "createTime": "2016-04-04T22:43:29Z",
          "enableRemoteReplication": false,
          "expirationReason": "None",
          "expirationTime": null,
          "groupID": 45,
          "groupSnapshotUUID": "473b78a3-ef85-4541-9438-077306b2d3ca",
          "name": "2016-04-04T22:43:29Z",
          "snapshotID": 3324,
          "snapshotUUID": "a0776a48-4142-451f-84a6-5315dc37911b",
          "status": "done",
          "totalSize": 6001000448,
          "virtualVolumeID": null,
          "volumeID": 2
        }
      ],
      "name": "2016-04-04T22:43:29Z",
      "status": "done"
    },
    "groupSnapshotID": 45,
    "members": [
      {
        "checksum": "0x0",
        "snapshotID": 3323,
        "snapshotUUID": "7599f200-0092-4b41-b362-c431551937d1",
        "volumeID": 1
      },
      {
        "checksum": "0x0",
        "snapshotID": 3324,
        "snapshotUUID": "a0776a48-4142-451f-84a6-5315dc37911b",
        "volumeID": 2
      }
    ]
  }
}

发布以下版本后新增

9.6