Skip to main content
Element Software
Eine neuere Version dieses Produkts ist erhältlich.
Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

Erstellen von Snapshot

Beitragende
PDFs

Sie können zum Erstellen einer zeitpunktgenauen Kopie eines Volumes verwenden CreateSnapshot. Sie können einen Snapshot von einem beliebigen Volume oder von einem vorhandenen Snapshot erstellen.

Wenn Sie mit dieser API-Methode keine SnapshotID bereitstellen, wird ein Snapshot aus dem aktiven Zweig des Volumes erstellt. Wenn das Volume, von dem der Snapshot erstellt wird, in einem Remote-Cluster repliziert wird, kann der Snapshot auch auf dasselbe Ziel repliziert werden. Verwenden Sie den Parameter enableRemoteReplication, um die Snapshot-Replikation zu aktivieren.

Hinweis Sie können Snapshots erstellen, wenn die Cluster-Fülle sich an Phase 1, 2 oder 3 befindet. Sie können keine Snapshots erstellen, wenn die Cluster-Fülle die Phase 4 oder 5 erreicht.

Parameter

Diese Methode verfügt über die folgenden Eingabeparameter:

Name Beschreibung Typ Standardwert Erforderlich

attributes

Liste von Name-Wert-Paaren im JSON-Objektformat.

JSON Objekt

Keine

Nein

enableRemoteReplication

Gibt an, ob der Snapshot zum Remote-Speicher repliziert werden soll oder nicht. Mögliche Werte:

  • true: Der Snapshot wird auf den Remote-Speicher repliziert.

  • false: Der Snapshot wird nicht in den Remote-Speicher repliziert.

boolesch

Falsch

Nein

ensureSerialCreation

Gibt an, dass der Snapshot nicht erstellt werden soll, wenn eine vorherige Snapshot-Replikation ausgeführt wird. Mögliche Werte sind:

  • true: Damit wird sichergestellt, dass jeweils nur ein Snapshot repliziert wird. Die Erstellung eines neuen Snapshots schlägt fehl, wenn noch eine vorherige Snapshot-Replikation ausgeführt wird.

  • false: Standard. Diese Snapshot-Erstellung ist zulässig, wenn noch eine andere Snapshot-Replikation ausgeführt wird.

boolesch

false

Nein

Zeit für AufwandsZeit

Geben Sie die Zeit an, nach der der Snapshot entfernt werden kann. Kann nicht mit verwendet retention werden. Wenn weder ExpirationTime noch Retention angegeben werden, läuft der Snapshot nicht ab. Das Zeitformat ist eine Datumstringfolge nach ISO 8601 für die zeitbasierte Ablaufzeit, da sie sonst nicht abläuft. Ein Wert von null bewirkt, dass der Snapshot dauerhaft beibehalten wird. Ein Wert von fifo bewirkt, dass der Snapshot im Verhältnis zu anderen FIFO-Snapshots auf dem Volume auf First-in-First-Out-Basis beibehalten wird. Die API schlägt fehl, wenn kein FIFO-Speicherplatz verfügbar ist.

Zeichenfolge

Keine

Nein

name

Der Name des Snapshots. Wenn kein Name eingegeben wird, wird das Datum und die Uhrzeit der Snapshot-Erstellung verwendet. Die maximal zulässige Namenslänge beträgt 255 Zeichen.

Zeichenfolge

Keine

Nein

retention

Dieser Parameter ist mit dem Parameter identisch expirationTime, außer das Zeitformat ist HH:mm:ss Wenn weder expirationTime noch retention angegeben werden, läuft der Snapshot nicht ab.

Zeichenfolge

Keine

Nein

snapMirrorLabel

Das von der SnapMirror Software verwendete Etikett, um die Richtlinie zur Snapshot-Aufbewahrung auf einem SnapMirror Endpunkt anzugeben.

Zeichenfolge

Keine

Nein

snapshotID

Eindeutige ID eines Snapshots, aus dem der neue Snapshot erstellt wird. Die übergebene Snapshot-ID muss ein Snapshot auf dem angegebenen Volume sein.

Ganzzahl

Keine

Nein

volumeID

Eindeutige ID des Volume-Images, aus dem kopiert werden soll

Ganzzahl

Keine

Ja.

Rückgabewerte

Diese Methode verfügt über die folgenden Rückgabewerte:

Name

Beschreibung

Typ

Prüfsumme

Eine Zeichenfolge, die die richtigen Ziffern im gespeicherten Snapshot darstellt. Diese Prüfsumme kann später verwendet werden, um andere Snapshots zu vergleichen, um Fehler in den Daten zu erkennen.

Zeichenfolge

Snapshot-ID

Eindeutige ID des neuen Snapshots.

Snapshot-ID

snapshot

Ein Objekt, das Informationen über den neu erstellten Snapshot enthält.

snapshot

Anforderungsbeispiel

Anforderungen für diese Methode sind ähnlich wie das folgende Beispiel:

{
   "method": "CreateSnapshot",
   "params": {
      "volumeID": 1
   },
   "id": 1
}

Antwortbeispiel

Diese Methode gibt eine Antwort zurück, die dem folgenden Beispiel ähnelt:

{
  "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
  }
}

Ausnahme

Eine xNotPrimary-Ausnahme wird angezeigt, wenn die CreateSnapshot API aufgerufen wird und der Snapshot nicht erstellt werden kann. Dieses Verhalten ist zu erwarten. Versuchen Sie den API-Aufruf erneut CreateSnapshot.

Neu seit Version

9,6