role.update

Descripción

object role.update(object/array roles)

Este método permite actualizar roles existentes.

Este método solo está disponible para el tipo de usuario Super admin. Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte Roles de usuario para más información.

Parámetros

(objeto/array) Propiedades del rol que se actualizarán.

La propiedad roleid debe definirse para cada rol, todas las demás propiedades son opcionales. Solo se actualizarán las propiedades pasadas, todas las demás permanecerán sin cambios.

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

Parámetro Tipo Descripción
rules array Reglas de acceso a actualizar para el rol.

Valores de retorno

(object) Devuelve un objeto que contiene los IDs de los roles actualizados bajo la propiedad roleids.

Ejemplos

Deshabilitar la capacidad de ejecutar scripts

Actualizar el rol con ID "5", deshabilitar la capacidad de ejecutar scripts.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "role.update",
    "params": [
        {
            "roleid": "5",
            "rules": {
                "actions": [
                    {
                        "name": "execute_scripts",
                        "status": "0"
                    }
                ]
            }
        }
    ],
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "roleids": [
            "5"
        ]
    },
    "id": 1
}

Limitando el acceso a la API

Actualizar el rol con ID "5", denegando la llamada a cualquier método "create", "update" o "delete".

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "role.update",
    "params": [
        {
            "roleid": "5",
            "rules": {
                "api.access": "1",
                "api.mode": "0",
                "api": ["*.create", "*.update", "*.delete"]
            }
        }
    ],
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "roleids": [
            "5"
        ]
    },
    "id": 1
}

Fuente

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