ModifySnapshot
È possibile utilizzare ModifySnapshot
per modificare gli attributi attualmente assegnati a uno snapshot. È inoltre possibile utilizzare questo metodo per consentire la replica remota degli snapshot creati sul volume di lettura/scrittura (di origine) in un cluster di storage di destinazione che esegue il software Element.
Parametri
Questo metodo ha i seguenti parametri di input:
Nome |
Descrizione |
Tipo |
Valore predefinito |
Obbligatorio |
EnableRemoteReplication |
Consente di replicare lo snapshot creato in un cluster di storage remoto. Valori possibili:
|
booleano |
falso |
No |
ExpirationTime (tempo di scadenza) |
Specificare il tempo dopo il quale è possibile rimuovere lo snapshot. Non può essere utilizzato con la conservazione. Se non vengono specificati né expirationTime, né la conservazione sullo snapshot originale, lo snapshot non scadrà. Il formato dell'ora è una stringa di date ISO 8601 per la scadenza basata sull'ora, altrimenti non scadrà. Il valore Null fa sì che lo snapshot venga conservato in modo permanente. Un valore di fifo fa sì che lo snapshot venga conservato in base al principio FIFO (first-in-first-out), rispetto ad altri snapshot FIFO sul volume. L'API non riesce se non è disponibile spazio FIFO. |
Stringa di dati ISO 8601 |
Nessuno |
No |
nome |
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 |
SnapMirrorLabel |
Etichetta utilizzata dal software SnapMirror per specificare il criterio di conservazione delle snapshot su un endpoint SnapMirror. |
stringa |
Nessuno |
No |
SnapshotID |
Identificatore dello snapshot. |
stringa |
Nessuno |
Sì |
Valore restituito
Questo metodo ha il seguente valore restituito:
Nome |
Descrizione |
Tipo |
snapshot |
Oggetto contenente informazioni sullo snapshot appena modificato. |
Esempio di richiesta
Le richieste per questo metodo sono simili all'esempio seguente:
{ "method": "ModifySnapshot", "params": { "snapshotID": 3114, "enableRemoteReplication": "true", "name" : "Chicago" }, "id": 1 }
Esempio di risposta
Questo metodo restituisce una risposta simile all'esempio seguente:
{ "id": 1, "result": { "snapshot": { "attributes": {}, "checksum": "0x0", "createTime": "2016-04-04T17:26:20Z", "enableRemoteReplication": true, "expirationReason": "None", "expirationTime": null, "groupID": 0, "groupSnapshotUUID": "00000000-0000-0000-0000-000000000000", "name": "test1", "snapshotID": 3114, "snapshotUUID": "5809a671-4ad0-4a76-9bf6-01cccf1e65eb", "status": "done", "totalSize": 5000658944, "virtualVolumeID": null, "volumeID": 1 } } }
Novità dalla versione
9,6