Objeto de usuário

Os seguintes objetos estão diretamente relacionados à API de user.

Usuário

O objeto de usuário tem as seguintes propriedades.

Propriedade Tipo Descrição
userid ID ID do usuário.

Comportamento da propriedade:
- somente leitura
- obrigatória para operações de atualização
username string Nome de usuário.

Comportamento da propriedade:
- obrigatória para operações de criação
- somente leitura para usuários provisionados se o usuário estiver vinculado a um diretório de usuários (userdirectoryid estiver definido com um valor válido diferente de "0"), o provisionamento do diretório de usuários estiver habilitado (provision_status do objeto User directory estiver definido como "1") e o status de autenticação de todo o provisionamento LDAP ou SAML estiver habilitado (ldap_jit_status do objeto Authentication estiver definido como "Enabled for configured LDAP IdPs" ou saml_jit_status do objeto Authentication estiver definido como "Enabled for configured SAML IdPs")
passwd string Senha do usuário.

O valor deste parâmetro pode ser uma string vazia se o usuário estiver vinculado a um diretório de usuários.

Comportamento da propriedade:
- somente gravação
roleid ID ID da função do usuário.

Observe que usuários sem uma função podem fazer login no Zabbix somente usando autenticação LDAP ou SAML, desde que as informações LDAP/SAML correspondam aos mapeamentos de grupos de usuários configurados no Zabbix.
attempt_clock timestamp Hora da última tentativa de login malsucedida.

Comportamento da propriedade:
- somente leitura
attempt_failed integer Contagem recente de tentativas de login malsucedidas.

Comportamento da propriedade:
- somente leitura
attempt_ip string Endereço IP de onde veio a última tentativa de login malsucedida.

Comportamento da propriedade:
- somente leitura
autologin integer Indica se o login automático deve ser habilitado.

Valores possíveis:
0 - (padrão) login automático desabilitado;
1 - login automático habilitado.
autologout string Tempo de vida da sessão do usuário. Aceita um número de segundos (por exemplo, 1, 60, 300) ou um valor com um sufixo de tempo (por exemplo, 30s, 1m, 2h). Se definido como 0s, a sessão nunca expirará.

Padrão: 15m.
lang string Código do idioma do usuário, por exemplo, en_US.

Padrão: default - padrão do sistema.
name string Nome do usuário.
provisioned integer Indica se o usuário foi provisionado.

Valores possíveis:
0 - não provisionado;
1 - provisionado.

Esta propriedade é compatível a partir do Zabbix 7.0.9.

Comportamento da propriedade:
- somente leitura
refresh string Período de atualização automática. Aceita um número de segundos (por exemplo, 1, 60, 300) ou um valor com um sufixo de tempo (por exemplo, 30s, 1m, 2h, 1d).

Padrão: 30s.
rows_per_page integer Quantidade de linhas de objetos a serem exibidas por página.

Padrão: 50.
surname string Sobrenome do usuário.
theme string Tema do usuário.

Valores possíveis:
default - (padrão) padrão do sistema;
blue-theme - Azul;
dark-theme - Escuro;
hc-light - Claro de alto contraste;
hc-dark - Escuro de alto contraste.
ts_provisioned timestamp Hora em que a operação de provisionamento mais recente foi realizada.

Comportamento da propriedade:
- somente leitura
- compatível com usuários do tipo Super admin (a partir do Zabbix 7.0.9)
url string URL da página para a qual o usuário será redirecionado após fazer login.
userdirectoryid ID ID do diretório de usuários ao qual o usuário está vinculado.

Usado para provisionamento (criação ou atualização), bem como para fazer login de um usuário vinculado a um diretório de usuários.

Para operações de login, o valor desta propriedade terá prioridade sobre a propriedade userdirectoryid dos grupos de usuários aos quais o usuário pertence.

Padrão: 0.

Comportamento da propriedade:
- somente leitura
- compatível com usuários do tipo Super admin (a partir do Zabbix 7.0.9)
timezone string Fuso horário do usuário, por exemplo, Europe/London, UTC.

Padrão: default - padrão do sistema.

Para obter a lista completa de fusos horários compatíveis, consulte a documentação do PHP.

Media

O objeto media possui as seguintes propriedades.

Property Type Description
mediaid ID ID da media do usuário.

Comportamento da propriedade:
- somente leitura
mediatypeid ID ID do tipo de media usado pela media do usuário.

Comportamento da propriedade:
- obrigatório
sendto string/array Endereço, nome de usuário ou outro identificador do destinatário.

Se type de Media type estiver definido como "Email", os valores são representados como array. Para outros tipos de Media types, o valor é representado como string.

Comportamento da propriedade:
- obrigatório
active integer Indica se a media está habilitada.

Valores possíveis:
0 - (padrão) habilitada;
1 - desabilitada.
severity integer Severidades de trigger para as quais enviar notificações.

Valores bitmap possíveis:
1 - Não classificado;
2 - Informação;
4 - Aviso;
8 - Médio;
16 - Alto;
32 - Desastre.

Este é um campo de máscara de bits; qualquer soma dos valores bitmap possíveis é aceitável (por exemplo, 48 para Médio, Alto e Desastre).

Padrão: 63.
period string Horário em que as notificações podem ser enviadas como um período de tempo ou macros de usuário separados por ponto e vírgula.

Padrão: 1-7,00:00-24:00.
provisioned integer Indica se o usuário foi provisionado.

Valores possíveis:
0 - não provisionado;
1 - provisionado.

Esta propriedade é suportada desde o Zabbix 7.0.9.
userdirectory_mediaid ID ID de mapeamento de media do diretório de usuários para media provisionada.

Comportamento da propriedade:
- somente leitura
- suportado para usuários do tipo Super admin (desde o Zabbix 7.0.9)