KlonVolume
Sie können die Methode verwenden CloneVolume
, um eine Kopie eines Volumes zu erstellen. Diese Methode ist asynchron und nimmt möglicherweise eine variable Zeit in Anspruch.
Der Klonprozess beginnt sofort, wenn Sie die Anforderung stellen CloneVolume
, und ist repräsentativ für den Status des Volumes, wenn die API-Methode ausgegeben wird. Mithilfe der Methode können Sie GetAsyncResultbestimmen, wann der Klonprozess abgeschlossen ist und das neue Volume für Verbindungen verfügbar ist. Sie können ListSyncJobsdamit den Fortschritt des Klonens anzeigen. Die anfänglichen Attribute und die Quality of Service-Einstellungen für das Volume werden vom zu klonenden Volume übernommen. Sie können diese Einstellungen mit ändernUmfyVolume.
Geklonte Volumes übernehmen keine Zugriffsgruppenmitgliedschaft für Volumes vom Quell-Volume. |
Parameter
Diese Methode verfügt über die folgenden Eingabeparameter:
Name | Beschreibung | Typ | Standardwert | Erforderlich |
---|---|---|---|---|
Datenzugriff |
Zugriff für das neue Volume zulässig. Wenn kein Wert angegeben wird, ändert sich der Zugriffswert nicht. Mögliche Werte:
|
Zeichenfolge |
Keine |
Nein |
Merkmale |
Liste von Name-Wert-Paaren im JSON-Objektformat. |
JSON Objekt |
Keine |
Nein |
enable512e |
Gibt an, ob das neue Volume 512-Byte Sektoremulation verwenden soll. Wenn nicht angegeben, wird die Einstellung des zu klonenden Volumes verwendet. |
boolesch |
Einstellung der ursprünglichen Lautstärke |
Nein |
AbleSnapMirrorReplication |
Legt fest, ob das Volume für die Replizierung mit SnapMirror Endpunkten verwendet werden kann. Mögliche Werte:
|
boolesch |
Falsch |
Nein |
Name |
Der Name des neuen geklonten Volume muss 1 bis 64 Zeichen lang sein. |
Zeichenfolge |
Keine |
Ja. |
NewAccountID |
AccountID für den Besitzer des neuen Volumens. Wenn nicht angegeben, wird die AccountID des Inhabers des zu klonenden Volumes verwendet. |
Ganzzahl |
AccountID des Inhabers des ursprünglichen Volumens |
Nein |
NewSize |
Neue Größe des Volumes, in Byte. Ist möglicherweise größer oder kleiner als die Größe des zu klonenden Volumes. Wenn diese Angabe nicht erfolgt, wird die Volume-Größe nicht geändert. Größe wird auf die nächste 1MB in Größe gerundet. |
Ganzzahl |
Keine |
Nein |
Snapshot-ID |
ID des Snapshots, der als Quelle des Klons verwendet wird. Wenn keine ID angegeben wird, wird das aktuelle aktive Volume verwendet. |
Ganzzahl |
Keine |
Nein |
VolumeID |
VolumeID für das zu klonendes Volume. |
Ganzzahl |
Keine |
Ja. |
Rückgabewerte
Diese Methode verfügt über die folgenden Rückgabewerte:
Name |
Beschreibung |
Typ |
Asynchron |
Der Handle-Wert, der zum Abrufen des Operationsergebnisses verwendet wird. |
Ganzzahl |
KlonID |
Die KlonID für das neu geklonte Volume. |
Ganzzahl |
Kurve |
Die QoS-Kurvenwerte, die auf den Klon angewendet werden. |
JSON Objekt |
Datenmenge |
Ein Objekt, das Informationen über das neu geklonte Volume enthält. |
|
VolumeID |
VolumeID für das neu geklonte Volume. |
Ganzzahl |
Anforderungsbeispiel
Anforderungen für diese Methode sind ähnlich wie das folgende Beispiel:
{ "method": "CloneVolume", "params": { "volumeID" : 5, "name" : "mysqldata-snapshot1", "access" : "readOnly" }, "id" : 1 }
Antwortbeispiel
Diese Methode gibt eine Antwort zurück, 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