usergroup.create

Descrizione

object usergroup.create(object/array userGroups)

Questo metodo consente di creare nuovi gruppi di utenti.

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 User roles.

Parametri

(object/array) Gruppi utente da creare.

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

Parametro Tipo Descrizione
hostgroup_rights object/array Permessi del gruppo host da assegnare al gruppo utente.
templategroup_rights object/array Permessi del gruppo template da assegnare al gruppo utente.
tag_filters array Permessi basati su tag da assegnare al gruppo utente.
users object/array Utenti da aggiungere 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.

Valori restituiti

(object) Restituisce un oggetto contenente gli ID dei gruppi utenti creati nella proprietà usrgrpids. L'ordine degli ID restituiti corrisponde all'ordine dei gruppi utenti passati.

Esempi

Creazione di un gruppo utenti

Creare un gruppo utenti Operation managers con accesso negato al gruppo host "2" e aggiungervi un utente.

Request:

{
    "jsonrpc": "2.0",
    "method": "usergroup.create",
    "params": {
        "name": "Operation managers",
        "hostgroup_rights": {
            "id": "2",
            "permission": 0
        },
        "users": [
            {
                "userid": "12"
            }
        ]
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "usrgrpids": [
            "20"
        ]
    },
    "id": 1
}

Guarda anche

Sorgente

CUserGroup::create() in ui/include/classes/api/services/CUserGroup.php.