usergroup.update
Descrizione
object usergroup.update(object/array userGroups)
Questo metodo consente di aggiornare gruppi di utenti esistenti.
Questo metodo è disponibile solo per il tipo di utente Super admin. Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente. Per ulteriori informazioni, vedere Ruoli utente.
Parametri
(object/array) Proprietà del gruppo utente da aggiornare.
La proprietà usrgrpid deve essere definita per ogni gruppo utente; tutte le altre proprietà sono facoltative. Verranno aggiornate solo le proprietà passate, mentre tutte le altre rimarranno invariate.
Oltre alle proprietà standard del gruppo utente, il metodo accetta i seguenti parametri.
| Parameter | Type | Description |
|---|---|---|
| hostgroup_rights | object/array | Permessi del gruppo host da sostituire ai permessi correnti assegnati al gruppo utente. |
| templategroup_rights | object/array | Permessi del gruppo template da sostituire ai permessi correnti assegnati al gruppo utente. |
| tag_filters | array | Permessi basati su tag da sostituire ai permessi correnti assegnati al gruppo utente. |
| users | object/array | Utenti da sostituire agli utenti correnti assegnati al gruppo utente. L'utente deve avere definita solo la proprietà userid. |
| rights (deprecated) |
object/array | Questo parametro è deprecato, usare invece hostgroup_rights o templategroup_rights.Permessi da assegnare al gruppo utente. |
Restituisce valori
"(object)" Restituisce un oggetto contenente gli ID dell'utente aggiornato
gruppi sotto la proprietà usrgrids.
Esempi
Abilitazione di un gruppo utenti e aggiornamento dei permessi
Abilitare un gruppo utenti e fornirgli l'accesso in lettura-scrittura ai gruppi host "2" e "4".
{
"jsonrpc": "2.0",
"method": "usergroup.update",
"params": {
"usrgrpid": "17",
"users_status": "0",
"hostgroup_rights": [
{
"id": "2",
"permission": 3
},
{
"id": "4",
"permission": 3
}
]
},
"id": 1
}Risposta:
{
"jsonrpc": "2.0",
"result": {
"usrgrpids": [
"17"
]
},
"id": 1
}Guarda anche
Fonte
CUserGroup::update() in ui/include/classes/api/services/CUserGroup.php.