Skip to main content
Element Software
12.5 and 12.7
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

CreateGroupSnapshot

Contributeurs

Vous pouvez utiliser CreateGroupSnapshot pour créer une copie instantanée d'un groupe de volumes.

Vous pouvez utiliser ce snapshot ultérieurement comme sauvegarde ou restauration pour vous assurer que les données du groupe de volumes sont cohérentes pour le point dans le temps où vous avez créé le snapshot.

CLUSTER_PLÉNITUDE

Remarque Vous pouvez créer des instantanés si la plénitude de cluster est aux étapes 1, 2 ou 3. Vous ne pouvez pas créer de snapshots lorsque la plénitude de cluster atteint l'étape 4 ou 5.

Paramètres

Cette méthode présente les paramètres d'entrée suivants :

Nom Description Type Valeur par défaut Obligatoire

attributes

Liste des paires nom-valeur au format d'objet JSON.

Objet JSON

Aucune

Non

enableRemoteReplication

Indique si le snapshot sera répliqué sur le stockage distant ou non. Valeurs possibles :

  • true: Le snapshot sera répliqué sur le stockage distant.

  • false: Le snapshot ne sera pas répliqué sur le stockage distant.

booléen

faux

Non

ensureSerialCreation

Indique que le snapshot ne doit pas être créé si une réplication de snapshot précédente est en cours. Les valeurs possibles sont :

  • true: Cela garantit qu'un seul snapshot est répliqué à la fois. La création d'un nouvel instantané échoue si une réplication de snapshot précédente est toujours en cours.

  • false: Par défaut. La création de ce snapshot est autorisée si une autre réplication de snapshot est en cours.

booléen

false

Non

expirationTime

Spécifiez l'heure après laquelle le snapshot peut être supprimé. Ne peut pas être utilisé avec retention. Si aucun de ces deux cas expirationTime, ou retention le snapshot n'expire pas. Le format d'heure est une chaîne de date ISO 8601 pour l'expiration basée sur le temps, sinon elle n'expire pas. Valeur de null entraîne la conservation permanente de l'instantané. Valeur de fifo Provoque la conservation de l'instantané sur la base du premier entré, premier sorti, par rapport aux autres instantanés FIFO sur le volume. L'API échoue si aucun espace FIFO n'est disponible.

Chaîne de date ISO 8601

Aucune

Non

name

Nom du snapshot de groupe. Si aucun nom n'est saisi, la date et l'heure auxquelles le snapshot de groupe a été pris sont utilisées. La longueur maximale autorisée pour le nom est de 255 caractères.

chaîne

Aucune

Non

retention

Ce paramètre est le même que le expirationTime Paramètre, à l'exception du format de temps HH:mm:ss Si aucun de ces deux cas expirationTime ni retention le snapshot n'expire pas.

chaîne

Aucune

Non

snapMirrorLabel

Étiquette utilisée par le logiciel SnapMirror pour spécifier la règle de conservation des snapshots sur un terminal SnapMirror.

chaîne

Aucune

Non

volumes

ID unique de l'image de volume à copier.

Tableau d'ID de volume

Aucune

Oui.

Valeurs de retour

Cette méthode a les valeurs de retour suivantes :

Nom

Description

Type

membres

Liste des données de total de contrôle, des ID de volume et des ID de snapshots pour chaque membre du groupe. Valeurs valides :

  • Checksum : petite représentation des données dans le snapshot stocké. Cette somme de contrôle peut être utilisée ultérieurement pour comparer d'autres instantanés afin de détecter des erreurs dans les données. (chaîne)

  • SnapshotID : ID unique d'une copie d'instantané. L'ID du snapshot doit être d'un snapshot sur le volume donné. (entier)

  • ID de volume : ID du volume source du snapshot. (entier)

Baie d'objets JSON

GroupSnapshotID

ID unique du nouvel instantané de groupe.

ID de groupeSnapshot

GroupSnapshot

Objet contenant des informations sur le nouveau snapshot de groupe.

Exemple de demande

Les demandes pour cette méthode sont similaires à l'exemple suivant :

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

Exemple de réponse

Cette méthode renvoie une réponse similaire à l'exemple suivant :

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

Nouveau depuis la version

9.6