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.

Compte Modifier

Contributeurs

Vous pouvez utiliser la ModifyAccount méthode pour modifier un compte existant.

Lorsque vous verrouillez un compte, toutes les connexions existantes de ce compte sont immédiatement résiliées. Lorsque vous modifiez les paramètres CHAP d'un compte, toutes les connexions existantes restent actives et les nouveaux paramètres CHAP sont utilisés pour les connexions ou les connexions suivantes. Pour effacer les attributs d'un compte, spécifiez {} pour le paramètre attributs.

Paramètres

Cette méthode présente les paramètres d'entrée suivants :

Nom Description Type Valeur par défaut Obligatoire

ID compte

ID compte à modifier.

entier

Aucune

Oui

attributs

Liste des paires nom-valeur au format d'objet JSON.

Objet JSON

Aucune

Non

EnableChap

Indique si les informations d'identification de compte CHAP peuvent être utilisées par un initiateur pour accéder aux volumes.

booléen

Aucune

Non

InitiatorSecret

Le secret CHAP à utiliser pour l'initiateur. Ce secret doit comporter 12-16 caractères et être impénétrable. Le secret CHAP de l'initiateur doit être unique et ne peut pas être identique au secret CHAP de la cible.

chaîne

Aucune

Non

état

Statut du compte. Valeurs possibles :

  • Active : le compte est actif et les connexions sont autorisées.

  • Verrouillé : le compte est verrouillé et les connexions sont refusées.

chaîne

Aucune

Non

TargetSecret

Le secret CHAP à utiliser pour la cible (authentification CHAP mutuelle). Ce secret doit comporter 12-16 caractères et être impénétrable. Le secret CHAP de la cible doit être unique et ne peut pas être identique au secret CHAP de l'initiateur.

chaîne

Aucune

Non

nom d'utilisateur

Permet de modifier le nom d'utilisateur associé au compte. (Doit comporter entre 1 et 64 caractères).

chaîne

Aucune

Non

Retour de valeur

Cette méthode a la valeur de retour suivante :

Nom

Description

Type

compte

Objet contenant des informations sur le compte modifié.

Exemple de demande

Les demandes de cette méthode sont similaires à l'exemple suivant. Dans cet exemple, les attributs sont effacés en spécifiant {} pour eux :

{
   "method": "ModifyAccount",
   "params": {
     "accountID"  : 25,
     "status"   : "locked",
     "attributes" : {}
   },
   "id" : 1
}

Exemple de réponse

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

{
    "account": {
        "storageContainerID": "abcdef01-1234-5678-90ab-cdef01234567",
        "username": "user1",
        "accountID": 1,
        "volumes": [
        ],
        "enableChap": true,
        "initiatorSecret": "txz123456q890",
        "attributes": {
        },
        "status": active",
        "targetSecret": "rxe123b567890"
    }
}

Nouveau depuis la version

9,6