CloneVolume

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

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

参数

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

名称 说明 类型 默认值 必需
access 允许对新卷进行的访问。如果未指定值,则访问值不会更改。可能值:
  • readOnly:(可选)仅允许执行读取操作。
  • readWrite:(可选)允许执行读取和写入。
  • locked:(可选)不允许执行任何读取或写入。如果未指定,将使用所克隆卷的访问值。
  • replicationTarget:(可选)将一个卷标识为一组配对卷的目标卷。如果卷未进行配对,则访问状态为 locked。
字符串
attributes 名称-值对的列表,采用 JSON 对象格式。 JSON 对象
enableSnapMirrorReplication 确定卷是否可用于 SnapMirror 端点的复制。可能值:
  • true
  • false
布尔型 false
name 新克隆卷的名称;长度必须是 1 到 64 个字符。 字符串
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