[comment]: # aside: 1

[comment]: # ({d1f57367-6bb9f60f})
# Objeto item

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

[comment]: # ({/d1f57367-6bb9f60f})

[comment]: # ({68ea2686-385ac8b5})
### Item

::: noteclassic
Itens web não podem ser criados, atualizados ou excluídos diretamente pela API do Zabbix.
:::

O objeto item possui as seguintes propriedades.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|itemid|ID|ID do item.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* para operações de atualização|
|delay|string|Intervalo de atualização do item.<br><br>Aceita segundos ou unidade de tempo com sufixo (por exemplo, 30s, 1m, 2h, 1d) e, opcionalmente, um ou mais [intervalos personalizados](/manual/config/items/item/custom_intervals), todos separados por ponto e vírgula. Intervalos personalizados podem ser uma mistura de intervalos flexíveis e de agendamento.<br><br>Aceita macros de usuário. Se usado, o valor deve ser uma única macro. Várias macros ou macros misturadas com texto não são suportadas. Intervalos flexíveis podem ser escritos como duas macros separadas por uma barra (por exemplo, `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Exemplo:<br>`1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}`<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` estiver definido como "Zabbix agent" (0), "Simple check" (3), "Zabbix internal" (5), "External check" (10), "Database monitor" (11), "IPMI agent" (12), "SSH agent" (13), "TELNET agent" (14), "Calculated" (15), "JMX agent" (16), "HTTP agent" (19), "SNMP agent" (20), "Script" (21), "Browser" (22), ou se `type` estiver definido como "Zabbix agent (active)" (7) e `key_` não contiver "mqtt.get"|
|hostid|ID|ID do host ou template ao qual o item pertence.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *required* para operações de criação|
|interfaceid|ID|ID da interface do host do item.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se o item pertencer a um host e `type` estiver definido como "Zabbix agent", "IPMI agent", "JMX agent", "SNMP trap" ou "SNMP agent"<br>- *supported* se o item pertencer a um host e `type` estiver definido como "Simple check", "External check", "SSH agent", "TELNET agent" ou "HTTP agent"<br>- *read-only* para objetos descobertos|
|key\_|string|Chave do item.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* para operações de criação<br>- *read-only* para objetos herdados ou objetos descobertos|
|name|string|Nome do item.<br>Suporta macros de usuário.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* para operações de criação<br>- *read-only* para objetos herdados ou objetos descobertos|
|name\_resolved|string|Nome do item com macros de usuário resolvidas.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|type|integer|Tipo do item.<br><br>Valores possíveis:<br>0 - Zabbix agent;<br>2 - Zabbix trapper;<br>3 - Simple check;<br>5 - Zabbix internal;<br>7 - Zabbix agent (active);<br>9 - Web item;<br>10 - External check;<br>11 - Database monitor;<br>12 - IPMI agent;<br>13 - SSH agent;<br>14 - TELNET agent;<br>15 - Calculated;<br>16 - JMX agent;<br>17 - SNMP trap;<br>18 - Dependent item;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script;<br>22 - Browser.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* para operações de criação<br>- *read-only* para objetos herdados ou objetos descobertos|
|url|string|String de URL.<br>Suporta macros de usuário, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {ITEM.ID}, {ITEM.KEY}.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` estiver definido como "HTTP agent"<br>- *read-only* para objetos herdados ou objetos descobertos|
|value\_type|integer|Tipo de informação do item.<br><br>Valores possíveis:<br>0 - float numérico;<br>1 - caractere;<br>2 - log;<br>3 - inteiro sem sinal;<br>4 - texto;<br>5 - binário.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* para operações de criação<br>- *read-only* para objetos herdados ou objetos descobertos|
|allow\_traps|integer|Permite preencher o valor de forma semelhante ao item trapper.<br><br>0 - *(default)* Não permite aceitar dados recebidos;<br>1 - Permite aceitar dados recebidos.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "HTTP agent"<br>- *read-only* para objetos descobertos|
|authtype|integer|Método de autenticação.<br><br>Valores possíveis se `type` estiver definido como "SSH agent":<br>0 - *(default)* senha;<br>1 - chave pública.<br><br>Valores possíveis se `type` estiver definido como "HTTP agent":<br>0 - *(default)* nenhum;<br>1 - basic;<br>2 - NTLM;<br>3 - Kerberos;<br>4 - Digest.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "SSH agent" ou "HTTP agent"<br>- *read-only* para objetos herdados (se `type` estiver definido como "HTTP agent") ou objetos descobertos|
|description|string|Descrição do item.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only* para objetos descobertos|
|error|string|Texto do erro se houver problemas ao atualizar o valor do item.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|flags|integer|[Origem](/manual/api/reference_commentary#entity-origin-flags) do item.<br><br>Valores possíveis:<br>0 - um item simples;<br>4 - um item convertido de protótipo.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|follow\_redirects|integer|Seguir redirecionamentos da resposta durante a coleta de dados.<br><br>Valores possíveis:<br>0 - Não seguir redirecionamentos;<br>1 - *(default)* Seguir redirecionamentos.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "HTTP agent"<br>- *read-only* para objetos herdados ou objetos descobertos|
|headers|array|Array de [headers](#http-header) que serão enviados ao executar uma requisição HTTP.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "HTTP agent"<br>- *read-only* para objetos herdados ou objetos descobertos|
|history|string|Uma unidade de tempo de por quanto tempo os dados de histórico devem ser armazenados.<br>Também aceita macro de usuário.<br><br>Default: 31d.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only* para objetos descobertos|
|http\_proxy|string|String de conexão do proxy HTTP(S).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "HTTP agent"<br>- *read-only* para objetos herdados ou objetos descobertos|
|inventory\_link|integer|ID do campo de inventário do host preenchido pelo item.<br><br>Consulte a [página de inventário do host](/manual/api/reference/host/object#host-inventory) para obter uma lista dos campos de inventário do host suportados e seus IDs.<br><br>Default: 0.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `value_type` estiver definido como "numeric float", "character", "numeric unsigned" ou "text"<br>- *read-only* para objetos descobertos|
|ipmi\_sensor|string|Sensor IPMI.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` estiver definido como "IPMI agent" e `key_` não estiver definido como "ipmi.get"<br>- *supported* se `type` estiver definido como "IPMI agent"<br>- *read-only* para objetos herdados ou objetos descobertos|
|jmx\_endpoint|string|String de conexão personalizada do JMX agent.<br><br>Valor padrão: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "JMX agent"<br>- *read-only* para objetos descobertos|
|lastclock|timestamp|Hora em que o valor do item foi atualizado pela última vez.<br><br>Por padrão, apenas valores que se enquadram nas últimas 24 horas são exibidos. Você pode estender esse período alterando o valor do parâmetro *Max history display period* na seção de menu *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|lastns|integer|Nanosegundos em que o valor do item foi atualizado pela última vez.<br><br>Por padrão, apenas valores que se enquadram nas últimas 24 horas são exibidos. Você pode estender esse período alterando o valor do parâmetro *Max history display period* na seção de menu *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|lastvalue|string|Último valor do item.<br><br>Por padrão, apenas valores que se enquadram nas últimas 24 horas são exibidos. Você pode estender esse período alterando o valor do parâmetro *Max history display period* na seção de menu *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|logtimefmt|string|Formato da hora nas entradas de log.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `value_type` estiver definido como "log"<br>- *read-only* para objetos herdados ou objetos descobertos|
|master\_itemid|ID|ID do item mestre.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` estiver definido como "Dependent item"<br>- *read-only* para objetos herdados ou objetos descobertos|
|output\_format|integer|A resposta deve ser convertida para JSON.<br><br>0 - *(default)* Armazenar bruto;<br>1 - Converter para JSON.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "HTTP agent"<br>- *read-only* para objetos herdados ou objetos descobertos|
|params|string|Parâmetros adicionais dependendo do tipo do item:<br>- script executado para itens SSH agent e TELNET agent;<br>- consulta SQL para itens database monitor;<br>- fórmula para itens calculados;<br>- o script para itens script e browser.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` estiver definido como "Database monitor", "SSH agent", "TELNET agent", "Calculated", "Script" ou "Browser"<br>- *read-only* para objetos herdados (se `type` estiver definido como "Script" ou "Browser") ou objetos descobertos|
|parameters|object/array|Parâmetros adicionais se `type` estiver definido como "Script" ou "Browser". Array de objetos com propriedades `name` e `value`, em que `name` deve ser único.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "Script" ou "Browser"<br>- *read-only* para objetos herdados ou objetos descobertos|
|password|string|Senha para autenticação.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` estiver definido como "JMX agent" e `username` estiver definido<br>- *supported* se `type` estiver definido como "Simple check", "SSH agent", "TELNET agent", "Database monitor" ou "HTTP agent"<br>- *read-only* para objetos herdados (se `type` estiver definido como "HTTP agent") ou objetos descobertos|
|post\_type|integer|Tipo do corpo dos dados de postagem armazenado na propriedade `posts`.<br><br>Valores possíveis:<br>0 - *(default)* Dados brutos;<br>2 - Dados JSON;<br>3 - Dados XML.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "HTTP agent"<br>- *read-only* para objetos herdados ou objetos descobertos|
|posts|string|Dados do corpo da requisição HTTP(S).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` estiver definido como "HTTP agent" e `post_type` estiver definido como "JSON data" ou "XML data"<br>- *supported* se `type` estiver definido como "HTTP agent" e `post_type` estiver definido como "Raw data"<br>- *read-only* para objetos herdados ou objetos descobertos|
|prevvalue|string|Valor anterior do item.<br><br>Por padrão, apenas valores que se enquadram nas últimas 24 horas são exibidos. Você pode estender esse período alterando o valor do parâmetro *Max history display period* na seção de menu *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|privatekey|string|Nome do arquivo da chave privada.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` estiver definido como "SSH agent" e `authtype` estiver definido como "public key"<br>- *read-only* para objetos descobertos|
|publickey|string|Nome do arquivo da chave pública.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` estiver definido como "SSH agent" e `authtype` estiver definido como "public key"<br>- *read-only* para objetos descobertos|
|query\_fields|array|Array de [query fields](#http-query-field) que serão enviados ao executar uma requisição HTTP.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "HTTP agent"<br>- *read-only* para objetos herdados ou objetos descobertos|
|request\_method|integer|Tipo do método de requisição.<br><br>Valores possíveis:<br>0 - *(default)* GET;<br>1 - POST;<br>2 - PUT;<br>3 - HEAD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "HTTP agent"<br>- *read-only* para objetos herdados ou objetos descobertos|
|retrieve\_mode|integer|Qual parte da resposta deve ser armazenada.<br><br>Valores possíveis se `request_method` estiver definido como "GET", "POST" ou "PUT":<br>0 - *(default)* Corpo;<br>1 - Headers;<br>2 - Corpo e headers serão armazenados.<br><br>Valores possíveis se `request_method` estiver definido como "HEAD":<br>1 - Headers.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "HTTP agent"<br>- *read-only* para objetos herdados ou objetos descobertos|
|snmp\_oid|string|OID SNMP.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` estiver definido como "SNMP agent"<br>- *read-only* para objetos herdados ou objetos descobertos|
|ssl\_cert\_file|string|Caminho do arquivo da chave SSL pública.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "HTTP agent"<br>- *read-only* para objetos herdados ou objetos descobertos|
|ssl\_key\_file|string|Caminho do arquivo da chave SSL privada.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "HTTP agent"<br>- *read-only* para objetos herdados ou objetos descobertos|
|ssl\_key\_password|string|Senha para o arquivo da chave SSL.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "HTTP agent"<br>- *read-only* para objetos herdados ou objetos descobertos|
|state|integer|Estado do item.<br><br>Valores possíveis:<br>0 - *(default)* normal;<br>1 - não suportado.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|status|integer|Status do item.<br><br>Valores possíveis:<br>0 - *(default)* item habilitado;<br>1 - item desabilitado.|
|status\_codes|string|Intervalos dos códigos de status HTTP necessários, separados por vírgulas.<br>Também suporta macros de usuário como parte de uma lista separada por vírgulas.<br><br>Exemplo: 200,200-{$M},{$M},200-400<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "HTTP agent"<br>- *read-only* para objetos herdados ou objetos descobertos|
|templateid|ID|ID do item de template pai.<br><br>*Dica*: Use a propriedade `hostid` para especificar o template ao qual o item pertence.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|timeout|string|Tempo limite da requisição de coleta de dados do item.<br>Aceita segundos ou unidade de tempo com sufixo (por exemplo, 30s, 1m). Também aceita macros de usuário.<br><br>Intervalo de valores possível: 1-600s.<br><br>Default: "" - usar configurações do proxy/globais.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "Zabbix agent" (0), "Simple check" (3) e `key_` não começar com "`vmware.`" e "`icmpping`", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) e `snmp_oid` começar com "`walk[`" ou "`get[`", "Script" (21), "Browser" (22)<br>- *read-only* para objetos herdados e descobertos|
|trapper\_hosts|string|Hosts permitidos.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *readonly* para objetos descobertos<br>- *supported* se `type` estiver definido como "Zabbix trapper", ou se `type` estiver definido como "HTTP agent" e `allow_traps` estiver definido como "Allow to accept incoming data"|
|trends|string|Uma unidade de tempo de por quanto tempo os dados de tendências devem ser armazenados.<br>Também aceita macro de usuário.<br><br>Default: 365d.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `value_type` estiver definido como "numeric float" ou "numeric unsigned"<br>- *read-only* para objetos descobertos|
|units|string|Unidades do valor.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `value_type` estiver definido como "numeric float" ou "numeric unsigned"<br>- *read-only* para objetos herdados ou objetos descobertos|
|username|string|Nome de usuário para autenticação.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` estiver definido como "SSH agent", "TELNET agent" ou se `type` estiver definido como "JMX agent" e `password` estiver definido<br>- *supported* se `type` estiver definido como "Simple check", "Database monitor" ou "HTTP agent"<br>- *read-only* para objetos herdados (se `type` estiver definido como "HTTP agent") ou objetos descobertos|
|uuid|string|Identificador universal único, usado para vincular o item importado a itens já existentes. Gerado automaticamente, se não for fornecido.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se o item pertencer a um template|
|valuemapid|ID|ID do mapa de valores associado.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `value_type` estiver definido como "numeric float", "character" ou "numeric unsigned"<br>- *read-only* para objetos herdados ou objetos descobertos|
|verify\_host|integer|Se deve validar se o nome do host para a conexão corresponde ao do certificado do host.<br><br>Valores possíveis:<br>0 - *(default)* Não validar;<br>1 - Validar.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "HTTP agent"<br>- *read-only* para objetos herdados ou objetos descobertos|
|verify\_peer|integer|Se deve validar se o certificado do host é autêntico.<br><br>Valores possíveis:<br>0 - *(default)* Não validar;<br>1 - Validar.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` estiver definido como "HTTP agent"<br>- *read-only* para objetos herdados ou objetos descobertos|

[comment]: # ({/68ea2686-385ac8b5})

[comment]: # ({ab5307fa-7efc456e})
#### Cabeçalho HTTP

O objeto header possui as seguintes propriedades:

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--------|---------------------------------------------------|-----------|
|name|string|Nome do cabeçalho HTTP.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|value|string|Valor do cabeçalho.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|

[comment]: # ({/ab5307fa-7efc456e})

[comment]: # ({5b4177f3-ee8852f1})
#### Campo de consulta HTTP

O objeto de campo de consulta define um nome e valor que é usado para especificar um parâmetro de URL.
Ele possui as seguintes propriedades:

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--------|---------------------------------------------------|-----------|
|name|string|Nome do parâmetro.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|value|string|Valor do parâmetro.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|

[comment]: # ({/5b4177f3-ee8852f1})

[comment]: # ({c9a1b21e-c1b98afa})
### Tag de item

O objeto de tag de item possui as seguintes propriedades.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|Nome da tag do item.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Valor da tag do item.|

[comment]: # ({/c9a1b21e-c1b98afa})

[comment]: # ({eed27a12-2169bb78})
### Pré-processamento de item

O objeto de pré-processamento de item possui as seguintes propriedades.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|type|integer|O tipo da opção de pré-processamento.<br><br>Valores possíveis:<br>1 - Multiplicador personalizado;<br>2 - Remoção de espaços à direita;<br>3 - Remoção de espaços à esquerda;<br>4 - Remover espaços;<br>5 - Expressão regular;<br>6 - Booleano para decimal;<br>7 - Octal para decimal;<br>8 - Hexadecimal para decimal;<br>9 - Alteração simples;<br>10 - Alteração por segundo;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - Dentro do intervalo;<br>14 - Corresponde à expressão regular;<br>15 - Não corresponde à expressão regular;<br>16 - Verificar erro em JSON;<br>17 - Verificar erro em XML;<br>18 - Verificar erro usando expressão regular;<br>19 - Descartar inalterado;<br>20 - Descartar inalterado com heartbeat;<br>21 - JavaScript;<br>22 - Padrão Prometheus;<br>23 - Prometheus para JSON;<br>24 - CSV para JSON;<br>25 - Substituir;<br>26 - Verificar não suportado;<br>27 - XML para JSON;<br>28 - Valor de walk SNMP;<br>29 - Walk SNMP para JSON;<br>30 - Valor de get SNMP.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|params|string|Parâmetros adicionais usados pela opção de pré-processamento.<br>Vários parâmetros são separados pelo caractere de nova linha (\\n).<br><br>Se `type` estiver definido como "Check unsupported", os parâmetros seguem a sintaxe `<scope>[\n<pattern>]`, em que *pattern* é uma expressão regular e *scope* é um dos seguintes:<br>-1 - corresponde a qualquer erro;<br>\ 0 - verifica se a mensagem de erro corresponde a *pattern*;<br>\ 1 - verifica se a mensagem de erro não corresponde a *pattern*.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* se `type` estiver definido como "Custom multiplier" (1), "Right trim" (2), "Left trim" (3), "Trim" (4), "Regular expression" (5), "XML XPath" (11), "JSONPath" (12), "In range" (13), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Check for error using regular expression" (18), "Discard unchanged with heartbeat" (20), "JavaScript" (21), "Prometheus pattern" (22), "Prometheus to JSON" (23), "CSV to JSON" (24), "Replace" (25), Check unsupported (26), "SNMP walk value" (28), "SNMP walk to JSON" (29), ou "SNMP get value" (30)|
|error\_handler|integer|Tipo de ação usado em caso de falha na etapa de pré-processamento.<br><br>Valores possíveis:<br>0 - A mensagem de erro é definida pelo Zabbix server;<br>1 - Descartar valor;<br>2 - Definir valor personalizado;<br>3 - Definir mensagem de erro personalizada.<br><br>Valores possíveis se `type` estiver definido como "Check unsupported":<br>1 - Descartar valor;<br>2 - Definir valor personalizado;<br>3 - Definir mensagem de erro personalizada.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* se `type` estiver definido como "Custom multiplier" (1), "Regular expression" (5), "Boolean to decimal" (6), "Octal to decimal" (7), "Hexadecimal to decimal" (8), "Simple change" (9), "Change per second" (10), "XML XPath" (11), "JSONPath" (12), "In range" (13), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Check for error using regular expression" (18), "Prometheus pattern" (22), "Prometheus to JSON" (23), "CSV to JSON" (24), "Check unsupported" (26), "XML to JSON" (27), "SNMP walk value" (28), "SNMP walk to JSON" (29), ou "SNMP get value" (30)|
|error\_handler\_params|string|Parâmetros do manipulador de erro.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* se `error_handler` estiver definido como "Set custom value" ou "Set custom error message"|

Os seguintes parâmetros e manipuladores de erro são suportados para cada tipo de pré-processamento.

|Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers|
|------------------|----|-----------|-----------|-----------|------------------------|
|1|Custom multiplier|number^1, 6^|<|<|0, 1, 2, 3|
|2|Right trim|list of characters^2^|<|<|<|
|3|Left trim|list of characters^2^|<|<|<|
|4|Trim|list of characters^2^|<|<|<|
|5|Regular expression|pattern^3^|output^2^|<|0, 1, 2, 3|
|6|Boolean to decimal|<|<|<|0, 1, 2, 3|
|7|Octal to decimal|<|<|<|0, 1, 2, 3|
|8|Hexadecimal to decimal|<|<|<|0, 1, 2, 3|
|9|Simple change|<|<|<|0, 1, 2, 3|
|10|Change per second|<|<|<|0, 1, 2, 3|
|11|XML XPath|path^4^|<|<|0, 1, 2, 3|
|12|JSONPath|path^4^|<|<|0, 1, 2, 3|
|13|In range|min^1, 6^|max^1, 6^|<|0, 1, 2, 3|
|14|Matches regular expression|pattern^3^|<|<|0, 1, 2, 3|
|15|Does not match regular expression|pattern^3^|<|<|0, 1, 2, 3|
|16|Check for error in JSON|path^4^|<|<|0, 1, 2, 3|
|17|Check for error in XML|path^4^|<|<|0, 1, 2, 3|
|18|Check for error using regular expression|pattern^3^|output^2^|<|0, 1, 2, 3|
|19|Discard unchanged|<|<|<|<|
|20|Discard unchanged with heartbeat|seconds^5, 6^|<|<|<|
|21|JavaScript|script^2^|<|<|<|
|22|Prometheus pattern|pattern^6, 7^|`value`, `label`, `function`|output^8, 9^|0, 1, 2, 3|
|23|Prometheus to JSON|pattern^6, 7^|<|<|0, 1, 2, 3|
|24|CSV to JSON|character^2^|character^2^|0,1|0, 1, 2, 3|
|25|Replace|search string^2^|replacement^2^|<|<|
|26|Check unsupported|scope^1^|pattern^3, 6^|<|1, 2, 3|
|27|XML to JSON|<|<|<|0, 1, 2, 3|
|28|SNMP walk value|OID^2^|Format:<br>0 - Unchanged<br>1 - UTF-8 from Hex-STRING<br>2 - MAC from Hex-STRING<br>3 - Integer from BITS|<|0, 1, 2, 3|
|29|SNMP walk to JSON^10^|Field name^2^|OID prefix^2^|Format:<br>0 - Unchanged<br>1 - UTF-8 from Hex-STRING<br>2 - MAC from Hex-STRING<br>3 - Integer from BITS|0, 1, 2, 3|
|30|SNMP get value|Format:<br>1 - UTF-8 from Hex-STRING<br>2 - MAC from Hex-STRING<br>3 - Integer from BITS|<|<|0, 1, 2, 3|

^1^ número de ponto flutuante (inteiros são convertidos implicitamente para valores float)<br>
^2^ string<br>
^3^ expressão regular<br>
^4^ JSONPath ou XML XPath<br>
^5^ inteiro positivo (com suporte a sufixos de tempo, por exemplo 30s, 1m, 2h,
1d)<br>
^6^ macro de usuário<br>
^7^ padrão Prometheus seguindo a sintaxe:
`<metric name>{<label name>="<label value>", ...} == <value>`. Cada
componente do padrão Prometheus (métrica, nome do rótulo, valor do rótulo e valor da métrica) pode ser uma macro de usuário.<br>
^8^ saída Prometheus seguindo a sintaxe: `<label name>` (pode ser uma macro de usuário) se `label` estiver selecionado como o segundo parâmetro.<br>
^9^ Uma das funções de agregação: `sum`, `min`, `max`, `avg`, `count` se `function` estiver selecionado como o segundo parâmetro.<br>
^10^ Suporta vários registros "Field name,OID prefix,Format" delimitados por um caractere de nova linha.

[comment]: # ({/eed27a12-2169bb78})