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

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

Parametro Type Descrizione
hostgroup_rights object/array Permessi dei gruppi host da assegnare al gruppo utenti.
templategroup_rights object/array Permessi dei gruppi template da assegnare al gruppo utenti.
tag_filters array Permessi basati sui tag da assegnare al gruppo utenti.
users object/array Utenti da aggiungere al gruppo utenti.

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

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.