Skip to main content
Element Software
Une version plus récente de ce produit est disponible.
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

StartBulkVolumeRead

Contributeurs

Vous pouvez utiliser la StartBulkVolumeRead méthode pour démarrer une session de lecture de volume en bloc sur un volume spécifié.

Seuls deux processus en bloc peuvent être exécutés simultanément sur un volume. Lorsque vous initialisez la session, les données sont lues à partir d'un volume de stockage SolidFire et stockées sur une source de sauvegarde externe. Les données externes sont accessibles par un serveur web s'exécutant sur un nœud de stockage Element. Les informations d'interaction du serveur pour l'accès aux données externes sont transmises par un script exécuté sur le système de stockage.

Au début d'une opération de lecture de volume en bloc, un snapshot du volume est créé et l'instantané est supprimé lorsque la lecture est terminée. Vous pouvez également lire un instantané du volume en entrant l'ID de l'instantané en tant que paramètre. Lorsque vous lisez un instantané précédent, le système ne crée pas de nouveau snapshot du volume et ne supprime pas le snapshot précédent une fois la lecture terminée.

Remarque Ce processus crée un nouvel instantané si l'ID d'un snapshot existant n'est pas fourni. Des snapshots peuvent être créés si la plénitude du cluster est à l'étape 2 ou 3. Les snapshots ne sont pas créés lorsque la plénitude de cluster est à 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

format

Le format des données de volume. Peut être :

  • uncompressed: Chaque octet du volume est renvoyé sans compression.

  • native: Les données opaques sont renvoyées, plus petites et plus efficaces, stockées et écrites sur une écriture de volume en bloc ultérieure.

chaîne

Aucune

Oui

ID de volume

ID du volume à lire.

entier

Aucune

Oui

ID de snapshot

ID d'un snapshot créé précédemment, utilisé pour les lectures de volume en bloc. Si aucun ID n'est saisi, un instantané de l'image de volume active actuelle est créé.

entier

Aucune

Non

script

Nom d'un script exécutable. Si aucun nom de script n'est indiqué, la clé et l'URL sont nécessaires pour accéder aux nœuds de stockage Element. Le script est exécuté sur le nœud principal, et la clé et l'URL sont renvoyées au script afin que le serveur Web local puisse être contacté.

chaîne

Aucune

Non

ScriptParameters

Paramètres JSON à transmettre au script.

Objet JSON

Aucune

Non

attributs

Liste des paires nom-valeur au format d'objet JSON. "En savoir plus >>".

Objet JSON

Aucune

Non

Valeurs de retour

Cette méthode a les valeurs de retour suivantes :

Nom

Description

Type

Asynchrone

ID du processus asynchrone à vérifier pour l'achèvement.

entier

clé

Clé opaque identifiant la session de manière unique.

chaîne

url

URL d'accès au serveur Web du nœud.

chaîne

Exemple de demande

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

{
   "method": "StartBulkVolumeRead",
   "params": {
      "volumeID" : 5,
      "format"  : "native",
      "snapshotID" : 2
   },
   "id": 1
}

Exemple de réponse

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

{
      "id" : 1,
   "result" : {
      "asyncHandle" : 1,
      "key" : "11eed8f086539205beeaadd981aad130",
      "url" : "https://127.0.0.1:44000/"
   }
}

Nouveau depuis la version

9,6