usergroup.update

Descripción

object usergroup.update(object/array userGroups)

Este método le permite actualizar grupos de usuarios existentes.

Este método solo está disponible para el tipo de usuario Super admin. Los permisos para llamar al método se pueden revocar en la configuración del rol de usuario. Consulte User roles para obtener más información.

Parámetros

(object/array) Propiedades del grupo de usuarios que se actualizarán.

La propiedad usrgrpid debe definirse para cada grupo de usuarios; todas las demás propiedades son opcionales. Solo se actualizarán las propiedades proporcionadas; las demás permanecerán sin cambios.

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

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

El usuario solo debe tener definida la propiedad userid.

Valores de retorno

(object) Devuelve un objeto que contiene los IDs de los grupos de usuarios actualizados bajo la propiedad usrgrpids.

Ejemplos

Habilitar un grupo de usuarios y actualizar permisos

Habilite un grupo de usuarios y proporcione acceso de lectura-escritura para él a los grupos de equipos "2" y "4".

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "usergroup.update",
    "params": {
        "usrgrpid": "17",
        "users_status": "0",
        "hostgroup_rights": [
            {
                "id": "2",
                "permission": 3
            },
            {
                "id": "4",
                "permission": 3
            }
        ]
    },
    "id": 1
}

Respuesta:

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

Véase también

Fuente

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