CloneVolume
建议更改
PDF
您可以使用 `CloneVolume`方法创建卷的副本。此方法是异步方法，可能需要不同的时间才能完成。
克隆过程会在发出请求时立即开始 CloneVolume、并在发出API方法时反映卷的状态。您可以使用GetAsyncResult方法确定克隆过程何时完成以及何时可以连接新卷。您可以使用ListSyncJobs查看创建克隆的进度。卷的初始属性和服务质量设置将从要克隆的卷继承。您可以使用更改这些设置ModifyVolume。
|
克隆的卷不会从源卷继承卷访问组成员资格。 |
参数
此方法具有以下输入参数：
| 名称 | 说明 | 键入 | 默认值 | 必填 |
|---|---|---|---|---|
访问 |
允许对新卷进行访问。如果未指定值，则访问值不会更改。可能值：
|
string |
无 |
否 |
属性 |
名称 - 值对列表，采用 JSON 对象格式。 |
JSON 对象 |
无 |
否 |
enable512e |
指定新卷是否应使用 512 字节扇区模拟。如果未指定，则会使用要克隆的卷的设置。 |
boolean |
设置原始卷 |
否 |
启用 SnapMirrorReplication |
确定卷是否可用于 SnapMirror 端点的复制。可能值：
|
boolean |
false |
否 |
name |
新克隆卷的名称；长度必须为 1 到 64 个字符。 |
string |
无 |
是 |
newAccountID |
新卷所有者的帐户 ID 。如果未指定，则会使用要克隆的卷的所有者的帐户 ID 。 |
整型 |
原始卷所有者的帐户 ID |
否 |
新大小 |
卷的新大小，以字节为单位。可能大于或小于要克隆的卷的大小。如果未指定，则不会更改卷大小。大小将向上取整为最接近的 1 MB 。 |
整型 |
无 |
否 |
snapshotId |
用作克隆源的快照的 ID 。如果未提供 ID ，则会使用当前活动卷。 |
整型 |
无 |
否 |
卷ID |
要克隆的卷的卷 ID 。 |
整型 |
无 |
是 |
返回值
此方法具有以下返回值：
名称 |
说明 |
键入 |
异步处理 |
用于获取操作结果的句柄值。 |
整型 |
cloneID |
新克隆卷的克隆 ID 。 |
整型 |
曲线 |
应用于克隆的 QoS 曲线值。 |
JSON 对象 |
volume |
包含有关新克隆卷的信息的对象。 |
|
卷ID |
新克隆卷的卷 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