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 utenti da aggiornare.

La proprietà usrgrpid deve essere definita per ciascun gruppo utenti, tutte le altre proprietà sono facoltative. Verranno aggiornate solo le proprietà passate, tutte le altre rimarranno invariate.

Oltre alle proprietà standard del gruppo utenti, il metodo accetta i seguenti parametri.

Parametro Tipo Descrizione
hostgroup_rights object/array Permessi del gruppo host per sostituire i permessi correnti assegnati al gruppo utenti.
templategroup_rights object/array Permessi del gruppo template per sostituire i permessi correnti assegnati al gruppo utenti.
tag_filters array Permessi basati sui tag per sostituire i permessi correnti assegnati al gruppo utenti.
users object/array Utenti per sostituire gli utenti correnti assegnati al gruppo utenti.

L'utente deve avere definita solo la proprietà userid.

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".

Richiesta:

{
    "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.