[comment]: # translation:outdated [comment]: # ({2135842b-2135842b}) # > Objeto de rol Los siguientes objetos están directamente relacionados con la API `role`. [comment]: # ({/2135842b-2135842b}) [comment]: # ({84ee8c53-1708e020}) ### Rol El objeto de rol tiene las siguientes propiedades: |Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción| |--|--|------| |roleid|cadena|*(readonly)* ID del rol.| |**name**
(obligatorio)|cadena|Nombre del rol.| |**type**
(obligatorio)|entero|Tipo de usuario.

Valores posibles:
1 - *(predeterminado)* Usuario;
2 - Administrador;
3 - Súper administrador.| |readonly|entero|*(readonly)* Si el rol es de solo lectura.

Valores posibles:
0 - *(predeterminado)* No;
1 - Sí.| Tenga en cuenta que para algunos métodos (actualizar, eliminar) la combinación de parámetros requeridos/opcionales es diferente. [comment]: # ({/84ee8c53-1708e020}) [comment]: # ({672ddb55-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|integer|Si el acceso a nuevos elementos de la interfaz de usuario está habilitado.

Valores posibles:
0 - Deshabilitado;
1 - *(predeterminado)* Habilitado.| |services.read.mode|integer|Acceso de solo lectura a los servicios.

Valores posibles:

0 - Acceso de solo lectura a los servicios, especificado por `services.read.list ` o coincide con las propiedades `services.read.tag`.
1 - *(predeterminado)* Acceso de solo lectura a todos los servicios.| |services.read.list|array|Matriz de objetos [Servicio](objeto#servicio).

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.

Solo se usa 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.

Solo se usa si `services.read.mode` está establecido en 0.| |services.write.mode|entero|Acceso de lectura y escritura a los servicios.

Valores posibles:

0 - (predeterminado) Acceso de lectura y escritura a los servicios, especificado por `servicios. write.list` o coincide con las propiedades `services.write.tag`.
1 - Acceso de lectura y escritura a todos los servicios.| |services.write.list|array|Matriz de objetos [Servicio](objeto#servicio).

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.

Solo se usa si `services.write.mode` 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.

Solo se usa si `services.write.mode` está establecido en 0.| |módulos|matriz|Matriz de los objetos [módulo](objeto#módulo).| |modules.default\_access|integer|Si el acceso a nuevos módulos está habilitado.

Valores posibles:
0 - Deshabilitado;
1 - *(predeterminado)* Habilitado.| |api.access|integer|Si el acceso a la API está habilitado.

Valores posibles:
0 - Deshabilitado;
1 - *(predeterminado)* Habilitado.| |api.mode|integer|Modo para tratar los métodos API enumerados en la propiedad `api`.

Valores posibles:
0 - *(predeterminado)* Lista de denegados;
1 - Lista de permitidos. | |api|array|Matriz de métodos API.| |acciones|array|Matriz de los objetos [acción](objeto#acción).| |actions.default\_access|integer|Si el acceso a nuevas acciones está habilitado.

Valores posibles:
0 - Deshabilitado;
1 - *(predeterminado)* Habilitado.| [comment]: # ({/672ddb55-8a9b3008}) [comment]: # ({6e1ef027-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| |--|--|------| |**nombre**
(obligatorio)|cadena|Nombre del elemento de la interfaz de usuario.

Valores posibles para usuarios de cualquier tipo:
`monitoring.dashboard` - *Monitoring → Dashboard*;
`monitoring.problems` - *Monitoring → Problemas*;
`monitoring.hosts` - *Monitoring → Hosts*;
`monitoring.latest_data` - *Monitoring → Ú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 → Activa el top 100*.

Valores posibles solo para usuarios de los tipos de usuario *Admin* y *Super admin*:
`monitoring.discovery` - *Monitoring → Discovery*;
`services.actions ` - *Servicios → Acciones de servicio*;
`services.sla` - *Servicios → SLA*;
`reports.scheduled_reports` - *Informes → Informes programados*;
`reports.notifications` - * Informes → Notificaciones*;
`configuration.host_groups` - *Configuración → Grupos de hosts*;
`configuration.templates` - *Configuración → Plantillas*;
`configuration.hosts` - *Configuración → Hosts* ;
`configuration.maintenance` - *Configuración → Mantenimiento*;
`configuration.actions` - *Configuración → Acciones*;
`configuration.discovery` - *Configuración → Descubrimiento*.
< br>Valores posibles solo para usuarios del tipo de usuario *Super admin*:
`reports.system_info` - *Reports → Información del sistema*;
`reports.audit` - *Reports → Audit*;
` reports.action_log` - *Informes → Registro de acciones*;
`configuration.event_correlation` - *Configuración → Correlación de eventos*;
`administration.general` - *Administración → General*;
`administration.proxies ` - *Administración → Proxies*;
`administration.authentication` - *Administración → Autenticación*;
`administration.user_groups` - *Administración → Grupos de usuarios*;
`administration.user_roles` - *Administración → Roles de usuario*;
`administration.users` - *Administración → Usuarios*;
`administration.media_types` - *Administración → Tipos de medios*;
`administration.scripts` - *Administración → Scripts* ;
`administración.cola` - *Administración → Cola*.| |status|integer|Si el acceso al elemento de la interfaz de usuario está habilitado.

Valores posibles:
0 - Deshabilitado;
1 - *(predeterminado)* Habilitado.| [comment]: # ({/6e1ef027-006cdfb5}) [comment]: # ({1ef3faf9-ebf4bb3a}) ### Servicio |Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción| |--|--|------| |**serviceid**
(obligatorio)|cadena|ID del Servicio.| [comment]: # ({/1ef3faf9-ebf4bb3a}) [comment]: # ({54254705-300e6d5b}) ### Etiqueta de servicio |Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción| |--|--|------| |**tag**
(obligatorio)|cadena|Nombre de etiqueta.

Si se especifica una cadena vacía, la etiqueta de servicio no se utilizará para la coincidencia de servicios.| |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]: # ({/54254705-300e6d5b}) [comment]: # ({7dead620-f70e75e9}) ### Módulo El objeto module tiene las siguientes propiedades: |Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción| |--|--|------| |**moduleid**
(obligatorio)|cadena|ID del módulo.| |status|entero|Si el acceso al módulo está habilitado.

Valores posibles:
0 - Deshabilitado;
1 - *(predeterminado)* Habilitado.| [comment]: # ({/7dead620-f70e75e9}) [comment]: # ({fda66d22-957a00bb}) ### Acción El objeto action tiene las siguientes propiedades: |Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción| |--|--|------| |**name**
(obligatorio)|cadena|Nombre de la acción.

Valores posibles para usuarios de cualquier tipo:
`edit_dashboards` - Crear y editar tableros;
` edit_maps` - Crear y editar mapas;
`add_problem_comments` - Agregar comentarios de problemas;
`change_severity` - Cambiar la gravedad del problema;
`acknowledge_problems` - Reconocer problemas;
`close_problems` - Cerrar problemas;
`execute_scripts` - Ejecutar scripts;
`manage_api_tokens` - Administrar tokens API.

Valores posibles solo para usuarios de los tipos de usuario *Admin* y *Super admin*:
`edit_maintenance` - Crear y editar mantenimientos;
`manage_scheduled_reports` - Administrar informes programados;
`manage_sla` - Administrar SLA.| |status|entero|Si el acceso para realizar la acción está habilitado.

Valores posibles:
0 - Deshabilitado;
1 - *(predeterminado)* Habilitado.| [comment]: # ({/fda66d22-957a00bb})