usergroup.update

Descrizione

object usergroup.update(object/array userGroups)

Questo metodo consente di aggiornare i 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. Vedere Ruoli utente per ulteriori informazioni.

Parametri

(object/array) Proprietà dei gruppi di utenti da aggiornare.

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

Oltre alle proprietà standard dei gruppi di utenti, il metodo accetta i seguenti parametri.

Parametro Tipo Descrizione
hostgroup_rights object/array Autorizzazioni per i gruppi di host, che sostituiranno le autorizzazioni attualmente assegnate al gruppo di utenti.
proxies object/array proxy da collegare al gruppo di utenti.
I proxy devono avere definita solo la proprietà proxyid.
proxy_groups object/array Gruppi di proxy da collegare al gruppo di utenti.
I gruppi di proxy devono avere definita solo la proprietà proxy_groupid.
templategroup_rights object/array Autorizzazioni per i gruppi di template, che sostituiranno le autorizzazioni attualmente assegnate al gruppo di utenti.
tag_filters array Autorizzazioni basate sui tag che sostituiranno le autorizzazioni attualmente assegnate al gruppo di utenti.
users object/array Utenti che sostituiranno gli utenti attualmente assegnati al gruppo di 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.