Objeto role

Os seguintes objetos estão diretamente relacionados à API role.

Role

O objeto role possui as seguintes propriedades:

Propriedade Tipo Descrição
roleid ID ID da role.

Comportamento da propriedade:
- somente leitura
- obrigatório para operações de atualização
name string Nome da role.

Comportamento da propriedade:
- obrigatório para operações de criação
type integer Tipo de usuário.

Valores possíveis:
1 - (padrão) Usuário;
2 - Admin;
3 - Super admin.

Comportamento da propriedade:
- obrigatório para operações de criação
readonly integer Se a role é somente leitura.

Valores possíveis:
0 - (padrão) Não;
1 - Sim.

Comportamento da propriedade:
- somente leitura

Regras de função

O objeto de regras de função tem as seguintes propriedades:

Property Type Description
ui array Array de objetos de elemento da UI.
ui.default_access integer Indica se o acesso a novos elementos da UI está habilitado.

Valores possíveis:
0 - Desabilitado;
1 - (padrão) Habilitado.
services.read.mode integer Acesso somente leitura aos serviços.

Valores possíveis:
0 - Acesso somente leitura aos serviços especificados pelas propriedades services.read.list ou correspondentes à propriedade services.read.tag;
1 - (padrão) Acesso somente leitura a todos os serviços.
services.read.list array Array de objetos Service.

Será concedido à função de usuário acesso somente leitura aos serviços especificados, incluindo os serviços filhos. O acesso somente leitura não substituirá o acesso de leitura e gravação aos serviços.

Comportamento da propriedade:
- suportada se services.read.mode estiver definido como "0"
services.read.tag object Array de objetos Service tag.

Será concedido à função de usuário acesso somente leitura aos serviços correspondentes à tag, incluindo os serviços filhos. O acesso somente leitura não substituirá o acesso de leitura e gravação aos serviços.

Comportamento da propriedade:
- suportada se services.read.mode estiver definido como "0"
services.write.mode integer Acesso de leitura e gravação aos serviços.

Valores possíveis:
0 - (padrão) Acesso de leitura e gravação aos serviços especificados pelas propriedades services.write.list ou correspondentes à propriedade services.write.tag;
1 - Acesso de leitura e gravação a todos os serviços.
services.write.list array Array de objetos Service.

Será concedido à função de usuário acesso de leitura e gravação aos serviços especificados, incluindo os serviços filhos. O acesso de leitura e gravação substituirá o acesso somente leitura aos serviços.

Comportamento da propriedade:
- suportada se services.write.mode estiver definido como "0"
services.write.tag object Array de objetos Service tag.

Será concedido à função de usuário acesso de leitura e gravação aos serviços correspondentes à tag, incluindo os serviços filhos. O acesso de leitura e gravação substituirá o acesso somente leitura aos serviços.

Comportamento da propriedade:
- suportada se services.write.mode estiver definido como "0"
modules array Array de objetos module.
modules.default_access integer Indica se o acesso a novos módulos está habilitado.

Valores possíveis:
0 - Desabilitado;
1 - (padrão) Habilitado.
api.access integer Indica se o acesso à API está habilitado.

Valores possíveis:
0 - (padrão) Desabilitado;
1 - Habilitado.
api.mode integer Modo de tratamento dos métodos da API listados na propriedade api.

Valores possíveis:
0 - (padrão) Lista de negação;
1 - Lista de permissão.
api array Array de métodos da API.
actions array Array de objetos action.
actions.default_access integer Indica se o acesso a novas ações está habilitado.

Valores possíveis:
0 - Desabilitado;
1 - (padrão) Habilitado.
devices.access integer Indica se o acesso aos próprios dispositivos móveis do usuário para uso com o aplicativo móvel do Zabbix está habilitado.

Valores possíveis:
0 - (padrão para User e Admin) Desabilitado;
1 - (padrão para Super admin) Habilitado.

Comportamento da propriedade:
- suportada se EnableMobileDevices estiver habilitado
devices.actions array Array de objetos Device action.

Comportamento da propriedade:
- suportada se devices.access estiver definido como "1"
devices.actions.default_access integer Indica se o acesso a novas ações de dispositivo está habilitado.

Valores possíveis:
0 - (padrão para User e Admin) Desabilitado;
1 - (padrão para Super admin) Habilitado.

Comportamento da propriedade:
- suportada se EnableMobileDevices estiver habilitado

Elemento da interface do usuário

O objeto de elemento da interface do usuário tem as seguintes propriedades:

Propriedade Tipo Descrição
name string Nome do elemento da interface do usuário.

Valores possíveis se type do objeto Role estiver definido como "User", "Admin" ou "Super admin":
monitoring.dashboard - Dashboards;
monitoring.problems - Monitoring > Problems;
monitoring.hosts - Monitoring > Hosts;
monitoring.latest_data - Monitoring > Latest data;
monitoring.maps - Monitoring > Maps;
services.services - Services > Services;
services.sla_report - Services > SLA report;
inventory.overview - Inventory > Overview;
inventory.hosts - Inventory > Hosts;
reports.availability_report - Reports > Availability report;
reports.top_triggers - Reports > Triggers top 100.

