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

Démarrer la lecture en masse

Contributeurs netapp-pcarriga

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

Seuls deux processus de traitement de volume en vrac peuvent s'exécuter simultanément sur un volume. Lors de l'initialisation de la session, les données sont lues à partir d'un volume de stockage SolidFire pour être stockées sur une source de sauvegarde externe. Les données externes sont accessibles via un serveur web fonctionnant sur un nœud de stockage Element. Les informations d'interaction avec le 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 masse, un instantané du volume est créé et cet instantané est supprimé une fois la lecture terminée. Vous pouvez également lire un instantané du volume en saisissant l'identifiant de l'instantané comme paramètre. Lorsque vous lisez un instantané précédent, le système ne crée pas de nouvel instantané du volume et ne supprime pas non plus l'instantané précédent une fois la lecture terminée.

Remarque Ce processus crée un nouvel instantané si l'identifiant d'un instantané existant n'est pas fourni. Des instantanés peuvent être créés si le taux de remplissage du cluster est au stade 2 ou 3. Les instantanés ne sont pas créés lorsque le niveau de remplissage du cluster atteint 4 ou 5.

Paramètres

Cette méthode possède 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 l'un ou l'autre :

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

  • `native`Les données opaques renvoyées sont plus petites et stockées et écrites plus efficacement lors d'une écriture ultérieure sur un volume en bloc.

chaîne

Aucune

Oui

volumeID

L'identifiant du volume à lire.

entier

Aucune

Oui

snapshotID

L'identifiant d'un instantané créé précédemment et utilisé pour les lectures de volumes en masse. Si aucun identifiant n'est saisi, une capture instantanée de l'image du volume actif actuel est effectuée.

entier

Aucune

Non

scénario

Le nom d'un script exécutable. Si aucun nom de script n'est fourni, 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

Paramètres du script

Paramètres JSON à transmettre au script.

objet JSON

Aucune

Non

attributs

Liste de paires nom-valeur au format objet JSON. "Apprendre encore plus".

objet JSON

Aucune

Non

Valeurs de retour

Cette méthode renvoie les valeurs suivantes :

Nom

Description

Type

asyncHandle

L'identifiant du processus asynchrone dont l'achèvement doit être vérifié.

entier

clé

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

chaîne

URL

URL permettant d'accéder au serveur web du nœud.

chaîne

Exemple de demande

Les requêtes 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/"
   }
}

Nouveautés depuis la version

9,6