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.

ModifySnapshot

Collaboratori

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

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

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

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

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