Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Únase a nuestro proyecto de traducción y ayude a traducir la documentación de Zabbix a su lengua materna.

usergroup.create

Descripción

object usergroup.create(object/array userGroups)

Este método permite crear nuevos grupos de usuarios.

Este método solo está disponible para el tipo de usuario Superadministrador. Los permisos para llamar al método se pueden revocar en la configuración de roles de usuario. Ver Roles de usuario para obtener más información.

Parámetros

(objeto/matriz) Grupos de usuarios a crear.

Además de las propiedades estándar del grupo de usuarios, el método acepta los siguientes parámetros.

Parámetro Tipo Descripción
hostgroup_rights objeto/matriz Permisos del grupo de equipos para asignar al grupo de usuarios.
templategroup_rights objeto/matriz Permisos del grupo de plantillas para asignar al grupo de usuarios.
tag_filters matriz Permisos basados en etiquetas para asignar al grupo de usuarios.
users objeto/matriz Usuarios para agregar al grupo de usuarios.

El usuario debe tener definida la propiedad userid.
rights
(obsoleto)
objeto/matriz Este parámetro está obsoleto; utilice hostgroup_rights o templategroup_rights en su lugar.
Permisos para asignar al grupo de usuarios.

Valores de retorno

(objeto) Devuelve un objeto que contiene los ID de los grupos de usuarios creados bajo la propiedad usrgrpids. El orden de las identificaciones devueltas. coincide con el orden de los grupos de usuarios pasados.

Ejemplos

Creando un grupo de usuarios

Cree un grupo de usuarios Administradores de operaciones con acceso denegado al grupo de equipo "2" y agréguele un usuario.

Solicitud:

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

Respuesta:

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

Ver también

Fuente

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