Skip to main content
Element Software
12.5
È disponibile una versione più recente di questo prodotto.
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

ModifyAccount

Collaboratori

È 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

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:

  • Attivo: L'account è attivo e le connessioni sono consentite.

  • Bloccato: L'account è bloccato e le connessioni vengono rifiutate.

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