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.

CreateGroupSnapshot

Collaboratori
PDF

È possibile utilizzare CreateGroupSnapshot per creare una copia point-in-time di un gruppo di volumi.

È possibile utilizzare questo snapshot in un secondo momento come backup o rollback per garantire che i dati nel gruppo di volumi siano coerenti per il momento in cui è stata creata lo snapshot.

CLUSTER_FULLNESS

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

Specificare il tempo dopo il quale è possibile rimuovere lo snapshot. Non può essere utilizzato con retention. Se non vengono specificati né expirationTime, né , retention l'istantanea non scade. 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 su base FIFO (First-in-First-out), in relazione ad altri snapshot FIFO sul volume. L'API non riesce se non è disponibile spazio FIFO.

Stringa di dati ISO 8601

Nessuno

No

name

Il nome dello snapshot di gruppo. Se non viene immesso alcun nome, vengono utilizzate la data e l'ora in cui è stata eseguita l'istantanea del gruppo. 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

volumes

ID univoco dell'immagine del volume da cui copiare.

Array volumeID

Nessuno

Sì

Valori restituiti

Questo metodo ha i seguenti valori restituiti:

Nome

Descrizione

Tipo

membri

Elenco di checksum, volumeID e snapshotID per ciascun membro del gruppo. Valori validi:

  • Checksum: Una piccola rappresentazione a stringa dei dati 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 di uno snapshot da cui viene creato il nuovo snapshot. Lo snapshotID deve provenire da uno snapshot sul volume specificato. (intero)

  • VolumeID (ID volume): L'ID del volume di origine per lo snapshot. (intero)

Array di oggetti JSON

GroupSnapshotID

ID univoco del nuovo snapshot di gruppo.

ID groupSnapshot

GroupSnapshot

Oggetto contenente informazioni sullo snapshot di gruppo appena creato.

GroupSnapshot

Esempio di richiesta

Le richieste per questo metodo sono simili all'esempio seguente:

{
   "method": "CreateGroupSnapshot",
   "params": {
      "volumes": [1,2]
   },
   "id": 1
}

Esempio di risposta

Questo metodo restituisce una risposta simile all'esempio seguente:

{
  "id": 1,
  "result": {
    "groupSnapshot": {
      "attributes": {},
      "createTime": "2016-04-04T22:43:29Z",
      "groupSnapshotID": 45,
      "groupSnapshotUUID": "473b78a3-ef85-4541-9438-077306b2d3ca",
      "members": [
        {
          "attributes": {},
          "checksum": "0x0",
          "createTime": "2016-04-04T22:43:29Z",
          "enableRemoteReplication": false,
          "expirationReason": "None",
          "expirationTime": null,
          "groupID": 45,
          "groupSnapshotUUID": "473b78a3-ef85-4541-9438-077306b2d3ca",
          "name": "2016-04-04T22:43:29Z",
          "snapshotID": 3323,
          "snapshotUUID": "7599f200-0092-4b41-b362-c431551937d1",
          "status": "done",
          "totalSize": 5000658944,
          "virtualVolumeID": null,
          "volumeID": 1
        },
        {
          "attributes": {},
          "checksum": "0x0",
          "createTime": "2016-04-04T22:43:29Z",
          "enableRemoteReplication": false,
          "expirationReason": "None",
          "expirationTime": null,
          "groupID": 45,
          "groupSnapshotUUID": "473b78a3-ef85-4541-9438-077306b2d3ca",
          "name": "2016-04-04T22:43:29Z",
          "snapshotID": 3324,
          "snapshotUUID": "a0776a48-4142-451f-84a6-5315dc37911b",
          "status": "done",
          "totalSize": 6001000448,
          "virtualVolumeID": null,
          "volumeID": 2
        }
      ],
      "name": "2016-04-04T22:43:29Z",
      "status": "done"
    },
    "groupSnapshotID": 45,
    "members": [
      {
        "checksum": "0x0",
        "snapshotID": 3323,
        "snapshotUUID": "7599f200-0092-4b41-b362-c431551937d1",
        "volumeID": 1
      },
      {
        "checksum": "0x0",
        "snapshotID": 3324,
        "snapshotUUID": "a0776a48-4142-451f-84a6-5315dc37911b",
        "volumeID": 2
      }
    ]
  }
}

Novità dalla versione

9,6