CloneVolume

您可以使用 CloneVolume 方法创建卷的副本。此方法是异步方法，其完成所需的时间可能不同。

一旦发出 CloneVolume 请求，克隆过程就会开始；调用此 API 方法时，此过程会反映卷的状态。您可以使用 GetAsyncResult 方法来确定克隆过程何时完成以及何时可以连接新卷。您可以使用 ListSyncJobs 来查看创建克隆的进度。卷的初始属性和服务质量设置将从所克隆的卷继承。您可以通过 ModifyVolume 更改这些设置。

注：克隆的卷不会继承源卷的卷访问组成员资格。

参数

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

名称	说明	类型	默认值	必需
access	允许对新卷进行的访问。如果未指定值，则访问值不会更改。可能值： readOnly：（可选）仅允许执行读取操作。 readWrite：（可选）允许执行读取和写入。 locked：（可选）不允许执行任何读取或写入。如果未指定，将使用所克隆卷的访问值。 replicationTarget：（可选）将一个卷标识为一组配对卷的目标卷。如果卷未进行配对，则访问状态为 locked。	字符串	无	否
attributes	名称-值对的列表，采用 JSON 对象格式。	JSON 对象	无	否
enable512e	指定新卷是否应使用 512 字节扇区仿真。如果未指定、则使用正在克隆的卷的设置。	布尔型	设置原始卷	否
enableSnapMirrorReplication	确定卷是否可用于 SnapMirror 端点的复制。可能值： true false	布尔型	false	否
name	新克隆卷的名称；长度必须是 1 到 64 个字符。	字符串	无	是
newAccountID	新卷的所有者的帐户 ID。如果未指定、则使用正在克隆的卷的所有者的帐户 ID 。	整型	原始卷所有者的帐户 ID	否
newSize	卷的新大小（以字节为单位）。可大于或小于所克隆卷的大小。如果未指定，则卷大小不变。大小将向上取整为最接近的 MB。	整型	无	否
snapshotID	用作克隆源的快照的 ID。如果未提供 ID，则将使用当前活动卷。	整型	无	否
volumeID	要克隆的卷的卷 ID。	整型	无	是

返回值

此方法具有以下返回值：

名称	说明	类型
asyncHandle	用于获取操作结果的句柄值。	整型
cloneID	新克隆卷的克隆 ID。	整型
curve	应用于克隆的 QoS 曲线值。	JSON 对象
volume	包含新克隆卷的相关信息的对象。	volume
volumeID	新克隆卷的卷 ID。	整型

请求示例

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

{
   "method": "CloneVolume",
   "params": {
      "volumeID" : 5,
      "name"  : "mysqldata-snapshot1",
      "access" : "readOnly"
   },
   "id" : 1
}

响应示例

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

{
  "id": 1,
  "result": {
      "asyncHandle": 42,
      "cloneID": 37,
      "volume": {
          "access": "readOnly",
          "accountID": 1,
          "attributes": {},
          "blockSize": 4096,
          "createTime": "2016-03-31T22:26:03Z",
          "deleteTime": "",
          "enable512e": true,
          "iqn": "iqn.2010-01.com.solidfire:jyay.mysqldata-snapshot1.680",
          "name": "mysqldata-snapshot1",
          "purgeTime": "",
          "qos": {
              "burstIOPS": 100,
              "burstTime": 60,
              "curve": {
                  "4096": 100,
                  "8192": 160,
                  "16384": 270,
                  "32768": 500,
                  "65536": 1000,
                  "131072": 1950,
                  "262144": 3900,
                  "524288": 7600,
                  "1048576": 15000
              },
              "maxIOPS": 100,
              "minIOPS": 50
          },
          "scsiEUIDeviceID": "6a796179000002a8f47acc0100000000",
          "scsiNAADeviceID": "6f47acc1000000006a796179000002a8",
          "sliceCount": 0,
          "status": "init",
          "totalSize": 1000341504,
          "virtualVolumeID": null,
          "volumeAccessGroups": [],
          "volumeID": 680,
          "volumePairs": []
      },
      "volumeID": 680
  }
}

发布以下版本后新增

9.6