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 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) Roles a crear.

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

Parámetro	Tipo	Descripción
rules	matriz	Reglas de rol que se crearán para el rol.

Valores de retorno

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

Ejemplos

Creando un rol

Cree un rol con el tipo "Usuario" y acceso denegado a dos elementos de la interfaz de usuario.

Solicitud:

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

Respuesta:

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

Ver también

Fuente

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

Documentation