CreateSnapshot

您可以使用 CreateSnapshot 创建卷的时间点副本。可以从任何卷或现有快照创建快照。

如果没有为此 API 方法提供快照 ID，则会从卷的活动分支创建快照。如果从其创建快照的卷将复制到远程集群，则该快照也可以复制到同一个目标。使用 enableRemoteReplication 参数可以启用快照复制。

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

参数

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

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

返回值

此方法具有以下返回值：

名称	说明	类型
checksum	一个字符串，表示已存储的快照中的正确位数。此校验和以后可用于比较其他快照，以检测数据中存在的错误。	字符串
snapshotID	新快照的唯一 ID。	snapshot ID
snapshot	包含新创建快照的相关信息的对象。	snapshot

请求示例

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

{
   "method": "CreateSnapshot",
   "params": {
      "volumeID": 1
   },
   "id": 1
}

响应示例

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

{
  "id": 1,
  "result": {
    "checksum": "0x0",
      "snapshot": {
        "attributes": {},
        "checksum": "0x0",
        "createTime": "2016-04-04T17:14:03Z",
        "enableRemoteReplication": false,
        "expirationReason": "None",
        "expirationTime": null,
        "groupID": 0,
        "groupSnapshotUUID": "00000000-0000-0000-0000-000000000000",
        "name": "2016-04-04T17:14:03Z",
        "snapshotID": 3110,
        "snapshotUUID": "6f773939-c239-44ca-9415-1567eae79646",
        "status": "done",
        "totalSize": 5000658944,
        "virtualVolumeID": null,
        "volumeID": 1
      },
        "snapshotID": 3110
  }
}