ModifyAccount
È possibile utilizzare il ModifyAccount
metodo per modificare un account esistente.
Quando si blocca un account, tutte le connessioni esistenti da tale account vengono immediatamente interrotte. Quando si modificano le impostazioni CHAP di un account, tutte le connessioni esistenti rimangono attive e le nuove impostazioni CHAP vengono utilizzate per le connessioni o le riconnessione successive. Per cancellare gli attributi di un account, specificare {} come parametro degli attributi.
Parametri
Questo metodo ha i seguenti parametri di input:
Nome | Descrizione | Tipo | Valore predefinito | Obbligatorio |
---|---|---|---|---|
ID account |
AccountID dell'account da modificare. |
intero |
Nessuno |
Sì |
attributi |
Elenco delle coppie nome-valore nel formato oggetto JSON. |
Oggetto JSON |
Nessuno |
No |
EnableChap |
Specifica se le credenziali dell'account CHAP possono essere utilizzate da un iniziatore per accedere ai volumi. |
booleano |
Nessuno |
No |
InitatorSecret |
Il segreto CHAP da utilizzare per l'iniziatore. Questo segreto deve essere di 12-16 caratteri e deve essere impenetrabile. Il segreto CHAP iniziatore deve essere univoco e non può essere lo stesso del segreto CHAP di destinazione. |
stringa |
Nessuno |
No |
stato |
Stato dell'account. Valori possibili:
|
stringa |
Nessuno |
No |
TargetSecret |
Il segreto CHAP da utilizzare per la destinazione (autenticazione CHAP reciproca). Questo segreto deve essere di 12-16 caratteri e deve essere impenetrabile. Il segreto CHAP di destinazione deve essere univoco e non può essere lo stesso del segreto CHAP iniziatore. |
stringa |
Nessuno |
No |
nome utente |
Consente di modificare il nome utente associato all'account. (La lunghezza deve essere compresa tra 1 e 64 caratteri). |
stringa |
Nessuno |
No |
Valore restituito
Questo metodo ha il seguente valore restituito:
Nome |
Descrizione |
Tipo |
account |
Oggetto contenente informazioni sull'account modificato. |
Esempio di richiesta
Le richieste per questo metodo sono simili all'esempio seguente. In questo esempio, gli attributi vengono cancellati specificando {}:
{ "method": "ModifyAccount", "params": { "accountID" : 25, "status" : "locked", "attributes" : {} }, "id" : 1 }
Esempio di risposta
Questo metodo restituisce una risposta simile all'esempio seguente:
{ "account": { "storageContainerID": "abcdef01-1234-5678-90ab-cdef01234567", "username": "user1", "accountID": 1, "volumes": [ ], "enableChap": true, "initiatorSecret": "txz123456q890", "attributes": { }, "status": active", "targetSecret": "rxe123b567890" } }
Novità dalla versione
9,6