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 richiamare il metodo possono essere revocate nelle impostazioni del ruolo utente. Per ulteriori informazioni, vedere Ruoli utente.

Parametri

(object/array) Gruppi di utenti da creare.

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

Parameter Type Description
hostgroup_rights object/array Autorizzazioni per i gruppi di host da assegnare 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 da assegnare al gruppo di utenti.
tag_filters array Autorizzazioni basate sui tag da assegnare al gruppo di utenti.
users object/array Utenti da aggiungere al gruppo di 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.