CopyVolume
Änderungen vorschlagen
PDFs
Sie können die Methode verwenden CopyVolume, um den Dateninhalt eines vorhandenen Volumes mit dem Dateninhalt eines anderen Volumes (oder Snapshots) zu überschreiben. Attribute des Ziel-Volume wie IQN, QoS-Einstellungen, Größe, Konto und Mitgliedschaft für Volume-Zugriffsgruppen werden nicht geändert. Das Ziel-Volume muss bereits vorhanden sein und dieselbe Größe aufweisen wie das Quell-Volume.
Es ist am besten, wenn Clients das Ziel-Volume unmounten, bevor der Vorgang beginnt. Wenn das Zielvolume während des Vorgangs geändert wird, gehen die Änderungen verloren. Dieser Vorgang kann eine variable Zeit in Anspruch nehmen. Mit dieser Methode können Sie GetAsyncResultfeststellen, wann der Vorgang abgeschlossen ist, und ListSyncJobsden Fortschritt der Kopie anzeigen.
Parameter
Diese Methode verfügt über den folgenden Eingabeparameter:
| Name | Beschreibung | Typ | Standardwert | Erforderlich |
|---|---|---|---|---|
DstVolumeID |
VolumeID des zu überschreibenden Volumes. |
Ganzzahl |
Keine |
Ja. |
VolumeID |
VolumeID des Volumes, aus dem gelesen werden soll. |
Ganzzahl |
Keine |
Ja. |
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 |
Rückgabewerte
Diese Methode verfügt über die folgenden Rückgabewerte:
Name |
Beschreibung |
Typ |
Asynchron |
Handle-Wert, der zum Abrufen des Operationsergebnisses verwendet wird. |
Ganzzahl |
KlonID |
KlonID für das neu geklonte Volume |
Ganzzahl |
Anforderungsbeispiel
Anforderungen für diese Methode sind ähnlich wie das folgende Beispiel:
{
"method": "CopyVolume",
"params": {
"volumeID" : 3,
"dstVolumeID" : 2
},
"id" : 1
}
Antwortbeispiel
Diese Methode gibt eine Antwort zurück, die dem folgenden Beispiel ähnelt:
{
"id": 1,
"result": {
"asyncHandle": 9,
"cloneID": 5
}
}
Neu seit Version
9,6