CreateSnapshot
È possibile utilizzare CreateSnapshot
per creare una copia point-in-time di un volume. È possibile creare uno snapshot da qualsiasi volume o da uno snapshot esistente.
Se non si fornisce un SnapshotID con questo metodo API, viene creata una snapshot dalla diramazione attiva del volume. Se il volume da cui viene creato lo snapshot viene replicato in un cluster remoto, lo snapshot può essere replicato anche nella stessa destinazione. Utilizzare il parametro enableRemoteReplication per attivare la replica dello snapshot.
È possibile creare snapshot se la completezza del cluster è nella fase 1, 2 o 3. Non è possibile creare snapshot quando la pienezza del cluster raggiunge la fase 4 o 5. |
Parametri
Questo metodo ha i seguenti parametri di input:
Nome | Descrizione | Tipo | Valore predefinito | Obbligatorio |
---|---|---|---|---|
|
Elenco delle coppie nome-valore nel formato oggetto JSON. |
Oggetto JSON |
Nessuno |
No |
|
Specifica se lo snapshot verrà replicato o meno nello storage remoto. Valori possibili:
|
booleano |
falso |
No |
|
Specifica che lo snapshot non deve essere creato se è in corso una replica dello snapshot precedente. I valori possibili sono:
|
booleano |
|
No |
ExpirationTime (tempo di scadenza) |
Specificare il tempo dopo il quale è possibile rimuovere lo snapshot. Non può essere utilizzato con |
stringa |
Nessuno |
No |
|
Il nome dello snapshot. Se non viene immesso alcun nome, vengono utilizzate la data e l'ora in cui è stata eseguita l'istantanea. La lunghezza massima consentita per il nome è di 255 caratteri. |
stringa |
Nessuno |
No |
|
Questo parametro è lo stesso del |
stringa |
Nessuno |
No |
|
Etichetta utilizzata dal software SnapMirror per specificare il criterio di conservazione delle snapshot su un endpoint SnapMirror. |
stringa |
Nessuno |
No |
|
ID univoco di uno snapshot da cui viene creato il nuovo snapshot. Lo snapshotID passato deve essere uno snapshot sul volume specificato. |
intero |
Nessuno |
No |
|
ID univoco dell'immagine del volume da cui copiare. |
intero |
Nessuno |
Sì |
Valori restituiti
Questo metodo ha i seguenti valori restituiti:
Nome |
Descrizione |
Tipo |
checksum |
Stringa che rappresenta le cifre corrette nello snapshot memorizzato. Questo checksum può essere utilizzato in un secondo momento per confrontare altri snapshot al fine di rilevare errori nei dati. |
stringa |
SnapshotID |
ID univoco della nuova istantanea. |
ID snapshot |
snapshot |
Oggetto contenente informazioni sullo snapshot appena creato. |
Esempio di richiesta
Le richieste per questo metodo sono simili all'esempio seguente:
{ "method": "CreateSnapshot", "params": { "volumeID": 1 }, "id": 1 }
Esempio di risposta
Questo metodo restituisce una risposta simile all'esempio seguente:
{ "id": 1, "result": { "checksum": "0x0", "snapshot": { "attributes": {}, "checksum": "0x0", "createTime": "2016-04-04T17:14:03Z", "enableRemoteReplication": false, "expirationReason": "None", "expirationTime": null, "groupID": 0, "groupSnapshotUUID": "00000000-0000-0000-0000-000000000000", "name": "2016-04-04T17:14:03Z", "snapshotID": 3110, "snapshotUUID": "6f773939-c239-44ca-9415-1567eae79646", "status": "done", "totalSize": 5000658944, "virtualVolumeID": null, "volumeID": 1 }, "snapshotID": 3110 } }
Eccezione
Un'eccezione xNotPrimary viene visualizzata quando l' CreateSnapshot`API viene richiamata e lo snapshot non viene creato. Questo è il comportamento previsto. Riprovare la `CreateSnapshot
chiamata API.
Novità dalla versione
9,6