[comment]: # translation:outdated
[comment]: # ({2135842b-2135842b})
# > Objeto de rol
Los siguientes objetos están directamente relacionados con la API `role`.
[comment]: # ({/2135842b-2135842b})
[comment]: # ({84851cb3-1708e020})
### Rol
El objeto de rol tiene las siguientes propiedades:
|Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción|
|--|--|------|
|roleid|cadena|ID del rol.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *solo lectura*
- *obligatorio* para operaciones de actualización|
|name|cadena|Nombre del rol.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *obligatorio* para operaciones de creación|
|type|entero|Tipo de usuario.
Valores posibles:
1 - *(predeterminado)* Usuario;
2 - Administrador;
3 - Superadministrador.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *obligatorio* para operaciones de creación|
|readonly|entero|Si el rol es de solo lectura.
Valores posibles:
0 - *(predeterminado)* No;
1 - Sí.
[Comportamiento de la propiedad]( /manual/api/reference_commentary#property-behavior):
- *solo lectura*|
[comment]: # ({/84851cb3-1708e020})
[comment]: # ({a9f09416-8a9b3008})
### Reglas de rol
El objeto de reglas de rol tiene las siguientes propiedades:
|Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción|
|--|--|------|
|ui|array|Matriz de los objetos [elemento UI](object#ui_element).|
|ui.default\_access|entero|Si el acceso a nuevos elementos de la interfaz de usuario está habilitado.
Valores posibles:
0 - Deshabilitado;
1 - *(predeterminado)* Habilitado.|
|services.read.mode|entero|Acceso de solo lectura a los servicios.
Valores posibles:
0: acceso de solo lectura a los servicios, especificado por `services.read.list` o coincidente por las propiedades `services.read.tag`;
1 - *(predeterminado)* Acceso de solo lectura a todos los servicios.|
|services.read.list|matriz|Matriz de objetos [Servicio](object#service).
A los servicios especificados, incluidos los servicios secundarios, se les otorgará acceso de solo lectura al rol de usuario. El acceso de solo lectura no anulará el acceso de lectura y escritura a los servicios.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *compatible* si `services.read .mode` está establecido en "0"|
|services.read.tag|object|Matriz de objeto [etiqueta de servicio](object#service_tag).
A los servicios coincidentes con etiquetas, incluidos los servicios secundarios, se les otorgará acceso de solo lectura al rol de usuario. El acceso de solo lectura no anulará el acceso de lectura y escritura a los servicios.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *compatible* si `services.read .mode` está establecido en "0"|
|services.write.mode|integer|Acceso de lectura y escritura a los servicios.
Valores posibles:
0 - *(predeterminado)* Acceso de lectura y escritura a los servicios, especificado por `services.write .list` o que coincida con las propiedades `services.write.tag`;
1 - Acceso de lectura y escritura a todos los servicios.|
|services.write.list|array|Matriz de objetos [Servicio](object#service).
A los servicios especificados, incluidos los servicios secundarios, se les otorgará acceso de lectura y escritura al rol de usuario. El acceso de lectura y escritura anulará el acceso de solo lectura a los servicios.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *compatible* si `services.write. modo` está establecido en "0"|
|services.write.tag|object|Matriz de objeto [etiqueta de servicio](object#service_tag).
A los servicios coincidentes con etiquetas, incluidos los servicios secundarios, se les otorgará acceso de lectura y escritura al rol de usuario. El acceso de lectura y escritura anulará el acceso de solo lectura a los servicios.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *compatible* si `services.write. modo` está establecido en "0"|
|modules|matriz|Matriz de los objetos [módulo](object#module).|
|modules.default\_access|integer|Si el acceso a nuevos módulos está habilitado.
Valores posibles:
0 - Deshabilitado;
1 - *(predeterminado)* Habilitado.|
|api.access|entero|Si el acceso a la API está habilitado.
Valores posibles:
0 - Deshabilitado;
1 - *(predeterminado)* Habilitado.|
|api.mode|entero|Modo para tratar los métodos API enumerados en la propiedad `api`.
Valores posibles:
0 - *(predeterminado)* Lista de denegados;
1 - Lista de permitidos. |
|api|matriz|Matriz de métodos API.|
|actions|matriz|Matriz de los objetos [acción](object#action).|
|actions.default\_access|entero|Si el acceso a nuevas acciones está habilitado.
Valores posibles:
0 - Deshabilitado;
1 - *(predeterminado)* Habilitado.|
[comment]: # ({/a9f09416-8a9b3008})
[comment]: # ({4375b5d1-006cdfb5})
### Elemento de interfaz de usuario
El objeto del elemento UI tiene las siguientes propiedades:
|Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción|
|--|--|------|
|name|cadena|Nombre del elemento de la interfaz de usuario.
Valores posibles si `tipo` de [objeto de rol](#role) está establecido en "Usuario", "Administrador" o "Superadministrador":< br>`monitoring.dashboard` - *Paneles de control*;
`monitoring.problems` - *Monitoring → Problemas*;
`monitoring.hosts` - *Monitoring → Hosts*;
`monitoring.latest_data` - *Monitoreo → Últimos datos*;
`monitoring.maps` - *Monitoreo → Mapas*;
`services.services` - *Servicios → Servicios*;
`services.sla_report` - *Servicios → Informe SLA*;
`inventory.overview` - *Inventario → Descripción general*;
`inventory.hosts` - *Inventario → Hosts*;
`reports.availability_report` - *Informes → Informe de disponibilidad*;
`reports.top_triggers` - *Informes → 100 principales iniciadores*.
Valores posibles si el `tipo` de [objeto de rol](#role) está configurado en "Administrador" o "Superadministrador":
`monitoring.discovery` - *Monitoreo → Descubrimiento*;
`services.sla` - *Servicios → SLA*;
`reports.scheduled_reports` - *Informes → Informes programados*;
` reports.notifications` - *Reportes → Notificaciones*;
`configuration.template_groups` - *Recopilación de datos → Grupos de plantillas*;
`configuration.host_groups` - *Recopilación de datos → Grupos de hosts*;
`configuración .templates` - *Recopilación de datos → Plantillas*;
`configuration.hosts` - *Recopilación de datos → Hosts*;
`configuration.maintenance` - *Recopilación de datos → Mantenimiento*;
`configuration.discovery ` - *Recopilación de datos → Descubrimiento*;
`configuration.trigger_actions` - *Alertas → Acciones → Acciones de activación*;
`configuration.service_actions` - *Alertas → Acciones → Acciones de servicio*;
`configuración .discovery_actions` - *Alertas → Acciones → Acciones de descubrimiento*;
`configuration.autoregistration_actions` - *Alertas → Acciones → Acciones de registro automático*;
`configuration.internal_actions` - *Alertas → Acciones → Acciones internas*.< br>
Valores posibles si `tipo` de [objeto de rol](#rol) está configurado en "Super administrador":
`reports.system_info` - *Informes → Información del sistema*;
`reports. auditoría` - *Informes → Registro de auditoría*;
`reports.action_log` - *Informes → Registro de acciones*;
`configuration.event_correlation` - *Recopilación de datos → Correlación de eventos*;
`administration.media_types ` - *Alertas → Tipos de medios*;
`administration.scripts` - *Alertas → Scripts*;
`administration.user_groups` - *Usuarios → Grupos de usuarios*;
`administration.user_roles` - * Usuarios → Roles de usuario*;
`administration.users` - *Usuarios → Usuarios*;
`administration.api_tokens` - *Usuarios → API tokens*;
`administration.authentication` - *Usuarios → Autenticación *;
`administration.general` - *Administración → General*;
`administration.audit_log` - *Administración → Registro de auditoría*;
`administration.housekeeping` - *Administración → Limpieza*;
`administration.proxies` - *Administración → Proxies*;
`administration.macros` - *Administración → Macros*;
`administration.queue` - *Administración → Cola*.
[ Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *obligatorio*|
|status|entero|Si el acceso al elemento de la interfaz de usuario está habilitado.
Valores posibles:
0 - Deshabilitado;
1 - *(predeterminado)* Habilitado.|
[comment]: # ({/4375b5d1-006cdfb5})
[comment]: # ({b8603f6e-ebf4bb3a})
### Servicio
|Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción|
|--|--|------|
|serviceid|cadena|ID del servicio.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *obligatorio*|
[comment]: # ({/b8603f6e-ebf4bb3a})
[comment]: # ({1e4d9d21-300e6d5b})
### Etiqueta de servicio
|Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción|
|--|--|------|
|tag|cadena|Nombre de la etiqueta.
Si se especifica una cadena vacía, la etiqueta de servicio no se utilizará para la coincidencia del servicio.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property -comportamiento):
- *obligatorio*|
|value|cadena|Valor de etiqueta.
Si no se especifica ningún valor o una cadena vacía, solo se utilizará el nombre de la etiqueta para la coincidencia del servicio.|
[comment]: # ({/1e4d9d21-300e6d5b})
[comment]: # ({21d1ba7b-f70e75e9})
### Módulo
El objeto del módulo tiene las siguientes propiedades:
|Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción|
|--|--|------|
|moduleid|cadena|ID del módulo.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *obligatorio*|
|status|entero|Si el acceso al módulo está habilitado.
Valores posibles:
0 - Deshabilitado;
1 - *(predeterminado)* Habilitado.|
[comment]: # ({/21d1ba7b-f70e75e9})
[comment]: # ({cd7f3b4c-957a00bb})
### Acción
El objeto de acción tiene las siguientes propiedades:
|Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción|
|--|--|------|
|name|cadena|Nombre de la acción.
Valores posibles si `tipo` de [objeto de rol](#rol) está establecido en "Usuario", "Administrador" o "Superadministrador:
`edit_dashboards` - Crear y editar paneles;
`edit_maps` - Crear y editar mapas;
`add_problem_comments` - Agregar comentarios de problemas;
`change_severity` - Cambiar la gravedad del problema;
`acknowledge_problems` - Reconocer problemas;
`suppress_problems` - Suprimir problemas;
`close_problems` - Cerrar problemas;
`execute_scripts` - Ejecutar scripts;
`manage_api_tokens` - Administrar tokens API.
Valores posibles si el `tipo` de [objeto de rol](#role) está configurado en "Admin" o "Super administrador":
`edit_maintenance` - Crear y editar mantenimientos;
`manage_scheduled_reports` - Administrar informes programados,
`manage_sla` - Administrar SLA.
Valores posibles si el `tipo` de [objeto de rol](#role) está establecido en "Usuario" o "Administrador":
`invoke_execute_now` - permite para ejecutar comprobaciones de elementos para usuarios que solo tienen permisos de lectura en el equipo.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *requerido*|
|status|entero|Si el acceso para realizar la acción está habilitado.
Valores posibles:
0 - Deshabilitado;
1 - *(predeterminado)* Habilitado.|
[comment]: # ({/cd7f3b4c-957a00bb})