CloneVolume
建議變更
PDF
您可以使用此 `CloneVolume`方法來建立 Volume 複本。這種方法是非同步的、可能需要大量的時間才能完成。
複製程序會在您提出要求時立即開始 CloneVolume、並在 API 方法發出時代表磁碟區的狀態。您可以使用此Get非 同步結果方法來判斷複製程序何時完成、以及新的磁碟區是否可供連線使用。您可以使用listSyncJobs來查看建立複本的進度。磁碟區的初始屬性和服務品質設定會從要複製的磁碟區繼承而來。您可以使用變更這些設定ModifyVolume。
|
複製的磁碟區不會從來源磁碟區繼承Volume存取群組成員資格。 |
參數
此方法具有下列輸入參數：
| 名稱 | 說明 | 類型 | 預設值 | 必要 |
|---|---|---|---|---|
存取 |
新磁碟區允許存取。如果未指定值、則存取值不會變更。可能值：
|
字串 |
無 |
否 |
屬性 |
Json物件格式的名稱-值配對清單。 |
Json物件 |
無 |
否 |
enable512e |
指定新磁碟區是否應使用512位元組區段模擬。如果未指定、則會使用要複製的Volume設定。 |
布林值 |
原始Volume的設定 |
否 |
已啓用SnapMirrorReplication |
決定磁碟區是否可用於SnapMirror端點的複寫。可能值：
|
布林值 |
錯 |
否 |
名稱 |
新複製Volume的名稱；長度必須為1到64個字元。 |
字串 |
無 |
是的 |
newAccountID |
新Volume擁有者的AccountID。如果未指定、則會使用要複製之磁碟區擁有者的帳戶ID。 |
整數 |
原始Volume擁有者的帳戶ID |
否 |
新的規模 |
磁碟區的新大小（以位元組為單位）。可能大於或小於所複製的Volume大小。如果未指定、則不會變更磁碟區大小。大小會四捨五入至最接近的1MB大小。 |
整數 |
無 |
否 |
Snapshot ID |
作為實體複本來源的快照ID。如果未提供ID、則會使用目前作用中的Volume。 |
整數 |
無 |
否 |
Volume ID |
要複製之磁碟區的Volume ID。 |
整數 |
無 |
是的 |
傳回值
此方法具有下列傳回值：
名稱 |
說明 |
類型 |
asyncdle |
用於獲取操作結果的句柄值。 |
整數 |
cloneID |
新複製磁碟區的cloneID。 |
整數 |
曲線 |
套用至實體複本的QoS曲線值。 |
Json物件 |
Volume |
包含新複製Volume相關資訊的物件。 |
|
Volume ID |
新複製Volume的Volume 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