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 Super admin. Los permisos para llamar al método pueden revocarse en la configuración de roles de usuario. Consulte User roles para obtener más información.

Parámetros

(object/array) Grupos de usuarios que se crearán.

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

Parameter Type Description
hostgroup_rights object/array Permisos de los grupos de hosts que se asignarán al grupo de usuarios.
proxies object/array Proxies que se vincularán al grupo de usuarios.
Los proxies deben tener definida únicamente la propiedad proxyid.
proxy_groups object/array Grupos de proxies que se vincularán al grupo de usuarios.
Los grupos de proxies deben tener definida únicamente la propiedad proxy_groupid.
templategroup_rights object/array Permisos de los grupos de templates que se asignarán al grupo de usuarios.
tag_filters array Permisos basados en etiquetas que se asignarán al grupo de usuarios.
users object/array Usuarios que se añadirán al grupo de usuarios.

El usuario debe tener definida únicamente la propiedad userid.

Valores de retorno

(object) Devuelve un objeto que contiene los IDs de los grupos de usuarios creados bajo la propiedad usrgrpids. El orden de los IDs devueltos coincide con el orden de los grupos de usuarios pasados.

Ejemplos

Creando un grupo de usuarios

Cree un grupo de usuarios Operation managers con acceso denegado al grupo de equipos "2" y añada un usuario al mismo.

Solicitud:

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

Respuesta:

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

Véase también

Fuente

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