role.create

Descripción

object role.create(object/array roles)

Este método permite crear nuevos roles.

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 Roles de usuario para más información.

Parámetros

(object/array) Roles a crear.

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 matriz Rol rules que se creará para el rol.

Valores de retorno

(object) Devuelve un objeto que contiene los IDs de los roles creados bajo la propiedad roleids. El orden de los ID devueltos coincide con el orden de los roles pasados.

Ejemplos

Crear un rol

Crear un rol con el tipo "Usuario" e acceso denegado a dos los elementos UI.

Solicitud:

{
       "jsonrpc": "2.0",
       "method": "role.create",
       "params": {
       "name": "Operator",
       "type": "1",
       "rules": {
       "ui": [
       {
       "name": "monitoring.hosts",
       "status": "0"
       },
       {
       "name": "monitoring.maps",
       "status": "0"
       }
       ]
       }
       },
       "auth": "038e1d7b1735c6a5436ee9eae095879e",
       "id": 1
       }

Respuesta:

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

Ver también

Fuente

CRole::create() in ui/include/classes/api/services/CRole.php.