> Objeto de rol

Los siguientes objetos están directamente relacionados con la API role.

Rol

El objeto de rol tiene las siguientes propiedades:

Propiedad Tipo 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.

Reglas de rol

El objeto de reglas de rol tiene las siguientes propiedades:

Propiedad Tipo Descripción
ui array Matriz de los objetos elemento UI.
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.

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.

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.

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.

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.
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.
actions.default_access integer Si el acceso a nuevas acciones está habilitado.

Valores posibles:
0 - Deshabilitado;
1 - (predeterminado) Habilitado.

elemento de interfaz de usuario

El objeto del elemento UI tiene las siguientes propiedades:

Propiedad Tipo 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.

Servicio

Propiedad Tipo Descripción
serviceid
(obligatorio)
cadena ID del Servicio.

Etiqueta de servicio

Propiedad Tipo 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.

Módulo

El objeto module tiene las siguientes propiedades:

Propiedad Tipo 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.

Acción

El objeto action tiene las siguientes propiedades:

Propiedad Tipo 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.