Skip to main content
Element Software
12.5
È disponibile una versione più recente di questo prodotto.
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

CreateSnapshot

Collaboratori

È 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.

Nota È 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

attributes

Elenco delle coppie nome-valore nel formato oggetto JSON.

Oggetto JSON

Nessuno

No

enableRemoteReplication

Specifica se lo snapshot verrà replicato o meno nello storage remoto. Valori possibili:

  • true: L'istantanea verrà replicata nell'archiviazione remota.

  • false: L'istantanea non verrà replicata nell'archiviazione remota.

booleano

falso

No

ensureSerialCreation

Specifica che lo snapshot non deve essere creato se è in corso una replica dello snapshot precedente. I valori possibili sono:

  • true: Ciò garantisce che venga replicata una sola istantanea alla volta. La creazione di un nuovo snapshot non avrà esito positivo se è ancora in corso la replica di uno snapshot precedente.

  • false: Predefinito. Questa creazione di snapshot è consentita se è ancora in corso la replica di un altro snapshot.

booleano

false

No

ExpirationTime (tempo di scadenza)

Specificare il tempo dopo il quale è possibile rimuovere lo snapshot. Non può essere utilizzato con retention. Se non si specifica ExpirationTime o Retention, lo snapshot non scadrà. Il formato dell'ora è una stringa di date ISO 8601 per la scadenza basata sull'ora, altrimenti non scadrà. Un valore di null causa la conservazione permanente dello snapshot. Un valore di fifo fa sì che lo snapshot venga conservato in base alla prima uscita, in relazione ad altri snapshot FIFO sul volume. L'API non riesce se non è disponibile spazio FIFO.

stringa

Nessuno

No

name

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

retention

Questo parametro è lo stesso del expirationTime parametro, ad eccezione del formato dell'ora HH:mm:ss. Se non vengono specificati né retention, l'istantanea non expirationTime scadrà.

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

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

volumeID

ID univoco dell'immagine del volume da cui copiare.

intero

Nessuno

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