[comment]: # ({312e3a40-312e3a40})
# role.create

[comment]: # ({/312e3a40-312e3a40})

[comment]: # ({17ca7358-17ca7358})
### Descripción

`object role.create(object/array roles)`

Este método permite crear nuevos roles.

::: noteclassic
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](/manual/web_interface/frontend_sections/administration/user_roles)
para más información.
:::

[comment]: # ({/17ca7358-17ca7358})

[comment]: # ({c2f5deb8-be3f23e2})
### 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](/manual/api/reference_commentary#tipos_de_datos)|Descripción|
|--|--|------|
|reglas|matriz|Rol [rules](objeto#reglas_de_rol) que se creará para el rol.|

[comment]: # ({/c2f5deb8-be3f23e2})

[comment]: # ({f343e9f2-f343e9f2})
### 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.

[comment]: # ({/f343e9f2-f343e9f2})

[comment]: # ({b41637d2-b41637d2})
### Ejemplos

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({9c11e896-7e61457f})
#### Crear un rol

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

Solicitud:

```json
{
"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:

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

[comment]: # ({/9c11e896-7e61457f})

[comment]: # ({c3d5b904-c3d5b904})
### Ver también

- [Reglas de rol](object#reglas_de_rol)
- [Elemento UI](object#elemento_ui)
- [Modulo](object#modulo)
- [Acción](object#acción)

[comment]: # ({/c3d5b904-c3d5b904})

[comment]: # ({4b30d86c-4b30d86c})
### Fuente

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

[comment]: # ({/4b30d86c-4b30d86c})