CopyVolume
Änderungen vorschlagen
PDFs
Sie können die CopyVolume Methode zum Überschreiben des Dateninhalts eines bestehenden Volumes mit dem Dateninhalt eines anderen Volumes (oder Snapshots). Attribute des Zielvolumes wie IQN, QoS-Einstellungen, Größe, Konto und Volume-Zugriffsgruppenzugehörigkeit werden nicht geändert. Das Zielvolume muss bereits existieren und die gleiche Größe wie das Quellvolume haben.
Am besten ist es, wenn die Clients das Zielvolume vor Beginn des Vorgangs aushängen. Wird das Zielvolume während des Vorgangs geändert, gehen die Änderungen verloren. Dieser Vorgang kann unterschiedlich lange dauern. Sie können dieGetAsyncResult Methode zur Bestimmung des Prozessabschlusses undListSyncJobs um den Fortschritt des Kopiervorgangs zu verfolgen.
Parameter
Diese Methode hat folgende Eingabeparameter:
| Name | Beschreibung | Typ | Standardwert | Erforderlich |
|---|---|---|---|---|
dstVolumeID |
VolumeID des zu überschreibenden Volumes. |
ganze Zahl |
Keine |
Ja |
Volume-ID |
VolumeID des Datenträgers, von dem gelesen werden soll. |
ganze Zahl |
Keine |
Ja |
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 |
Rückgabewerte
Diese Methode hat die folgenden Rückgabewerte:
Name |
Beschreibung |
Typ |
asyncHandle |
Der Wert, der zum Abrufen des Operationsergebnisses verwendet wird, ist ein Handle. |
ganze Zahl |
cloneID |
Klon-ID für das neu geklonte Volume. |
ganze Zahl |
Anforderungsbeispiel
Anfragen für diese Methode ähneln dem folgenden Beispiel:
{
"method": "CopyVolume",
"params": {
"volumeID" : 3,
"dstVolumeID" : 2
},
"id" : 1
}
Antwortbeispiel
Diese Methode liefert eine Antwort, die dem folgenden Beispiel ähnelt:
{
"id": 1,
"result": {
"asyncHandle": 9,
"cloneID": 5
}
}
Neu seit Version
9,6