CreateVolumeAccessGroup
Suggérer des modifications
PDF
Vous pouvez utiliser CreateVolumeAccessGroup pour créer un nouveau groupe d'accès de volume. Lorsque vous créez le groupe d'accès aux volumes, vous devez lui attribuer un nom et vous pouvez éventuellement entrer des initiateurs et des volumes.
Tout IQN initiateur que vous ajoutez au groupe d'accès de volume peut accéder à n'importe quel volume du groupe sans authentification CHAP.
|
Les volumes clonés n'héritent pas de l'appartenance des groupes d'accès aux volumes à partir du volume source. |
Lorsque vous créez des groupes d'accès de volume, tenez compte des éléments suivants :
-
Un groupe d'accès de volume peut contenir jusqu'à 64 IQN d'initiateur.
-
Un initiateur ne peut appartenir qu'à un seul groupe d'accès au volume.
-
Un groupe d'accès aux volumes peut contenir jusqu'à 2000 volumes.
-
Chaque groupe d'accès aux volumes peut appartenir à quatre groupes d'accès aux volumes au maximum.
Paramètres
Cette méthode présente les paramètres d'entrée suivants :
| Nom | Description | Type | Valeur par défaut | Obligatoire |
|---|---|---|---|---|
initiateurs |
Liste des ID ou noms d'initiateurs (IQN et WWPN) à inclure dans le groupe d'accès aux volumes. Si vous transmettez une liste de noms initiateurs, les initiateurs sont créés s'ils n'existent pas déjà. Si vous transmettez une liste d'ID initiateurs, la méthode renvoie une erreur si l'un des initiateurs n'existe pas. Le fait de transmettre des noms d'initiateurs est obsolète. Vous devez utiliser dans la mesure du possible les ID d'initiateurs. |
matrice entière ou matrice de chaînes (obsolète) |
Non |
|
nom |
Nom du groupe d'accès de volume. Non obligatoire pour être unique, mais recommandé. Doit comporter entre 1 et 64 caractères. |
chaîne |
Aucune |
Oui |
volumes |
Liste des ID de volume à inclure dans le groupe d'accès de volume. |
tableau entier |
Non |
|
attributs |
Liste des paires nom-valeur au format d'objet JSON. |
Objet JSON |
{} |
Non |
Valeurs de retour
Cette méthode a les valeurs de retour suivantes :
Nom |
Description |
Type |
Volume AccessGroup |
Objet contenant des informations sur le nouveau groupe d'accès de volume. |
|
Volume AccessGroupID |
L'ID du nouveau groupe d'accès de volume. |
entier |
Exemple de demande
Les demandes pour cette méthode sont similaires à l'exemple suivant :
{
"method": "CreateVolumeAccessGroup",
"params": {
"name": "myaccessgroup",
"initiators": ["iqn.1993-08.org.debian: 01: a31b1d799d5c"],
"volumes": [327],
"attributes": {}
}
}
Exemple de réponse
Cette méthode renvoie une réponse similaire à l'exemple suivant :
{
"id": null,
"result": {
"volumeAccessGroup": {
"attributes": {},
"deletedVolumes": [],
"initiatorIDs": [
95
],
"initiators": [
"iqn.1993-08.org.debian: 01: a31b1d799d5c"
],
"name": "myaccessgroup",
"volumeAccessGroupID": 96,
"volumes": [
327
]
},
"volumeAccessGroupID": 96
}
}
Nouveau depuis la version
9,6