role.update

Descripción

object role.update(object/array roles)

Este método permite actualizar los roles existentes.

Este método solo está disponible para el tipo de usuario Super administrador. 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) Propiedades de rol que se actualizarán.

La propiedad roleid debe definirse para cada rol, todos los demás Las propiedades son opcionales. Sólo se actualizarán las propiedades pasadas, todas otros permanecerán sin cambios.

Además de las [propiedades de rol estándar] (objeto#rol), el método Acepta los siguientes parámetros.

Parámetro Tipo Descripción
reglas array Acceda a reglas para actualizar el rol.

Valores de retorno

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

Ejemplos

Deshabilitar la capacidad de ejecutar scripts

Actualice el rol con ID "5", deshabilite 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
       }

Limitar el acceso a la API

Actualizar rol con ID "5", denegar la llamada a cualquiera de los métodos "creación", "actualización" o "eliminación".

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.