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

La proprietà usrgrpid deve essere definita per ogni gruppo utenti; tutte le altre proprietà sono facoltative. Verranno aggiornate solo le proprietà passate, mentre 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 sui gruppi di host da sostituire ai permessi attualmente assegnati al gruppo utenti.
proxies object/array Proxy da collegare al gruppo utenti.
I proxy devono avere definita solo la proprietà proxyid.
proxy_groups object/array Gruppi di proxy da collegare al gruppo utenti.
I gruppi di proxy devono avere definita solo la proprietà proxy_groupid.
templategroup_rights object/array Permessi sui gruppi di template da sostituire ai permessi attualmente assegnati al gruppo utenti.
tag_filters array Permessi basati sui tag da sostituire ai permessi attualmente assegnati al gruppo utenti.
apm_filters object/array Permessi basati su APM da sostituire ai permessi attualmente assegnati al gruppo utenti.
users object/array Utenti da sostituire agli utenti attualmente 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.