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

CreateVolumeAccessGroup

Contributeurs

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.

Remarque 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

Trouvez plus d'informations