Créer un groupe d'accès au volume
Suggérer des modifications
PDF
Vous pouvez utiliser CreateVolumeAccessGroup pour créer un nouveau groupe d'accès aux volumes. Lorsque vous créez le groupe d'accès aux volumes, vous devez lui donner un nom et vous pouvez éventuellement saisir des initiateurs et des volumes.
Tout IQN initiateur ajouté au groupe d'accès aux volumes peut accéder à n'importe quel volume du groupe sans authentification CHAP.
|
Les volumes clonés n'héritent pas de l'appartenance au groupe d'accès aux volumes du volume source. |
Tenez compte des points suivants lors de la création de groupes d'accès aux volumes :
-
Un groupe d'accès aux volumes peut contenir jusqu'à 64 IQN d'initiateur.
-
Un initiateur ne peut appartenir qu'à un seul groupe d'accès aux volumes.
-
Un groupe d'accès aux volumes peut contenir jusqu'à 2000 volumes.
-
Chaque groupe d'accès aux volumes peut appartenir à un maximum de quatre groupes d'accès aux volumes.
Paramètres
Cette méthode possède les paramètres d'entrée suivants :
| Nom | Description | Type | Valeur par défaut | Obligatoire |
|---|---|---|---|---|
initiateurs |
Liste des identifiants ou noms d'initiateurs (IQN et WWPN) à inclure dans le groupe d'accès au volume. Si vous transmettez une liste de noms d'initiateurs, ces derniers sont créés s'ils n'existent pas déjà. Si vous transmettez une liste d'identifiants d'initiateurs, la méthode renvoie une erreur si l'un des initiateurs n'existe pas déjà. Il est déconseillé de transmettre les noms des initiateurs ; vous devez utiliser les identifiants des initiateurs chaque fois que cela est possible. |
tableau d'entiers ou tableau de chaînes de caractères (obsolète) |
Non |
|
nom |
Nom du groupe d'accès au volume. L'originalité n'est pas obligatoire, mais recommandée. 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 aux volumes. |
tableau d'entiers |
Non |
|
attributs |
Liste de paires nom-valeur au format objet JSON. |
objet JSON |
{} |
Non |
Valeurs de retour
Cette méthode renvoie les valeurs suivantes :
Nom |
Description |
Type |
volumeAccessGroup |
Un objet contenant des informations sur le groupe d'accès aux volumes nouvellement créé. |
|
volumeAccessGroupID |
L'identifiant du groupe d'accès au volume nouvellement créé. |
entier |
Exemple de demande
Les requêtes 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
}
}
Nouveautés depuis la version
9,6