CloneVolume
Sie können die CloneVolume Methode zum Erstellen einer Kopie eines Volumes. Diese Methode ist asynchron und kann unterschiedlich lange dauern.
Der Klonvorgang beginnt unmittelbar nach dem Erstellen des… CloneVolume Die Anfrage repräsentiert den Zustand des Volumens zum Zeitpunkt des Aufrufs der API-Methode. Sie können dieGetAsyncResult Methode zur Bestimmung, wann der Klonvorgang abgeschlossen ist und das neue Volume für Verbindungen verfügbar ist. Sie können verwendenListSyncJobs um den Fortschritt bei der Erstellung des Klons zu verfolgen. Die anfänglichen Attribute und QoS-Einstellungen des Volumes werden vom geklonten Volume übernommen. Diese Einstellungen können Sie ändern mitLautstärke ändern Die
|
|
Geklonte Volumes erben die Zugehörigkeit zu den Volume-Zugriffsgruppen nicht vom Quellvolume. |
Parameter
Diese Methode hat die folgenden Eingabeparameter:
| Name | Beschreibung | Typ | Standardwert | Erforderlich |
|---|---|---|---|---|
Zugang |
Zugriff auf das neue Volume ermöglicht. Wird kein Wert angegeben, ändert sich der Zugriffswert nicht. Mögliche Werte:
|
Schnur |
Keine |
Nein |
Attribute |
Liste von Name-Wert-Paaren im JSON-Objektformat. |
JSON-Objekt |
Keine |
Nein |
enable512e |
Gibt an, ob für das neue Volume die 512-Byte-Sektoremulation verwendet werden soll. Falls nichts anderes angegeben ist, wird die Einstellung des zu klonenden Volumes verwendet. |
boolescher Wert |
Einstellung der ursprünglichen Lautstärke |
Nein |
SnapMirrorReplication aktivieren |
Ermittelt, ob das Volume für die Replikation mit SnapMirror Endpunkten verwendet werden kann. Mögliche Werte:
|
boolescher Wert |
FALSCH |
Nein |
Name |
Name des neuen geklonten Volumes; muss 1 bis 64 Zeichen lang sein. |
Schnur |
Keine |
Ja |
neueKonto-ID |
AccountID für den Inhaber des neuen Volumes. Falls nicht anders angegeben, wird die Account-ID des Besitzers des zu klonenden Volumes verwendet. |
ganze Zahl |
AccountID des Besitzers des Originalbandes |
Nein |
neue Größe |
Neue Größe des Volumens in Bytes. Kann größer oder kleiner als die Größe des zu klonenden Volumens sein. Wenn keine Angabe erfolgt, wird die Volumengröße nicht geändert. Die Größe wird auf das nächste 1 MB aufgerundet. |
ganze Zahl |
Keine |
Nein |
Snapshot-ID |
ID des Snapshots, der als Quelle für den Klon verwendet wird. Wird keine ID angegeben, wird das aktuell aktive Volume verwendet. |
ganze Zahl |
Keine |
Nein |
Volume-ID |
VolumeID des zu klonenden Volumes. |
ganze Zahl |
Keine |
Ja |
Rückgabewerte
Diese Methode hat die folgenden Rückgabewerte:
Name |
Beschreibung |
Typ |
asyncHandle |
Der Handle-Wert, der verwendet wird, um das Operationsergebnis zu erhalten. |
ganze Zahl |
cloneID |
Die Klon-ID für das neu geklonte Volume. |
ganze Zahl |
Kurve |
Die auf den Klon angewendeten QoS-Kurvenwerte. |
JSON-Objekt |
Volumen |
Ein Objekt, das Informationen über das neu geklonte Volume enthält. |
|
Volume-ID |
VolumeID für das neu geklonte Volume. |
ganze Zahl |
Anforderungsbeispiel
Anfragen für diese Methode ähneln dem folgenden Beispiel:
{
"method": "CloneVolume",
"params": {
"volumeID" : 5,
"name" : "mysqldata-snapshot1",
"access" : "readOnly"
},
"id" : 1
}
Antwortbeispiel
Diese Methode liefert eine Antwort, die dem folgenden Beispiel ähnelt:
{
"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
}
}
Neu seit Version
9,6