Skip to main content
Element Software
Une version plus récente de ce produit est disponible.
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

CreateInitiators

Contributeurs
PDF

Vous pouvez utiliser CreateInitiators pour créer plusieurs nouveaux IQN d'initiateurs ou WWPN (World Wide Port Name) et attribuer éventuellement des alias et des attributs. Lorsque vous utilisez CreateInitiators pour créer des initiateurs, vous pouvez également les ajouter aux groupes d'accès aux volumes.

Si l'opération ne parvient pas à créer l'un des initiateurs fournis dans le paramètre, la méthode renvoie une erreur et ne crée aucun initiateur (aucune achèvement partiel n'est possible).

Paramètre

Cette méthode dispose du paramètre d'entrée suivant :

Nom Description Type Valeur par défaut Obligatoire

initiateurs

Une liste d'objets contenant les caractéristiques de chaque nouvel initiateur. Objets :

  • alias: (Facultatif) le nom convivial à attribuer à cet initiateur. (chaîne)

  • attributes: (Facultatif) ensemble d'attributs JSON à attribuer à cet initiateur. (Objet JSON)

  • chapUsername: (Facultatif) Nom d'utilisateur CHAP unique pour cet initiateur. Par défaut, le nom de l'initiateur (IQN) s'il n'est pas spécifié lors de la création et requiChap est true. (chaîne)

  • initiatorSecret: (Facultatif) le secret CHAP utilisé pour authentifier l'initiateur. Utilise par défaut un code secret généré aléatoirement si non spécifié lors de la création et que requiChap est true. (chaîne)

  • name: (Obligatoire) le nom de l'initiateur (IQN ou WWPN) à créer. (chaîne)

  • requireChap: (Facultatif) vrai si CHAP est requis lors de la connexion de session pour cet initiateur. (booléen)

  • targetSecret: (Facultatif) le secret CHAP utilisé pour authentifier la cible (lors de l'utilisation de l'authentification CHAP mutuelle). Utilise par défaut un code secret généré aléatoirement si non spécifié lors de la création et que requiChap est true. (chaîne)

  • virtualNetworkIDs: (Facultatif) la liste des identificateurs de réseau virtuel associés à cet initiateur. Si vous définissez un ou plusieurs réseaux virtuels, cet initiateur ne peut se connecter qu'à ces réseaux virtuels. Si vous ne définissez aucun réseau virtuel, cet initiateur peut se connecter à tous les réseaux.

  • volumeAccessGroupID: (Facultatif) ID du groupe d'accès au volume auquel ce nouvel initiateur sera ajouté. (entier)

Baie d'objets JSON

Aucune

Oui

Retour de valeur

Cette méthode a la valeur de retour suivante :

Nom

Description

Type

initiateurs

Liste des objets décrivant les nouveaux initiateurs.

initiateur baie

Erreur

Cette méthode peut renvoyer l'erreur suivante :

Nom

Description

XInitiatorExists

Renvoyé si le nom de l'initiateur choisi existe déjà.

Exemple de demande

Les demandes pour cette méthode sont similaires à l'exemple suivant :

{
  "id": 3291,
  "method": "CreateInitiators",
  "params": {
    "initiators": [
      {
        "name": "iqn.1993-08.org.debian:01:288170452",
        "alias": "example1"
      },
      {
        "name": "iqn.1993-08.org.debian:01:297817012",
        "alias": "example2"
      }
    ]
  }
}

Exemple de réponse

Cette méthode renvoie une réponse similaire à l'exemple suivant :

{
  "id": 3291,
  "result": {
    "initiators": [
      {
        "alias": "example1",
        "attributes": {},
        "initiatorID": 145,
        "initiatorName": "iqn.1993-08.org.debian:01:288170452",
        "volumeAccessGroups": []
      },
      {
        "alias": "example2",
        "attributes": {},
        "initiatorID": 146,
        "initiatorName": "iqn.1993-08.org.debian:01:297817012",
        "volumeAccessGroups": []
      }
    ]
  }
}

Nouveau depuis la version

9,6

Trouvez plus d'informations

Initiateurs