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.

CreateGroupSnapshot

Beitragende
PDFs

Mit können Sie CreateGroupSnapshot eine zeitpunktgenaue Kopie einer Volume-Gruppe erstellen.

Sie können diesen Snapshot später als Backup oder Rollback verwenden, um sicherzustellen, dass die Daten in der Gruppe von Volumes für den Zeitpunkt, zu dem Sie den Snapshot erstellt haben, konsistent sind.

CLUSTER_FÜLLE

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

expirationTime

Geben Sie die Zeit an, nach der der Snapshot entfernt werden kann. Kann nicht mit verwendet retention werden. Wenn weder, retention noch expirationTime 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 bewirkt, dass der Snapshot relativ zu anderen FIFO-Snapshots auf der Basis des fifo FIFO-zuerst-heraus (First-in-first-out) beibehalten wird. Die API schlägt fehl, wenn kein FIFO-Speicherplatz verfügbar ist.

ISO 8601-Datumszeichenfolge

Keine

Nein

name

Der Name des Gruppen-Snapshots. Wenn kein Name eingegeben wird, wird das Datum und die Uhrzeit der Erstellung des Gruppenschnappschusses 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

volumes

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

VolumeID-Array

Keine

Ja.

Rückgabewerte

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

Name

Beschreibung

Typ

Mitglieder

Liste der Prüfsummen, Volume-IDs und Snapshot-IDs für jedes Mitglied der Gruppe. Gültige Werte:

  • Prüfsumme: Eine kleine Zeichenfolgendarstellung der Daten im gespeicherten Snapshot. 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 eines Snapshots, aus dem der neue Snapshot erstellt wird. Die Snapshot-ID muss von einem Snapshot auf dem angegebenen Volume stammen. (Ganze Zahl)

  • VolumeID: Die Quell-Volume-ID für den Snapshot. (Ganze Zahl)

JSON-Objekt-Array

GruppenSnapshotID

Eindeutige ID des neuen Gruppen-Snapshots.

Gruppen-Snapshot-ID

GroupSnapshot

Objekt mit Informationen zum neu erstellten Gruppen-Snapshot.

GroupSnapshot

Anforderungsbeispiel

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

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

Antwortbeispiel

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

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

Neu seit Version

9,6