usergroup.create

Descripció

object usergroup.create(object/array userGroups)

Aquest mètode permet crear nous grups d'usuaris.

Tenim aquest mètode disponible només per a l'usuari Super admin. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu Rols d'usuari.

Paràmeters

(objecte/matriu) Grups d'usuaris per crear.

A més de les propietats estàndard del grup d'usuaris, el mètode admet els paràmetres següents.

Paràmetre Tipus Descripció
hostgroup_rights object/array Permisos del grup d'equips per assignar al grup d'usuaris.
templategroup_rights object/array Grup de plantilles permisos per assignar al grup d'usuaris.
tag_filters array Permisos basats en etiquetes per assignar al grup d'usuaris.
users object/array Usuaris per afegir al grup d'usuaris.

L'usuari ha de tindre definida la propietat identificador d'usuari.
rights
(obsolet)
object/array Aquest paràmetre és obsolet; si us plau, empreu hostgroup_rights o templategroup_rights.
Permisos per assignar al grup d'usuaris.

Valors de retorn

(object) Retorna un objecte amb els IDs dels grups d'usuaris creats segons la propietat usrgrpids. L'ordre dels IDs retornats correspon a l'ordre dels usuaris de grups donats.

Exemples

Crear un grup d'usuaris

Crea un grup d'usuaris que no permeti pas l'accés al grup d'equips "2", i hi afegeix un usuari.

Petició:

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

Resposta:

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

Veieu també

Font

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