Valores possíveis se type do objeto Role estiver definido como "Admin" ou "Super admin":
monitoring.discovery - Monitoring > Discovery;
services.sla - Services > SLA;
reports.scheduled_reports - Reports > Scheduled reports;
reports.notifications - Reports > Notifications;
configuration.template_groups - Data collection > Template groups;
configuration.host_groups - Data collection > Host groups;
configuration.templates - Data collection > Templates;
configuration.hosts - Data collection > Hosts;
configuration.maintenance - Data collection > Maintenance;
configuration.discovery - Data collection > Discovery;
configuration.trigger_actions - Alerts > Actions > Trigger actions;
configuration.service_actions - Alerts > Actions > Service actions;
configuration.discovery_actions - Alerts > Actions > Discovery actions;
configuration.autoregistration_actions - Alerts > Actions > Autoregistration actions;
configuration.internal_actions - Alerts > Actions > Internal actions.

Valores possíveis se type do objeto Role estiver definido como "Super admin":
reports.system_info - Reports > System information;
reports.audit - Reports > Audit log;
reports.action_log - Reports > Action log;
configuration.event_correlation - Data collection > Event correlation;
administration.media_types - Alerts > Media types;
administration.scripts - Alerts > Scripts;
administration.user_groups - Users > User groups;
administration.user_roles - Users > User roles;
administration.users - Users > Users;
administration.api_tokens - Users > API tokens;
administration.authentication - Users > Authentication;
administration.linked_devices - Users > Devices;
administration.general - Administration > General;
administration.audit_log - Administration > Audit log;
administration.housekeeping - Administration > Housekeeping;
administration.proxy_groups - Administration > Proxy groups;
administration.proxies - Administration > Proxies;
administration.macros - Administration > Macros;
administration.queue - Administration > Queue.

Comportamento da propriedade:
- required
status integer Indica se o acesso ao elemento da interface do usuário está habilitado.

Valores possíveis:
0 - Desabilitado;
1 - (padrão) Habilitado.

Serviço

Propriedade Tipo Descrição
serviceid ID ID do Serviço.

Comportamento da propriedade:
- obrigatório

Tag de serviço

Propriedade Tipo Descrição
tag string Nome da tag.

Se uma string vazia for especificada, a tag de serviço não será usada para correspondência de serviço.

Comportamento da propriedade:
- obrigatório
value string Valor da tag.

Se nenhum valor ou uma string vazia for especificada, apenas o nome da tag será usado para correspondência de serviço.

Módulo

O objeto módulo possui as seguintes propriedades:

Propriedade Tipo Descrição
moduleid ID ID do módulo.

Comportamento da propriedade:
- obrigatório
status integer Se o acesso ao módulo está habilitado.

Valores possíveis:
0 - Desabilitado;
1 - (padrão) Habilitado.

Ação

O objeto de ação tem as seguintes propriedades:

Propriedade Tipo Descrição
name string Nome da ação.

Valores possíveis se type do objeto Role estiver definido como "User", "Admin" ou "Super admin":
edit_dashboards - Criar e editar dashboards;
edit_maps - Criar e editar mapas;
add_problem_comments - Adicionar comentários aos problemas;
change_severity - Alterar a severidade do problema;
acknowledge_problems - Confirmar problemas;
suppress_problems - Suprimir problemas;
close_problems - Fechar problemas;
execute_scripts - Executar scripts;
manage_api_tokens - Gerenciar tokens de API;
change_problem_ranking - Alterar a classificação do problema de causa para sintoma e vice-versa;
edit_own_media - Permitir criar/editar a própria mídia.

Valores possíveis se type do objeto Role estiver definido como "Admin" ou "Super admin":
edit_maintenance - Criar e editar manutenções;
manage_scheduled_reports - Gerenciar relatórios agendados,
manage_sla - Gerenciar SLA,
select_server_for_monitoring - Permitir criar hosts monitorados pelo server e pelas regras de descoberta de rede executadas pelo server.

Valores possíveis se type do objeto Role estiver definido como "User" ou "Admin":
invoke_execute_now - Permitir executar verificações de item para usuários que tenham apenas permissões de leitura no host.

Valores possíveis se type do objeto Role estiver definido como "Super admin":
edit_user_media - Permitir criar/editar mídia para usuários.

Comportamento da propriedade:
- obrigatório
status integer Indica se o acesso para executar a ação está habilitado.

Valores possíveis:
0 - Desabilitado;
1 - (padrão) Habilitado.

Ação de dispositivo

O objeto de ação de dispositivo tem as seguintes propriedades:

Property Type Description
name string Nome da ação de dispositivo.

Valores possíveis se type do objeto Role estiver definido como "User", "Admin" ou "Super admin":
manage_own - Permitir adicionar ou remover os próprios dispositivos móveis do usuário.

Valores possíveis se type do objeto Role estiver definido como "Super admin":
manage_user - Permitir adicionar ou remover dispositivos móveis de todos os usuários.

Comportamento da propriedade:
- required
status integer Indica se o acesso para executar a ação está habilitado.

Valores possíveis:
0 - Desabilitado;
1 - (default) Habilitado.