role.update

Descripción

object proxy.update(object/array proxies)

Este método permite actualizar los proxies existentes.

Este método solo está disponible para el tipo de usuario Super administrador. Los permisos para activar el método se pueden revocar en la configuración de roles de usuario. Ver User roles para más información.

Parámetros

(objeto/matriz) Propiedades de rol que se actualizarán.

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

Además de las standard role properties, el método acepta los siguientes parámetros.

Parámetro Tipo Descripción
rules matriz Acceda rules para reemplazar las reglas de acceso actuales asignadas al 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

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"
                           }
                       ]
                   }
               }
           ],
           "auth": "3a57200802b24cda67c4e4010b50c065",
           "id": 1
       }

Respuesta:

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

Limitando 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"]
                   }
               }
           ],
           "auth": "3a57200802b24cda67c4e4010b50c065",
           "id": 1
       }

Respuesta:

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

Fuente

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