CloneVolume
È possibile utilizzare CloneVolume
metodo per creare una copia di un volume. Questo metodo è asincrono e potrebbe richiedere un periodo di tempo variabile.
Il processo di cloning inizia immediatamente quando si crea il CloneVolume
Richiedere ed è rappresentativo dello stato del volume al momento dell'emissione del metodo API. È possibile utilizzare GetAsyncResult metodo per determinare quando il processo di cloning è completo e il nuovo volume è disponibile per le connessioni. È possibile utilizzare ListSyncJobs per vedere lo stato di avanzamento della creazione del clone. Gli attributi iniziali e le impostazioni della qualità del servizio per il volume vengono ereditati dal volume clonato. È possibile modificare queste impostazioni con ModifyVolume.
I volumi clonati non ereditano l'appartenenza al gruppo di accesso al volume dal volume di origine. |
Parametri
Questo metodo ha i seguenti parametri di input:
Nome | Descrizione | Tipo | Valore predefinito | Obbligatorio |
---|---|---|---|---|
accesso |
Accesso consentito per il nuovo volume. Se non viene specificato alcun valore, il valore di accesso non cambia. Valori possibili:
|
stringa |
Nessuno |
No |
attributi |
Elenco delle coppie nome-valore nel formato oggetto JSON. |
Oggetto JSON |
Nessuno |
No |
enable512e |
Specifica se il nuovo volume deve utilizzare l'emulazione di settore a 512 byte. Se non specificato, viene utilizzata l'impostazione del volume clonato. |
booleano |
Impostazione del volume originale |
No |
EnableSnapMirrorReplication |
Determina se il volume può essere utilizzato per la replica con gli endpoint SnapMirror. Valori possibili:
|
booleano |
falso |
No |
nome |
Nome del nuovo volume clonato; deve contenere da 1 a 64 caratteri. |
stringa |
Nessuno |
Sì |
NewAccountID |
AccountID per il proprietario del nuovo volume. Se non specificato, viene utilizzato l'AccountID del proprietario del volume clonato. |
intero |
AccountID del proprietario del volume originale |
No |
NewSize |
Nuove dimensioni del volume, in byte. Potrebbe essere maggiore o minore della dimensione del volume clonato. Se non specificato, le dimensioni del volume non vengono modificate. La dimensione viene arrotondata alla dimensione più vicina di 1 MB. |
intero |
Nessuno |
No |
SnapshotID |
ID dello snapshot utilizzato come origine del clone. Se non viene fornito alcun ID, viene utilizzato il volume attivo corrente. |
intero |
Nessuno |
No |
ID volume |
VolumeID per il volume da clonare. |
intero |
Nessuno |
Sì |
Valori restituiti
Questo metodo ha i seguenti valori restituiti:
Nome |
Descrizione |
Tipo |
AsyncHandle |
Il valore handle utilizzato per ottenere il risultato dell'operazione. |
intero |
ID cloneID |
Il cloneID per il volume appena clonato. |
intero |
curva |
I valori della curva QoS applicati al clone. |
Oggetto JSON |
volume |
Oggetto contenente informazioni sul volume appena clonato. |
|
ID volume |
VolumeID per il volume appena clonato. |
intero |
Esempio di richiesta
Le richieste per questo metodo sono simili all'esempio seguente:
{ "method": "CloneVolume", "params": { "volumeID" : 5, "name" : "mysqldata-snapshot1", "access" : "readOnly" }, "id" : 1 }
Esempio di risposta
Questo metodo restituisce una risposta simile all'esempio seguente:
{ "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 } }
Novità dalla versione
9.6