Konto ändern
Sie können die ModifyAccount Methode zum Ändern eines bestehenden Kontos.
Wenn Sie ein Konto sperren, werden alle bestehenden Verbindungen dieses Kontos sofort beendet. Wenn Sie die CHAP-Einstellungen eines Kontos ändern, bleiben alle bestehenden Verbindungen aktiv, und die neuen CHAP-Einstellungen werden bei nachfolgenden Verbindungen oder Wiederverbindungen verwendet. Um die Attribute eines Kontos zu löschen, geben Sie {} für den Parameter „attributes“ an.
Parameter
Diese Methode hat die folgenden Eingabeparameter:
| Name | Beschreibung | Typ | Standardwert | Erforderlich |
|---|---|---|---|---|
Konto-ID |
AccountID für das zu ändernde Konto. |
ganze Zahl |
Keine |
Ja |
Attribute |
Liste von Name-Wert-Paaren im JSON-Objektformat. |
JSON-Objekt |
Keine |
Nein |
enableChap |
Legt fest, ob CHAP-Kontodaten von einem Initiator für den Zugriff auf Volumes verwendet werden können. |
boolescher Wert |
Keine |
Nein |
Initiatorgeheimnis |
Das CHAP-Geheimnis für den Initiator. Dieses Geheimnis muss 12 bis 16 Zeichen lang sein und undurchschaubar sein. Das CHAP-Geheimnis des Initiators muss eindeutig sein und darf nicht mit dem CHAP-Geheimnis des Ziels übereinstimmen. |
Schnur |
Keine |
Nein |
Status |
Status des Kontos. Mögliche Werte:
|
Schnur |
Keine |
Nein |
Zielgeheimnis |
Der CHAP-Schlüssel, der für das Ziel verwendet werden soll (gegenseitige CHAP-Authentifizierung). Dieses Geheimnis muss 12 bis 16 Zeichen lang sein und undurchschaubar sein. Das Ziel-CHAP-Geheimnis muss eindeutig sein und darf nicht mit dem Initiator-CHAP-Geheimnis übereinstimmen. |
Schnur |
Keine |
Nein |
Benutzername |
Dient dazu, den mit dem Konto verknüpften Benutzernamen zu ändern. (Muss zwischen 1 und 64 Zeichen lang sein). |
Schnur |
Keine |
Nein |
Rückgabewert
Diese Methode hat folgenden Rückgabewert:
Name |
Beschreibung |
Typ |
Konto |
Ein Objekt, das Informationen über das geänderte Konto enthält. |
Anforderungsbeispiel
Anfragen für diese Methode ähneln dem folgenden Beispiel. In diesem Beispiel werden die Attribute durch Angabe von {} gelöscht:
{
"method": "ModifyAccount",
"params": {
"accountID" : 25,
"status" : "locked",
"attributes" : {}
},
"id" : 1
}
Antwortbeispiel
Diese Methode liefert eine Antwort, die dem folgenden Beispiel ähnelt:
{
"account": {
"storageContainerID": "abcdef01-1234-5678-90ab-cdef01234567",
"username": "user1",
"accountID": 1,
"volumes": [
],
"enableChap": true,
"initiatorSecret": "txz123456q890",
"attributes": {
},
"status": active",
"targetSecret": "rxe123b567890"
}
}
Neu seit Version
9,6