La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Modificateurs

10/01/2024 Contributeurs

Vous pouvez utiliser ModifyInitiators la méthode pour modifier les attributs d'un ou plusieurs initiateurs existants.

Vous ne pouvez pas modifier le nom d'un initiateur existant. Si vous devez modifier le nom d'un initiateur, supprimez-le d'abord avec DeleteInitiatorsla méthode et créez-en un nouveau avec la CreateInitiators méthode.

Si Modify Initiators ne parvient pas à modifier l'un des initiateurs fournis dans le paramètre, la méthode renvoie une erreur et ne modifie 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

Liste d'objets contenant les caractéristiques de chaque initiateur à modifier. Objets possibles :

alias: (Facultatif) Un nouveau nom convivial à attribuer à l'initiateur. (chaîne)
attributes: (Facultatif) Un nouvel ensemble d'attributs JSON à attribuer à l'initiateur. (Objet JSON)
chapUsername: (Facultatif) Un nouveau nom d'utilisateur CHAP unique pour cet initiateur. (chaîne)
forceDuringUpgrade: Terminez la modification de l'initiateur lors d'une mise à niveau.
initiatorID: (Obligatoire) l'ID de l'initiateur à modifier. (entier)
initiatorSecret: (Facultatif) Un nouveau code secret CHAP utilisé pour authentifier l'initiateur. (chaîne)
requireChap: (Facultatif) vrai si CHAP est requis pour cet initiateur. (booléen)
targetSecret: (Facultatif) Un nouveau code secret CHAP utilisé pour authentifier la cible (lors de l'utilisation de l'authentification CHAP mutuelle). (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 l'initiateur doit être ajouté. Si l'initiateur était auparavant dans un autre groupe d'accès de volume, il est supprimé de l'ancien groupe d'accès de volume. Si cette clé est présente mais nulle, l'initiateur est supprimé de son groupe d'accès de volume actuel, mais n'est placé dans aucun nouveau groupe d'accès de volume. (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 initiateurs récemment modifiés.

initiateur baie

Exemple de demande

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

{
  "id": 6683,
  "method": "ModifyInitiators",
  "params": {
    "initiators": [
      {
        "initiatorID": 2,
        "alias": "alias1",
        "volumeAccessGroupID": null
      },
      {
        "initiatorID": 3,
        "alias": "alias2",
        "volumeAccessGroupID": 1
      }
    ]
  }
}

Exemple de réponse

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

{
  "id": 6683,
  "result": {
    "initiators": [
      {
        "alias": "alias1",
        "attributes": {},
        "initiatorID": 2,
        "initiatorName": "iqn.1993-08.org.debian:01:395543635",
        "volumeAccessGroups": []
      },
      {
        "alias": "alias2",
        "attributes": {},
        "initiatorID": 3,
        "initiatorName": "iqn.1993-08.org.debian:01:935573135",
        "volumeAccessGroups": [
          1
        ]
      }
    ]
  }
}

Nouveau depuis la version

9,6