[comment]: # translation:outdated [comment]: # ({6bb9f60f-6bb9f60f}) # > Objeto de item Os objetos a seguir estão diretamente relacionados à API `item`. [comment]: # ({/6bb9f60f-6bb9f60f}) [comment]: # ({140c9736-385ac8b5}) ### Item ::: noteclassic Os itens da Web não podem ser criados, atualizados ou excluídos diretamente por meio de a API do Zabbix. ::: O objeto item tem as seguintes propriedades. |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |itemid|string|*(readonly)* ID do item.| |**atraso**
(obrigatório)|string|Intervalo de atualização do item. Aceita segundos ou uma unidade de tempo com sufixo (30s,1m,2h,1d).
Opcionalmente, um ou mais [intervalos personalizados](/manual/config/items/item/custom_intervals) podem ser especificados como intervalos flexíveis ou agendamento .
Vários intervalos são separados por um ponto e vírgula.
As macros do usuário podem ser usadas. Uma única macro deve preencher todo o campo. Não há suporte para várias macros em um campo ou macros misturadas com texto.
Intervalos flexíveis podem ser escritos como duas macros separadas por uma barra (por exemplo, `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).

Opcional para Zabbix trapper, itens dependentes e para Zabbix agent (ativo) com chave `mqtt.get`.| |**hostid**
(obrigatório)|string|ID do host ou modelo ao qual o item pertence.

Para operações de atualização, este campo é *readonly*.| |**interfaceid**
(obrigatório)|string|ID da interface do host do item.

Não obrigatório para itens de modelo. Opcional para itens internos, agente ativo, trapper, calculado, dependente e monitor de banco de dados.| |**chave\_**
(obrigatório)|string|Chave do item.| |**nome**
(obrigatório)|string|Nome do item.| |**tipo**
(obrigatório)|inteiro|Tipo do item.

Valores possíveis:
0 - Zabbix agent;
2 - Zabbix trapper;
3 - Verificação simples;
5 - Zabbix interno;
7 - Agente Zabbix (ativo);
9 - Item da Web;
10 - Verificação externa;
11 - Monitor de banco de dados;
12 - Agente IPMI;
13 - Agente SSH;
14 - Agente Telnet;
15 - Calculado;
16 - Agente JMX;
17 - Armadilha SNMP;
18 - Item dependente ;
19 - Agente HTTP;
20 - Agente SNMP;
21 - Script| |**url**
(obrigatório)|string|string de URL, necessária apenas para o tipo de item de agente HTTP. Suporta macros de usuário, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |**valor\_tipo**
(obrigatório)|inteiro|Tipo de informação do item.

Valores possíveis:
0 - número flutuante;
1 - caractere;
2 - log;
3 - numérico sem sinal;
4 - texto.| |allow\_traps|inteiro|campo de item do agente HTTP. Permitir preencher valor como no tipo de item trapper também.

0 - *(padrão)* Não permitir aceitar dados de entrada.
1 - Permitir aceitar dados de entrada.| |authtype|integer|Usado apenas por itens do agente SSH ou itens do agente HTTP.

Valores possíveis do método de autenticação do agente SSH:
0 - *(padrão)* senha;
1 - chave pública.< br>
método de autenticação do agente HTTP valores possíveis:
0 - *(padrão)* nenhum
1 - básico
2 - NTLM
3 - Kerberos| |descrição|string|Descrição do item.| |error|string|*(readonly)* Texto de erro se houver problemas ao atualizar o item.| |flags|inteiro|*(somente leitura)* Origem do item.

Valores possíveis:
0 - um item simples;
4 - um item descoberto.| |follow\_redirects|inteiro|campo de item do agente HTTP. Siga os redirecionamentos de resposta ao agrupar dados.

0 - Não siga os redirecionamentos.
1 - *(padrão)* Siga os redirecionamentos.| |headers|object|campo de item do agente HTTP. Objeto com cabeçalhos de solicitação HTTP(S), onde o nome do cabeçalho é usado como chave e o valor do cabeçalho como valor.

Exemplo:
{ "User-Agent": "Zabbix" }| |history|string|Uma unidade de tempo de quanto tempo os dados do histórico devem ser armazenados. Também aceita macro de usuário.

Padrão: 90d.| |http\_proxy|string|campo de item do agente HTTP. Cadeia de conexão do proxy HTTP(S).| |inventário\_link|inteiro|ID do campo de inventário do host que é preenchido pelo item.

Consulte a [página de inventário do host](/manual/api/reference/host/object#host_inventory) para obter um lista de campos de inventário de host suportados e seus IDs.

Padrão: 0.| |ipmi\_sensor|string|sensor IPMI. Usado apenas por itens do IPMI.| |jmx\_endpoint|string|String de conexão personalizada do agente JMX.

Valor padrão:
service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT }/jmxrmi| |lastclock|timestamp|*(readonly)* Hora em que o item foi atualizado pela última vez.

Por padrão, apenas os valores que se enquadram nas últimas 24 horas são exibidos. Você pode estender esse período alterando o valor do parâmetro *Período máximo de exibição do histórico* na seção de menu *[Administração → Geral](/manual/web_interface/frontend_sections/administration/general#gui)*.| |lastns|integer|*(readonly)* Nanossegundos quando o item foi atualizado pela última vez.

Por padrão, apenas os valores que se enquadram nas últimas 24 horas são exibidos. Você pode estender esse período alterando o valor do parâmetro *Período máximo de exibição do histórico* na seção de menu *[Administração → Geral](/manual/web_interface/frontend_sections/administration/general#gui)*.| |lastvalue|string|*(readonly)* Último valor do item.

Por padrão, apenas os valores das últimas 24 horas são exibidos. Você pode estender esse período de tempo alterando o value do parâmetro *Período máximo de exibição do histórico* na seção de menu *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)*.| |logtimefmt|string|Formato da hora nas entradas de log. Usado apenas por itens de log.| |master\_itemid|integer|ID do item mestre.
Recursão de até 3 itens dependentes e contagem máxima de itens dependentes igual a 29999 são permitidas.

Requerido por itens dependentes.| |output\_format|inteiro|campo de item do agente HTTP. A resposta deve ser convertida em JSON.

0 - *(padrão)* Armazenar raw.
1 - Converter em JSON.| |params|string|Parâmetros adicionais dependendo do tipo do item:
- script executado para itens SSH e Telnet;
- consulta SQL para itens do monitor de banco de dados;
- fórmula para itens calculados;
- o script para o item de script.| |parameters|array|Parâmetros adicionais para itens de script. Matriz de objetos com propriedades 'nome' e 'valor', onde o nome deve ser exclusivo.| |senha|string|Senha para autenticação. Usado por itens de verificação simples, SSH, Telnet, monitor de banco de dados, JMX e agente HTTP.
Quando usado por JMX, o nome de usuário também deve ser especificado junto com a senha ou ambas as propriedades devem ser deixadas em branco.| |post\_type|inteiro|campo de item do agente HTTP. Tipo de corpo de dados de postagem armazenado na propriedade de postagens.

0 - *(padrão)* Dados brutos.
2 - Dados JSON.
3 - Dados XML.| |posts|string|campo de item do agente HTTP. Dados do corpo da solicitação HTTP(S). Usado com post\_type.| |prevvalue|string|*(readonly)* Valor anterior do item.

Por padrão, apenas os valores das últimas 24 horas são exibidos. Você pode estender esse período alterando o valor do parâmetro *Período máximo de exibição do histórico* na seção de menu *[Administração → Geral](/manual/web_interface/frontend_sections/administration/general#gui)*.| |privatekey|string|Nome do arquivo de chave privada.| |publickey|string|Nome do arquivo de chave pública.| |query\_fields|array|campo de item do agente HTTP. Parâmetros de consulta. Matriz de objetos com pares 'chave':'valor', onde valor pode ser uma string vazia.| |request\_method|integer|campo de item do agente HTTP. Tipo de método de solicitação.

0 - *(padrão)* GET
1 - POST
2 - PUT
3 - HEAD| |recuperar\_modo|inteiro|campo de item do agente HTTP. Qual parte da resposta deve ser armazenada.

0 - *(padrão)* Corpo.
1 - Cabeçalhos.
2 - O corpo e os cabeçalhos serão armazenados.

Para request\_method HEAD somente 1 é o valor permitido.| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|campo de item do agente HTTP. Caminho do arquivo de chave SSL pública.| |ssl\_key\_file|string|campo de item do agente HTTP. Caminho do arquivo de chave SSL privada.| |ssl\_key\_password|string|campo de item do agente HTTP. Senha para arquivo de chave SSL.| |estado|inteiro|*(somente leitura)* Estado do item.

Valores possíveis:
0 - *(padrão)* normal;
1 - não suportado.| |status|inteiro|Status do item.

Valores possíveis:
0 - *(padrão)* item habilitado;
1 - item desabilitado.| |status\_codes|string|campo de item do agente HTTP. Intervalos de códigos de status HTTP necessários separados por vírgulas. Também suporta macros de usuário como parte da lista separada por vírgulas.

Exemplo: 200,200-{$M},{$M},200-400| |templateid|string|(somente leitura) ID do item de modelo pai.

*Dica*: Use a propriedade `hostid` para especificar o modelo ao qual o item pertence.| |timeout|string|Tempo limite da solicitação de sondagem de dados do item. Usado para agente HTTP e itens de script. Suporta macros de usuário.

padrão: 3s
valor máximo: 60s| |trapper\_hosts|string|Hosts permitidos. Usado por itens de trapper ou itens de agente HTTP.| |trends|string|Uma unidade de tempo de quanto tempo os dados de tendências devem ser armazenados. Também aceita macro de usuário.

Padrão: 365d.| |unidades|string|Unidades de valor.| |username|string|Username para autenticação. Usado por verificação simples, SSH, Telnet, monitor de banco de dados, itens de agente JMX e HTTP.

Requerido por itens SSH e Telnet.
Quando usado por JMX, a senha também deve ser especificada junto com o nome de usuário ou ambas as propriedades deve ser deixado em branco.| |uuid|string|Identificador único universal, usado para vincular item importado a itens já existentes. Usado apenas para itens em modelos. Gerado automaticamente, se não fornecido.

Para operações de atualização, este campo é *somente leitura*.| |valuemapid|string|ID do mapa de valores associado.| |verify\_host|inteiro|campo de item do agente HTTP. Validar o nome do host na URL está no campo Nome Comum ou em um campo Nome Alternativo da Entidade do certificado do host.

0 - *(padrão)* Não validar.
1 - Validar.| |verify\_peer|integer|campo de item do agente HTTP. Validar é o certificado do host autêntico.

0 - *(padrão)* Não validar.
1 - Validar.| [comment]: # ({/140c9736-385ac8b5}) [comment]: # ({bc833afe-c1b98afa}) ### Marca do item O objeto tag do item tem as seguintes propriedades. |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |**tag**
(obrigatório)|string|Nome da tag do item.| |valor|string|Valor da tag do item.| [comment]: # ({/bc833afe-c1b98afa}) [comment]: # ({75722841-2169bb78}) ### Pré-processamento de itens O objeto de pré-processamento de item tem as seguintes propriedades. |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |**tipo**
(obrigatório)|inteiro|O tipo de opção de pré-processamento.

Valores possíveis:
1 - Multiplicador personalizado;
2 - Corte direito;
3 - Trim esquerdo;
4 - Trim;
5 - Correspondência de expressão regular;
6 - Booleano para decimal;
7 - Octal para decimal;
8 - Hexadecimal para decimal;
9 - Alteração simples;
10 - Alteração por segundo;
11 - XML XPath;
12 - JSONPath;
13 - No intervalo;
14 - Corresponde à expressão regular;
15 - Não corresponde à expressão regular;
16 - Verifique se há erro no JSON;
17 - Verifique se há erro no XML;
18 - Verifique se há erro usando a expressão regular;
19 - Descarte inalterado;
20 - Descartar inalterado com pulsação;
21 - JavaScript;
22 - Padrão Prometheus;
23 - Prometheus para JSON;
24 - CSV para JSON;
25 - Substituir;
26 - Verificação não suportada;
27 - XML para JSON.| |**params**
(obrigatório)|string|Parâmetros adicionais usados pela opção de pré-processamento. Vários parâmetros são separados pelo caractere LF (\\n).| |**error\_handler**
(obrigatório)|inteiro|Tipo de ação usado em caso de falha na etapa de pré-processamento.

Valores possíveis:
0 - Mensagem de erro é definida pelo servidor Zabbix;< br>1 - Descartar valor;
2 - Definir valor personalizado;
3 - Definir mensagem de erro personalizada.| |**error\_handler\_params**
(obrigatório)|string|Parâmetros do manipulador de erros. Usado com `error_handler`.

Deve estar vazio, se `error_handler` for 0 ou 1.
Pode estar vazio se, `error_handler` for 2.
Não pode estar vazio, se `error_handler` é 3.| Os seguintes parâmetros e manipuladores de erros são suportados para cada tipo de pré-processamento. |Tipo de pré-processamento|Nome|Parâmetro 1|Parâmetro 2|Parâmetro 3|Manipuladores de erro suportados| |------------------|----|-----------|-----------|- ----------|------------------------| |1|Multiplicador personalizado|número^1,\6^|<|<|0, 1, 2, 3| |2|Corte direito|lista de caracteres^2^|<|<|<| |3|Corte esquerdo|lista de caracteres^2^|<|<|<| |4|Cortar|lista de caracteres^2^|<|<|<| |5|Expressão regular|padrão^3^|saída^2^|<|0, 1, 2, 3| |6|Booleano para decimal|<|<|<|0, 1, 2, 3| |7|Octal para decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal para decimal|<|<|<|0, 1, 2, 3| |9|Mudança simples|<|<|<|0, 1, 2, 3| |10|Mudança por segundo|<|<|<|0, 1, 2, 3| |11|XML XPath|caminho^4^|<|<|0, 1, 2, 3| |12|JSONPath|caminho^4^|<|<|0, 1, 2, 3| |13|No intervalo|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3| |14|Corresponde à expressão regular|padrão^3^|<|<|0, 1, 2, 3| |15|Não corresponde à expressão regular|padrão^3^|<|<|0, 1, 2, 3| |16|Verifique se há erro em JSON|path^4^|<|<|0, 1, 2, 3| |17|Verificar erros em XML|path^4^|<|<|0, 1, 2, 3| |18|Verifique se há erro usando expressão regular|pattern^3^|output^2^|<|0, 1, 2, 3| |19|Descartar inalterado|<|<|<|<| |20|Descartar inalterado com pulsação|segundos^5,\ 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Padrão do Prometheus|padrão^6,\ 7^|`valor`, `rótulo`, `função`|saída^8,\ 9^|0, 1, 2, 3| |23|Prometheus para JSON|pattern^6,\7^|<|<|0, 1, 2, 3| |24|CSV para JSON|caractere^2^|caractere^2^|0,1|0, 1, 2, 3| |25|Substituir|sequência de pesquisa^2^|substituição^2^|<|<| |26|Verificação não suportada|<|<|<|1, 2, 3| |27|XML para JSON|<|<|<|0, 1, 2, 3| ^1^ número inteiro ou de ponto flutuante\ ^2^ seqüência de caracteres\ ^3^ expressão regular\ ^4^ JSONPath ou XML XPath\ ^5^ inteiro positivo (com suporte de sufixos de tempo, por exemplo, 30s, 1m, 2h, 1d)\ ^6^ macro do usuário\ ^7^ Padrão do Prometheus seguindo a sintaxe: `{="", ...} == `. Cada Componente padrão do Prometheus (métrica, nome do rótulo, valor do rótulo e métrica value) pode ser macro do usuário.\ ^8^ Saída do Prometheus seguindo a sintaxe: `