StartBulkVolumeRead
Suggérer des modifications
PDF
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.
|
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 :
|
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