[comment]: # ({8b893994-ae6d2ebd})
# 4 Hosts

[comment]: # ({/8b893994-ae6d2ebd})

[comment]: # ({45b081d7-907c3faa})
#### Visão geral

Os hosts são [exportados](/manual/xml_export_import) com muitos objetos relacionados e relações de objetos.

A exportação de host contém:

-   [Grupos de hosts](/manual/xml_export_import/hostgroups) vinculados
-   Dados do host
-   Vinculação de template
-   Vinculação de grupo de host
-   Interfaces do host
-   Itens vinculados diretamente
-   Triggers vinculados diretamente
-   Regras de descoberta vinculadas diretamente com todos os protótipos
-   Cenários web vinculados diretamente
-   Macros do host
-   Dados de inventário do host
-   Mapas de valores
-   [Gráficos](/manual/xml_export_import/hosts#host-graphs) vinculados

[comment]: # ({/45b081d7-907c3faa})

[comment]: # ({ec949d61-55d6da26})
#### Exportando

Para exportar hosts, faça o seguinte:

1. Vá para *Coleta de dados* → *Hosts*.
2. Marque as caixas de seleção dos hosts a serem exportados.
3. Clique em *Exportar* abaixo da lista.

![](../../../assets/en/manual/xml_export_import/export_hosts.png)

Dependendo do formato selecionado, os hosts são exportados para um arquivo local com um nome padrão:

-   `zabbix_export_hosts.yaml` - na exportação YAML (opção padrão para exportação);
-   `zabbix_export_hosts.xml` - na exportação XML;
-   `zabbix_export_hosts.json` - na exportação JSON.

[comment]: # ({/ec949d61-55d6da26})

[comment]: # ({d8090da8-158cdcbf})
#### Importando

Para importar hosts, faça o seguinte:

1. Vá para *Coleta de dados* → *Hosts*.
2. Clique em *Importar* no canto superior direito.
3. Selecione o arquivo de importação.
4. Clique em *Importar* no canto inferior direito do formulário de configuração.

![](../../../assets/en/manual/xml_export_import/import_hosts.png){width="600"}

Se você marcar a caixa de seleção *Opções avançadas*, uma lista detalhada de todos os elementos importáveis será exibida - marque ou desmarque cada regra de importação conforme necessário.

Se você clicar na caixa de seleção na linha *Todos*, todos os elementos abaixo dela serão marcados/desmarcados.

Regras de importação:

|Regra|Descrição|
|----|-----------|
|*Atualizar existentes*|Os elementos existentes serão atualizados usando os dados do arquivo de importação. Caso contrário, eles não serão atualizados.|
|*Criar novos*|Novos elementos serão criados usando os dados do arquivo de importação. Caso contrário, eles não serão criados.|
|*Excluir ausentes*|Os elementos existentes que não estiverem presentes no arquivo de importação serão removidos. Caso contrário, eles não serão removidos.<br>Se *Excluir ausentes* estiver marcado para *Vinculação de template*, a vinculação de template atual que não estiver presente no arquivo de importação será desvinculada. Entidades (items, triggers, gráficos, etc.) herdadas dos templates desvinculados não serão removidas (a menos que a opção *Excluir ausentes* também seja selecionada para cada entidade).|

Uma mensagem de sucesso ou falha da importação será exibida no frontend.

[comment]: # ({/d8090da8-158cdcbf})

[comment]: # ({25e93578-93059e09})
#### Formato de exportação

Formato de exportação em YAML:

```yaml
zabbix_export:
  version: '7.0'
  host_groups:
    - uuid: f2481361f99448eea617b7b1d4765566
      name: 'Discovered hosts'
    - uuid: 6f6799aa69e844b4b3918f779f2abf08
      name: 'Zabbix servers'
  hosts:
    - host: 'Zabbix server 1'
      name: 'Main Zabbix server'
      monitored_by: 'SERVER'
      templates:
        - name: 'Linux by Zabbix agent'
        - name: 'Zabbix server health'
      groups:
        - name: 'Discovered hosts'
        - name: 'Zabbix servers'
      interfaces:
        - ip: 192.168.1.1
          interface_ref: if1
      items:
        - name: 'Zabbix trap'
          type: TRAP
          key: trap
          delay: '0'
          history: 1w
          preprocessing:
            - type: MULTIPLIER
              parameters:
                - '8'
          tags:
            - tag: component
              value: 'raw'
          triggers:
            - expression: 'last(/Zabbix server 1/trap)=0'
              name: 'Último valor é zero'
              priority: WARNING
              tags:
                - tag: scope
                  value: 'availability'
      tags:
        - tag: service
          value: zabbix-server
      macros:
        - macro: '{$HOST.MACRO}'
          value: '123'
        - macro: '{$PASSWORD1}'
          type: SECRET_TEXT
      inventory:
        type: 'Zabbix server'
        name: yyyyyy-HP-Pro-3010-Small-Form-Factor-PC
        os: 'Linux yyyyyy-HP-Pro-3010-Small-Form-Factor-PC 4.4.0-165-generic #193-Ubuntu SMP Tue Sep 17 17:42:52 UTC 2019 x86_64'
      inventory_mode: AUTOMATIC
  graphs:
    - name: 'Utilização de CPU do server'
      show_work_period: 'NO'
      show_triggers: 'NO'
      graph_items:
        - drawtype: FILLED_REGION
          color: FF5555
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,steal]'
        - sortorder: '1'
          drawtype: FILLED_REGION
          color: 55FF55
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,softirq]'
        - sortorder: '2'
          drawtype: FILLED_REGION
          color: '009999'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,interrupt]'
        - sortorder: '3'
          drawtype: FILLED_REGION
          color: '990099'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,nice]'
        - sortorder: '4'
          drawtype: FILLED_REGION
          color: '999900'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,iowait]'
        - sortorder: '5'
          drawtype: FILLED_REGION
          color: '990000'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,system]'
        - sortorder: '6'
          drawtype: FILLED_REGION
          color: '000099'
          calc_fnc: MIN
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,user]'
        - sortorder: '7'
          drawtype: FILLED_REGION
          color: '009900'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,idle]'

```

[comment]: # ({/25e93578-93059e09})

[comment]: # ({647dd50a-2c61d3f8})
## Elementos exportados

Os elementos exportados são explicados nas tabelas abaixo.

|Elemento|<|Tipo|Descrição|
|-|---|---|-----------------------|
|version|<|string|(obrigatório) Versão do Zabbix.|
|host_groups|<| |(obrigatório) Elemento raiz para grupos de hosts.|
|<|uuid|string|(obrigatório) Identificador único para este grupo de hosts.|
|^|name|string|(obrigatório) Nome do grupo de hosts.|
|hosts|<| |Elemento raiz para [hosts](#hosts).|

[comment]: # ({/647dd50a-2c61d3f8})

[comment]: # ({0908afaa-eedfe2b9})
### Hosts

|Element|<|Type|Description|
|-|---|---|-----------------------|
|host|<|string|(obrigatório) Nome exclusivo do host.|
|name|<|string|Nome visível do host.|
|description|<|text|Descrição do host.|
|monitored_by|<|string|Host é monitorado por: SERVER, PROXY ou PROXY_GROUP.|
|proxy|<| |Elemento raiz para proxy.|
| |name|string|(obrigatório) Nome do proxy (se houver) que monitora o host.|
|proxy_group|<| |Elemento raiz para grupo de proxy.|
| |name|string|(obrigatório) Nome do grupo de proxy (se houver) usado para monitorar o host.|
|status|<|string|Status do host.<br>Valores possíveis:^[1](#footnotes)^ ENABLED (0, padrão), DISABLED (1).|
|ipmi\_authtype|<|string|Tipo de autenticação da sessão IPMI.<br>Valores possíveis:^[1](#footnotes)^ DEFAULT (-1, padrão), NONE (0), MD2 (1), MD5 (2), STRAIGHT (4), OEM (5), RMCP\_PLUS (6).|
|ipmi\_privilege|<|string|Nível de privilégio da sessão IPMI.<br>Valores possíveis:^[1](#footnotes)^ CALLBACK (1), USER (2, padrão), OPERATOR (3), ADMIN (4), OEM (5).|
|ipmi\_username|<|string|Nome de usuário para verificações IPMI.|
|ipmi\_password|<|string|Senha para verificações IPMI.|
|templates|<| |Elemento raiz para templates vinculados.|
| |name|string|(obrigatório) Nome do template.|
|groups|<| |Elemento raiz para grupos de host aos quais o host pertence.|
| |name|string|(obrigatório) Nome do grupo de host.|
|interfaces|<| |Elemento raiz para [interfaces do host](#host-interfaces).|
|items|<| |Elemento raiz para [items do host](#host-items).|
|discovery_rules|<| |Elemento raiz para [regras de descoberta de baixo nível do host](#host-low-level-discovery-rules).|
|http_tests|<| |Elemento raiz para [cenários web do host](#host-web-scenarios).|
|tags|<| |Elemento raiz para tags do host.|
|<|tag|string|(obrigatório) Nome da tag.|
|^|value|string|Valor da tag.|
|macros|<| |Elemento raiz para macros do host.|
|<|macro|string|(obrigatório) Nome da macro de usuário.|
|^|type|string|Tipo da macro de usuário.<br>Valores possíveis:^[1](#footnotes)^ TEXT (0, padrão), SECRET\_TEXT (1), VAULT (2).|
|^|value|string|Valor da macro de usuário.|
|^|description|string|Descrição da macro de usuário.|
|inventory|<| |Elemento raiz para inventário do host.|
| |<inventory\_property>|string|Propriedade do inventário. Todas as propriedades têm seu respectivo elemento (`type`, `name`, `os`, etc.; por exemplo, veja [Formato de exportação](#export-format)).|
|inventory\_mode|<|string|Modo de inventário.<br>Valores possíveis:^[1](#footnotes)^ DISABLED (-1), MANUAL (0, padrão), AUTOMATIC (1).|
|valuemaps|<| |Elemento raiz para [value maps do host](#host-value-maps).|

::: noteclassic
Veja também: [Objeto Host](/manual/api/reference/host/object) (consulte a propriedade relevante com o nome correspondente).
:::

[comment]: # ({/0908afaa-eedfe2b9})

[comment]: # ({5f212fe4-c8da7bba})
#### Interfaces do host

|Element|<|Type|Description|
|-|---|---|-----------------------|
|default|<|string|Indica se esta é a interface principal do host. Observe que pode haver apenas uma interface principal de um tipo em um host.<br>Valores possíveis:^[1](#footnotes)^ NO (0), YES (1, default).|
|type|<|string|Tipo da interface.<br>Valores possíveis:^[1](#footnotes)^ ZABBIX (1, default), SNMP (2), IPMI (3), JMX (4).|
|useip|<|string|Indica se o IP deve ser usado como interface para conexão com o host (caso contrário, será usado DNS).<br>Valores possíveis:^[1](#footnotes)^ NO (0), YES (1, default).|
|ip|<|string|(obrigatório para conexões IP) Endereço IP (IPv4 ou IPv6).|
|dns|<|string|(obrigatório para conexões DNS) Nome DNS.|
|port|<|string|Número da porta.|
|details|<| |Elemento raiz para detalhes da interface.|
|<|version|string|Use esta versão do SNMP.<br>Valores possíveis:^[1](#footnotes)^ SNMPV1 (1), SNMP\_V2C (2, default), SNMP\_V3 (3).|
|^|community|string|(obrigatório para itens SNMPv1 e SNMPv2) Comunidade SNMP.|
|^|max_repetitions|string|Valor máximo de repetições para solicitações bulk nativas de SNMP (GetBulkRequest-PDUs).<br>Compatível com itens SNMPv2 e SNMPv3 (`discovery[]` e `walk[]`).<br>Padrão: 10.|
|^|contextname|string|Nome do contexto SNMPv3.<br>Compatível com itens SNMPv3.|
|^|securityname|string|Nome de segurança SNMPv3.<br>Compatível com itens SNMPv3.|
|^|securitylevel|string|Nível de segurança SNMPv3.<br>Compatível com itens SNMPv3.<br>Valores possíveis:^[1](#footnotes)^ NOAUTHNOPRIV (0, default), AUTHNOPRIV (1), AUTHPRIV (2).|
|^|authprotocol|string|Protocolo de autenticação SNMPv3.<br>Compatível com itens SNMPv3.<br>Valores possíveis:^[1](#footnotes)^ MD5 (0, default), SHA1 (1), SHA224 (2), SHA256 (3), SHA384 (4), SHA512 (5).|
|^|authpassphrase|string|Frase secreta de autenticação SNMPv3.<br>Compatível com itens SNMPv3.|
|^|privprotocol|string|Protocolo de privacidade SNMPv3.<br>Compatível com itens SNMPv3.<br>Valores possíveis:^[1](#footnotes)^ DES (0, default), AES128 (1), AES192 (2), AES256 (3), AES192C (4), AES256C (5).|
|^|privpassphrase|string|Frase secreta de privacidade SNMPv3.<br>Compatível com itens SNMPv3.|
|^|bulk|string|Usa solicitações bulk para SNMP.<br>Valores possíveis:^[1](#footnotes)^ NO (0), YES (1, default).|
|interface\_ref|<|string|Nome de referência da interface a ser usado em itens (formato: `if<N>`).|

::: noteclassic
Veja também: [Objeto de interface do host](/manual/api/reference/hostinterface/object) (consulte a propriedade relevante com o nome correspondente).
:::

[comment]: # ({/5f212fe4-c8da7bba})

[comment]: # ({11a71dce-8a2e4e2f})
#### Itens do host

|Element|<|Type|Description|
|-|---|---|-----------------------|
|name|<|string|(required) Nome do item.|
|type|<|string|Tipo do item.<br>Valores possíveis:^[1](#footnotes)^ ZABBIX\_PASSIVE (0, padrão), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX\_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), CALCULATED (15), JMX (16), SNMP\_TRAP (17), DEPENDENT (18), HTTP\_AGENT (19), SNMP\_AGENT (20), ITEM\_TYPE\_SCRIPT (21), ITEM\_TYPE\_BROWSER (22).|
|snmp\_oid|<|string|(required for SNMP\_AGENT items) ID do objeto SNMP.|
|key|<|string|(required) Chave do item.|
|delay|<|string|Intervalo de atualização do item.<br>Padrão: 1m. O valor será sempre 0 para itens TRAP.|
|history|<|string|Período de tempo (usando [sufixo de tempo](/manual/appendix/suffixes#time-suffixes), [macro de usuário](/manual/config/macros/user_macros) ou [macro LLD](/manual/config/macros/lld_macros)) durante o qual os dados de histórico devem ser armazenados.<br>Padrão: 31d.|
|trends|<|string|Período de tempo (usando [sufixo de tempo](/manual/appendix/suffixes#time-suffixes), [macro de usuário](/manual/config/macros/user_macros) ou [macro LLD](/manual/config/macros/lld_macros)) durante o qual os dados de tendências devem ser armazenados.<br>Padrão: 365d.|
|status|<|string|Status do item.<br>Valores possíveis:^[1](#footnotes)^ ENABLED (0, padrão), DISABLED (1).|
|value\_type|<|string|Tipo do valor recebido.<br>Valores possíveis:^[1](#footnotes)^ FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, padrão), TEXT (4), BINARY (5).|
|allowed\_hosts|<|string|Lista de endereços IP de hosts, separados por vírgulas, autorizados a enviar dados para o item.<br>Suportado para itens TRAP e HTTP\_AGENT.|
|units|<|string|Unidades do valor recebido (bps, B, etc.).|
|params|<|text|Parâmetros adicionais dependendo do tipo do item (script executado para itens SSH e TELNET; consulta SQL para itens ODBC; fórmula para itens CALCULATED; o script para itens ITEM\_TYPE\_SCRIPT e ITEM\_TYPE\_BROWSER).|
|ipmi\_sensor|<|string|Sensor IPMI.<br>Suportado para itens IPMI.|
|authtype|<|string|Tipo de autenticação.<br>Suportado para itens SSH e HTTP\_AGENT.<br>Valores possíveis para itens SSH:^[1](#footnotes)^ PASSWORD (0, padrão), PUBLIC\_KEY (1).<br>Valores possíveis para itens HTTP\_AGENT:^[1](#footnotes)^ NONE (0, padrão), BASIC (1), NTLM (2), Kerberos (3) ou Digest (4).|
|username|<|string|(required for SSH and TELNET items) Nome de usuário para autenticação.<br>Suportado para itens SIMPLE, ODBC, JMX e HTTP\_AGENT.<br>Quando usado para itens JMX, `password` (veja abaixo) também deve ser especificado ou ambos os elementos devem ser deixados em branco.|
|password|<|string|(required for SSH and TELNET items) Senha para autenticação.<br>Suportado para itens SIMPLE, ODBC, JMX e HTTP\_AGENT.<br>Quando usado para itens JMX, `username` (veja acima) também deve ser especificado ou ambos os elementos devem ser deixados em branco.|
|publickey|<|string|(required for SSH items) Nome do arquivo da chave pública.|
|privatekey|<|string|(required for SSH items) Nome do arquivo da chave privada.|
|description|<|text|Descrição do item.|
|inventory\_link|<|string|Campo de inventário do host preenchido pelo item.<br>Valores possíveis:^[1](#footnotes)^ NONE (0), ALIAS (4), etc. (consulte [Inventário do host](/manual/api/reference/host/object#host-inventory) para os campos suportados).|
|valuemap|<| |Elemento raiz para mapas de valor do item.|
| |name|string|(required) Nome do mapa de valor a ser usado para o item.|
|logtimefmt|<|string|Formato da hora nas entradas de log.<br>Suportado para itens do tipo de valor LOG.|
|preprocessing|<| |Elemento raiz para o pré-processamento de valores do item.|
| |step| |Elemento raiz para [etapas de pré-processamento de valores de itens do host](#host-item-value-preprocessing-steps).|
|interface\_ref|<|string|Referência à interface do host (formato: `if<N>`).|
|jmx\_endpoint|<|string|Endpoint JMX.<br>Suportado para itens JMX.|
|master_item|<| |(required for DEPENDENT items) Elemento raiz para o item mestre do item dependente.|
| |key|string|(required) Chave do item mestre do item dependente.|
|timeout|<|string|Tempo limite da solicitação de coleta de dados do item.<br>Suportado para a lista de tipos de item [Timeouts](/manual/web_interface/frontend_sections/administration/general#timeouts).|
|url|<|string|(required for HTTP\_AGENT items) String de URL.|
|query_fields|<| |Elemento raiz para parâmetros de consulta.<br>Suportado para itens HTTP\_AGENT.|
|<|name|string|(required for HTTP\_AGENT items) Nome do parâmetro de consulta.|
|^|value|string|Valor do parâmetro de consulta.<br>Suportado para itens HTTP\_AGENT.|
|parameters|<| |Elemento raiz para parâmetros definidos pelo usuário.<br>Suportado para itens ITEM\_TYPE\_SCRIPT e ITEM\_TYPE\_BROWSER.|
|<|name|string|(required for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items) Nome do parâmetro definido pelo usuário.|
|^|value|string|Valor do parâmetro definido pelo usuário.<br>Suportado para itens ITEM\_TYPE\_SCRIPT e ITEM\_TYPE\_BROWSER.|
|posts|<|string|Dados do corpo da solicitação HTTP(S).<br>Suportado para itens HTTP\_AGENT.|
|status\_codes|<|string|Intervalos de códigos de status HTTP obrigatórios, separados por vírgulas.<br>Suportado para itens HTTP\_AGENT.|
|follow\_redirects|<|string|Seguir redirecionamentos da resposta durante a coleta de dados.<br>Suportado para itens HTTP\_AGENT.<br>Valores possíveis:^[1](#footnotes)^ NO (0, padrão), YES (1).|
|post\_type|<|string|Tipo do corpo dos dados de postagem.<br>Suportado para itens HTTP\_AGENT.<br>Valores possíveis:^[1](#footnotes)^ RAW (0, padrão), JSON (2), XML (3).|
|http\_proxy|<|string|String de conexão do proxy HTTP(S).<br>Suportado para itens HTTP\_AGENT.|
|headers|<| |Elemento raiz para cabeçalhos da solicitação HTTP(S).<br>Suportado para itens HTTP\_AGENT.|
|<|name|string|(required for HTTP\_AGENT items) Nome do cabeçalho.|
|^|value|string|(required for HTTP\_AGENT items) Valor do cabeçalho.|
|retrieve\_mode|<|string|Qual parte da resposta deve ser armazenada.<br>Suportado para itens HTTP\_AGENT.<br>Valores possíveis:^[1](#footnotes)^ BODY (0, padrão), HEADERS (1), BOTH (2).|
|request\_method|<|string|Tipo do método da solicitação.<br>Suportado para itens HTTP\_AGENT.<br>Valores possíveis:^[1](#footnotes)^ GET (0, padrão), POST (1), PUT (2), HEAD (3).|
|output\_format|<|string|Como processar a resposta.<br>Suportado para itens HTTP\_AGENT.<br>Valores possíveis:^[1](#footnotes)^ RAW (0, padrão), JSON (1).|
|allow\_traps|<|string|Permitir preencher o valor de forma semelhante ao item trapper.<br>Suportado para itens HTTP\_AGENT.<br>Valores possíveis:^[1](#footnotes)^ NO (0, padrão), YES (1).|
|ssl\_cert\_file|<|string|Caminho do arquivo da chave SSL pública.<br>Suportado para itens HTTP\_AGENT.|
|ssl\_key\_file|<|string|Caminho do arquivo da chave SSL privada.<br>Suportado para itens HTTP\_AGENT.|
|ssl\_key\_password|<|string|Senha do arquivo da chave SSL.<br>Suportado para itens HTTP\_AGENT.|
|verify\_peer|<|string|Se deve validar se o certificado do host é autêntico.<br>Suportado para itens HTTP\_AGENT.<br>Valores possíveis:^[1](#footnotes)^ NO (0, padrão), YES (1).|
|verify\_host|<|string|Se deve validar se o nome do host para a conexão corresponde ao do certificado do host.<br>Suportado para itens HTTP\_AGENT.<br>Valores possíveis:^[1](#footnotes)^ NO (0, padrão), YES (1).|
|tags|<| |Elemento raiz para tags do item.|
|<|tag|string|(required) Nome da tag.|
|^|value|string|Valor da tag.|
|triggers|<| |Elemento raiz para [triggers de itens do host](#host-item-triggers).|

::: noteclassic
Veja também: [Objeto Item](/manual/api/reference/item/object) (consulte a propriedade relevante com o mesmo nome).
:::

[comment]: # ({/11a71dce-8a2e4e2f})

[comment]: # ({4928b4c6-f0f3fd08})
##### Etapas de pré-processamento do valor do item do host

|Element|<|Type|Description|
|-|---|---|-----------------------|
|type|<|string|(obrigatório) O tipo da etapa de pré-processamento do valor do item.<br>Valores possíveis:^[1](#footnotes)^ MULTIPLIER (1), RTRIM (2), LTRIM (3), TRIM (4), REGEX (5), BOOL\_TO\_DECIMAL (6), OCTAL\_TO\_DECIMAL (7), HEX\_TO\_DECIMAL (8), SIMPLE\_CHANGE (9, calculado: valor recebido - valor anterior), CHANGE\_PER\_SECOND (10, calculado: (valor recebido - valor anterior)/(tempo atual - tempo da última verificação)), XMLPATH (11), JSONPATH (12), IN\_RANGE (13), MATCHES\_REGEX (14), NOT\_MATCHES\_REGEX (15), CHECK\_JSON\_ERROR (16), CHECK\_XML\_ERROR (17), CHECK\_REGEX\_ERROR (18), DISCARD\_UNCHANGED (19), DISCARD\_UNCHANGED\_HEARTBEAT (20), JAVASCRIPT (21), PROMETHEUS\_PATTERN (22), PROMETHEUS\_TO\_JSON (23), CSV\_TO\_JSON (24), STR\_REPLACE (25), CHECK\_NOT\_SUPPORTED (26), XML\_TO\_JSON (27), SNMP\_WALK\_VALUE (28), SNMP\_WALK\_TO\_JSON (29), SNMP\_GET\_VALUE (30).|
|parameters|<| |(obrigatório) Elemento raiz para os parâmetros da etapa de pré-processamento do valor do item.|
| |parameter|string|Parâmetro individual da etapa de pré-processamento do valor do item.|
|error\_handler|<|string|Tipo de ação usado em caso de falha na etapa de pré-processamento.<br>Valores possíveis:^[1](#footnotes)^ ORIGINAL\_ERROR (0, padrão), DISCARD\_VALUE (1), CUSTOM\_VALUE (2), CUSTOM\_ERROR (3).|
|error\_handler\_params|<|string|Parâmetros do manipulador de erro.|

::: noteclassic
Veja também: [Objeto de pré-processamento do item](/manual/api/reference/item/object#item-preprocessing) (consulte a propriedade relevante com o nome correspondente).
:::

[comment]: # ({/4928b4c6-f0f3fd08})

[comment]: # ({6fddf74c-5ff5f79a})
##### Triggers de item do host

|Element|<|Type|Description|
|-|---|---|-----------------------|
|uuid|<|string|(required) Identificador único para este trigger.|
|expression|<|string|(required) Expressão do trigger.|
|recovery\_mode|<|string|Base para gerar eventos OK.<br>Valores possíveis:^[1](#footnotes)^ EXPRESSION (0, padrão), RECOVERY\_EXPRESSION (1), NONE (2).|
|recovery\_expression|<|string|Expressão de recuperação do trigger.|
|correlation\_mode|<|string|Modo de correlação (sem correlação de eventos ou correlação de eventos por tag).<br>Valores possíveis:^[1](#footnotes)^ DISABLED (0, padrão), TAG\_VALUE (1).|
|correlation\_tag|<|string|Nome da tag a ser usada para correlação de eventos.|
|name|<|string|(required) Nome do trigger.|
|event\_name|<|string|Nome do evento.|
|opdata|<|string|Dados operacionais.|
|url\_name|<|string|Rótulo para a URL associada ao trigger.|
|url|<|string|URL associada ao trigger.|
|status|<|string|Status do trigger.<br>Valores possíveis:^[1](#footnotes)^ ENABLED (0, padrão), DISABLED (1).|
|priority|<|string|Severidade do trigger.<br>Valores possíveis:^[1](#footnotes)^ NOT\_CLASSIFIED (0, padrão), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5).|
|description|<|text|Descrição do trigger.|
|type|<|string|Tipo de geração de evento (evento de problema único ou múltiplos eventos de problema).<br>Valores possíveis:^[1](#footnotes)^ SINGLE (0, padrão), MULTIPLE (1).|
|manual\_close|<|string|Fechamento manual de eventos de problema.<br>Valores possíveis:^[1](#footnotes)^ NO (0, padrão), YES (1).|
|dependencies|<| |Elemento raiz para dependências.|
|<|name|string|(required) Nome do trigger de dependência.|
|^|expression|string|(required) Expressão do trigger de dependência.|
|^|recovery\_expression|string|Expressão de recuperação do trigger de dependência.|
|tags|<| |Elemento raiz para tags do trigger.|
|<|tag|string|(required) Nome da tag.|
|^|value|string|Valor da tag.|

::: noteclassic
Veja também: [Objeto Trigger](/manual/api/reference/trigger/object) (consulte a propriedade relevante com o nome correspondente).
:::

[comment]: # ({/6fddf74c-5ff5f79a})

[comment]: # ({df622d27-19e8eae6})
#### Regras de descoberta em baixo nível de host

::: noteimportant
A maioria dos elementos das regras de descoberta em baixo nível de host é a mesma que a dos [itens de host](#host-items).
A tabela abaixo descreve os elementos que diferem dos itens de host.
:::

|Element|<|Type|Description|
|-|---|---|-----------------------|
|type|<|string|Tipo de item.<br>Valores possíveis:^[1](#footnotes)^ ZABBIX\_PASSIVE (0, padrão), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX\_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), JMX (16), DEPENDENT (18), HTTP\_AGENT (19), SNMP\_AGENT (20), ITEM\_TYPE\_SCRIPT (21), ITEM\_TYPE\_BROWSER (22).|
|key|<|string|(obrigatório) A chave da regra de descoberta em baixo nível.|
|filter|<| |Elemento raiz para [filtros de regras de descoberta em baixo nível de host](#host-low-level-discovery-rule-filters).|
|lifetime|<|string|Período de tempo (usando segundos, [sufixo de tempo](/manual/appendix/suffixes#time-suffixes) ou [macro de usuário](/manual/config/macros/user_macros)), após o qual os recursos descobertos que não existirem mais serão excluídos.<br>Padrão: 7d.|
|lifetime_type|<|string|Cenário para excluir recursos LLD perdidos.<br>Valores possíveis: DELETE\_NEVER, DELETE\_IMMEDIATELY, DELETE\_AFTER.|
|enabled_lifetime|<|string|Período de tempo (usando segundos, [sufixo de tempo](/manual/appendix/suffixes#time-suffixes) ou [macro de usuário](/manual/config/macros/user_macros)), após o qual os recursos descobertos que não existirem mais serão desabilitados.|
|enabled_lifetime_type|<|string|Cenário para desabilitar recursos LLD perdidos.<br>Valores possíveis: DISABLE\_NEVER, DISABLE\_IMMEDIATELY, DISABLE\_AFTER.|
|item\_prototypes|<| |Elemento raiz para elementos de protótipo de item de host, que são os mesmos que os de [itens de host](#host-items).|
|trigger\_prototypes|<| |Elemento raiz para elementos de protótipo de trigger de host, que são os mesmos que os de [triggers de item de host](#host-item-triggers).|
|graph\_prototypes|<| |Elemento raiz para protótipos de gráfico de host, que são os mesmos que os de [gráficos de host](#host-graphs).|
|host\_prototypes|<| |Elemento raiz para protótipos de host, que são os mesmos que os de [hosts](#hosts).|
|master_item|<|string|(obrigatório para regras DEPENDENT) Elemento raiz para o item mestre da regra dependente.|
|lld\_macro\_paths|<| |Elemento raiz para caminhos de macro da regra de descoberta em baixo nível.|
|<|lld\_macro|string|(obrigatório) Nome da macro da regra de descoberta em baixo nível.|
|^|path|string|(obrigatório) Seletor do valor que será atribuído à macro correspondente.|
|preprocessing|<| |Elemento raiz para o pré-processamento do valor da regra de descoberta em baixo nível.|
| |step| |Elemento raiz para os elementos de etapa de pré-processamento do valor da regra de descoberta em baixo nível, que são os mesmos que os de [etapas de pré-processamento do valor do item de host](#host-item-preprocessing-steps), exceto por haver menos valores possíveis. Veja também: [objeto de pré-processamento da regra LLD](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing).|
|overrides|<| |Elemento raiz para regras de substituição da regra de descoberta em baixo nível.|
|<|name|string|(obrigatório) Nome exclusivo da substituição.|
|^|step|string|(obrigatório) Número de ordem exclusivo da substituição.|
|^|stop|string|Interrompe o processamento das próximas substituições se corresponder.|
|^|filter| |Elemento raiz para elementos de filtro da regra de substituição da regra de descoberta em baixo nível, que são os mesmos que os de [filtros de regras de descoberta em baixo nível de host](#host-low-level-discovery-rule-filters).|
|^|operations| |Elemento raiz para [operações de substituição da regra de descoberta em baixo nível de host](#host-low-level-discovery-rule-override-operations).|

::: noteclassic
Veja também: [objeto da regra LLD](/manual/api/reference/discoveryrule/object) (consulte a propriedade relevante com o nome correspondente).
:::

[comment]: # ({/df622d27-19e8eae6})

[comment]: # ({0d030aaa-a75b2d66})
##### Filtros da regra de descoberta de baixo nível do host

|Element|<|Type|Description|
|-|---|---|-----------------------|
|evaltype|<|string|Substitui o método de avaliação da condição do filtro.<br>Valores possíveis:^[1](#footnotes)^ AND\_OR (0, padrão), AND (1), OR (2), FORMULA (3).|
|formula|<|string|Fórmula de cálculo personalizada para as condições do filtro.|
|conditions|<| |Elemento raiz para as condições do filtro.|
|<|macro|string|(obrigatório) O nome da macro de descoberta de baixo nível na qual realizar a verificação.|
|^|value|string|Valor com o qual comparar.|
|^|operator|string|Operador da condição.<br>Valores possíveis:^[1](#footnotes)^ MATCHES\_REGEX (8, padrão), NOT\_MATCHES\_REGEX (9).|
|^|formulaid|string|(obrigatório) ID exclusivo arbitrário usado para referenciar uma condição a partir da expressão personalizada. Pode conter apenas letras maiúsculas. O ID deve ser definido pelo usuário ao modificar as condições do filtro, mas será gerado novamente ao solicitá-las depois.|

::: noteclassic
Veja também: [objeto de filtro da regra LLD](/manual/api/reference/discoveryrule/object#lld-rule-filter) (consulte a propriedade relevante com o nome correspondente).
:::

[comment]: # ({/0d030aaa-a75b2d66})

[comment]: # ({f62c5cea-77148deb})
##### Operações de substituição da regra de descoberta em baixo nível de host

|Element|<|Type|Description|
|-|---|---|-----------------------|
|operationobject|<|string|Objeto ao qual a operação é aplicada.<br>Valores possíveis:^[1](#footnotes)^ ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3).|
|operator|<|string|Operador da condição de substituição.<br>Valores possíveis:^[1](#footnotes)^ EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6).|
|value|<|string|Uma expressão regular ou uma string para o operador da condição de substituição.|
|status|<|string|Status do objeto após a operação de substituição.|
|discover|<|string|Se o objeto é adicionado como resultado da descoberta.|
|delay|<|string|Intervalo de atualização definido para o item prototype após a operação de substituição.|
|history|<|string|Período de armazenamento do histórico definido para o item prototype após a operação de substituição.|
|trends|<|string|Período de armazenamento de tendências definido para o item prototype após a operação de substituição.|
|severity|<|string|Severidade do trigger prototype definida após a operação de substituição.|
|tags|<| |Elemento raiz para as tags definidas para o objeto após a operação de substituição.|
|<|tag|string|(obrigatório) Nome da tag.|
|^|value|string|Valor da tag.|
|templates|<| |Elemento raiz para os templates vinculados ao host prototype após a operação de substituição.|
| |name|string|(obrigatório) Nome do template.|
|inventory_mode|<|string|Modo de inventário do host prototype definido após a operação de substituição.|

::: noteclassic
Veja também: [Objeto da operação de substituição da regra LLD](/manual/api/reference/discoveryrule/object#lld-rule-override-operation) (consulte a propriedade correspondente com o mesmo nome).
:::

[comment]: # ({/f62c5cea-77148deb})

[comment]: # ({776aa762-cae5eb15})
#### Cenários web do host

|Elemento|<|Tipo|Descrição|
|-|---|---|-----------------------|
|uuid|<|string|(obrigatório) Identificador exclusivo para este cenário web.|
|name|<|string|(obrigatório) Nome do cenário web.|
|delay|<|string|Frequência (usando segundos, [sufixo de tempo](/manual/appendix/suffixes#time-suffixes) ou [macro de usuário](/manual/config/macros/user_macros)) de execução do cenário web.<br>Padrão: 1m.|
|attempts|<|integer|O número de tentativas para executar as etapas do cenário web.<br>Valores possíveis: 1-10 (padrão: 1).|
|agent|<|string|Agent do cliente. O Zabbix irá simular ser o navegador selecionado.<br>Isso é útil quando um site retorna conteúdo diferente para navegadores diferentes.<br>Padrão: Zabbix.|
|http\_proxy|<|string|Proxy que será usado pelo cenário web fornecido como: `http://[username[:password]@]proxy.example.com[:port]`|
|variables|<| |Elemento raiz para variáveis do cenário web que podem ser usadas nas etapas do cenário.|
|<|name|string|(obrigatório) Nome da variável.|
|^|value|text|(obrigatório) Valor da variável.|
|headers|<| |Elemento raiz para cabeçalhos HTTP a serem enviados ao realizar uma solicitação.<br>Os cabeçalhos devem ser listados usando a mesma sintaxe que apareceriam no protocolo HTTP.|
|<|name|string|(obrigatório) Nome do cabeçalho.|
|^|value|text|(obrigatório) Valor do cabeçalho.|
|status|<|string|Status do cenário web.<br>Valores possíveis:^[1](#footnotes)^ ENABLED (0, padrão), DISABLED (1).|
|authentication|<|string|Método de autenticação.<br>Valores possíveis:^[1](#footnotes)^ NONE (0, padrão), BASIC (1), NTLM (2), Kerberos (3) ou Digest (4).|
|http\_user|<|string|Nome de usuário usado para autenticação BASIC (HTTP), NTLM, Kerberos ou Digest.|
|http\_password|<|string|Senha usada para autenticação BASIC (HTTP), NTLM, Kerberos ou Digest.|
|verify\_peer|<|string|Verifica o certificado SSL do servidor web.<br>Valores possíveis:^[1](#footnotes)^ NO (0, padrão), YES (1).|
|verify\_host|<|string|Verifica se o campo *Common Name* ou o campo *Subject Alternate Name* do certificado do servidor web corresponde.<br>Valores possíveis:^[1](#footnotes)^ NO (0, padrão), YES (1).|
|ssl\_cert\_file|<|string|Nome do arquivo de certificado SSL usado para autenticação do cliente (deve estar no formato PEM).|
|ssl\_key\_file|<|string|Nome do arquivo de chave privada SSL usado para autenticação do cliente (deve estar no formato PEM).|
|ssl\_key\_password|<|string|Senha do arquivo de chave privada SSL.|
|steps|<| |(obrigatório) Elemento raiz para [etapas do cenário web do host](#host-web-scenario-steps).|
|tags|<| |Elemento raiz para tags do cenário web.|
|<|tag|string|(obrigatório) Nome da tag.|
|^|value|string|Valor da tag.|

::: noteclassic
Veja também: [Objeto de cenário web](/manual/api/reference/httptest/object) (consulte a propriedade relevante com o nome correspondente).
:::

[comment]: # ({/776aa762-cae5eb15})

[comment]: # ({2818e5c8-3645afb3})
##### Etapas do cenário web do host

|Elemento|<|Tipo|Descrição|
|-|---|---|-----------------------|
|name|<|string|(obrigatório) Nome da etapa do cenário web.|
|url|<|string|(obrigatório) URL para monitoramento.|
|query\_fields|<| |Elemento raiz para parâmetros de consulta (um array de campos HTTP a serem adicionados à URL ao executar uma solicitação).|
|<|name|string|(obrigatório) Nome do parâmetro de consulta.|
|^|value|string|Valor do parâmetro de consulta.|
|posts|<| |Elemento raiz para variáveis HTTP POST (uma string (dados brutos do post) ou um array de campos HTTP (dados de campo de formulário)).|
|<|name|string|(obrigatório) Nome do campo post.|
|^|value|string|(obrigatório) Valor do campo post.|
|variables|<| |Elemento raiz das variáveis em nível de etapa (macros) que devem ser aplicadas após esta etapa.<br>Se o valor da variável tiver o prefixo 'regex:', então seu valor será extraído dos dados retornados por esta etapa de acordo com o padrão de expressão regular após o prefixo 'regex:'|
|<|name|string|(obrigatório) Nome da variável.|
|^|value|text|(obrigatório) Valor da variável.|
|headers|<| |Elemento raiz para cabeçalhos HTTP a serem enviados ao executar uma solicitação.|
|<|name|string|(obrigatório) Nome do cabeçalho.|
|^|value|text|(obrigatório) Valor do cabeçalho.|
|follow\_redirects|<|string|Seguir redirecionamentos HTTP.<br>Valores possíveis:^[1](#footnotes)^ NÃO (0), SIM (1, padrão).|
|retrieve\_mode|<|string|Modo de obtenção da resposta HTTP.<br>Valores possíveis:^[1](#footnotes)^ BODY (0, padrão), HEADERS (1), BOTH (2).|
|timeout|<|string|Timeout (em segundos, [sufixo de tempo](/manual/appendix/suffixes#time-suffixes) ou [macro de usuário](/manual/config/macros/user_macros)) da execução da etapa.<br>Padrão: 15s.|
|required|<|string|Texto que deve estar presente na resposta (ignorado se vazio).|
|status\_codes|<|string|Uma lista separada por vírgulas de códigos de status HTTP aceitos (por exemplo, `200-201,210-299`; ignorado se vazio).|

::: noteclassic
Veja também: [Objeto de etapa de cenário web](/manual/api/reference/httptest/object#scenario-step) (consulte a propriedade relevante com o nome correspondente).
:::

[comment]: # ({/2818e5c8-3645afb3})

[comment]: # ({eefa7133-0a8a430a})
#### Gráficos do host

|Element|<|Type|Description|
|-|---|---|-----------------------|
|uuid|<|string|Identificador único do gráfico.|
|name|<|string|(obrigatório) Nome do gráfico.|
|width|<|integer|Largura do gráfico, em pixels.<br>Usado para visualização prévia e para gráficos de pizza/explodidos.<br>Valores possíveis:^[1](#footnotes)^ 20-65535 (padrão: 900).|
|height|<|integer|Altura do gráfico, em pixels.<br>Usado para visualização prévia e para gráficos de pizza/explodidos.<br>Valores possíveis:^[1](#footnotes)^ 20-65535 (padrão: 900).|
|yaxismin|<|double|Valor mínimo do eixo Y.<br>Suportado para o valor mínimo FIXED do eixo Y.<br>Padrão: 0.|
|yaxismax|<|double|Valor máximo do eixo Y.<br>Suportado para o valor mínimo FIXED do eixo X.<br>Padrão: 0.|
|show\_work\_period|<|string|Destacar horas não úteis.<br>Suportado para gráficos NORMAL e STACKED.<br>Valores possíveis:^[1](#footnotes)^ NO (0), YES (1, padrão).|
|show\_triggers|<|string|Exibir valores simples de trigger como uma linha.<br>Suportado para gráficos NORMAL e STACKED.<br>Valores possíveis:^[1](#footnotes)^ NO (0), YES (1, padrão).|
|type|<|string|Tipo de gráfico.<br>Valores possíveis:^[1](#footnotes)^ NORMAL (0, padrão), STACKED (1), PIE (2), EXPLODED (3).|
|show\_legend|<|string|Exibir legenda do gráfico.<br>Valores possíveis:^[1](#footnotes)^ NO (0), YES (1, padrão).|
|show\_3d|<|string|Ativar estilo 3D.<br>Suportado para gráficos NORMAL e STACKED.<br>Valores possíveis:^[1](#footnotes)^ NO (0, padrão), YES (1).|
|percent\_left|<|double|Exibir a linha de percentil para o eixo esquerdo.<br>Suportado para gráficos NORMAL.<br>Padrão: 0.|
|percent\_right|<|double|Exibir a linha de percentil para o eixo direito.<br>Suportado para gráficos NORMAL.<br>Padrão: 0.|
|ymin\_type\_1|<|string|Valor mínimo do eixo Y.<br>Suportado para gráficos NORMAL e STACKED.<br>Valores possíveis:^[1](#footnotes)^ CALCULATED (0, padrão), FIXED (1), ITEM (2).|
|ymin\_item\_1|<| |(obrigatório se `ymin_type_1` estiver definido como `ITEM`) Elemento raiz para detalhes individuais do item.|
|<|host|string|(obrigatório) Host do item.|
|^|key|string|(obrigatório) Chave do item.|
|ymax\_type\_1|<|string|Valor máximo do eixo Y.<br>Suportado para gráficos NORMAL e STACKED.<br>Valores possíveis:^[1](#footnotes)^ CALCULATED (0, padrão), FIXED (1), ITEM (2).|
|ymax\_item\_1|<| |(obrigatório se `ymax_type_1` estiver definido como `ITEM`) Elemento raiz para detalhes individuais do item.|
|<|host|string|(obrigatório) Host do item.|
|^|key|string|(obrigatório) Chave do item.|
|graph\_items|<| |(obrigatório) Elemento raiz para [itens de gráfico do host](#host-graph-items).|

::: noteclassic
Veja também: [Objeto Graph](/manual/api/reference/graph/object) (consulte a propriedade relevante com o nome correspondente).
:::

[comment]: # ({/eefa7133-0a8a430a})

[comment]: # ({7b0dd7dd-21ce205d})
##### Itens do gráfico do host

|Element|<|Type|Description|
|-|---|---|-----------------------|
|sortorder|<|integer|Ordem de desenho. O valor menor é desenhado primeiro. Pode ser usado para desenhar linhas ou regiões atrás (ou na frente) de outra.|
|drawtype|<|string|Estilo de desenho do item do gráfico.<br>Suportado para gráficos NORMAL.<br>Valores possíveis:^[1](#footnotes)^ SINGLE\_LINE (0, padrão), FILLED\_REGION (1), BOLD\_LINE (2), DOTTED\_LINE (3), DASHED\_LINE (4), GRADIENT\_LINE (5).|
|color|<|string|Cor do elemento (6 símbolos, hexadecimal).|
|yaxisside|<|string|Lado do gráfico onde a escala Y do item do gráfico será desenhada.<br>Suportado para gráficos NORMAL e STACKED.|<br>Valores possíveis:^[1](#footnotes)^ LEFT (0, padrão), RIGHT (1).|
|calc\_fnc|<|string|Dados a serem desenhados se existir mais de um valor para um item.<br>Valores possíveis:^[1](#footnotes)^ MIN (1), AVG (2, padrão), MAX (4), ALL (7; mínimo, média e máximo; suportado para gráficos simples), LAST (9, suportado para gráficos de pizza/explodidos).|
|type|<|string|Tipo do item do gráfico.<br>Valores possíveis:^[1](#footnotes)^ SIMPLE (0, padrão), GRAPH\_SUM (2; o valor do item representa a pizza inteira; suportado para gráficos de pizza/explodidos).|
|item|<| |(obrigatório) Item individual.|
|<|host|string|(obrigatório) Host do item.|
|^|key|string|(obrigatório) Chave do item.|

::: noteclassic
Veja também: [Objeto graph item](/manual/api/reference/graphitem/object) (consulte a propriedade relevante com o nome correspondente).
:::

[comment]: # ({/7b0dd7dd-21ce205d})

[comment]: # ({33208c4a-216805df})
#### Mapas de valores do host

|Element|<|Type|Description|
|-|---|---|-----------------------|
|uuid|<|string|(obrigatório) Identificador exclusivo para este mapa de valores.|
|name|<|string|(obrigatório) Nome do mapa de valores.|
|mapping|<| |Elemento raiz para mapeamentos.|
|<|type|string|Tipo de correspondência do mapeamento.<br>Valores possíveis:^[1](#footnotes)^ EQUAL (0, padrão), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).|
|^|value|string|Valor original.|
|^|newvalue|string|(obrigatório) Valor para o qual o valor original é mapeado.|

[comment]: # ({/33208c4a-216805df})

[comment]: # ({8a9ebde1-869bd76e})
## Notas de rodapé

^1^ Os valores inteiros da API entre parênteses, por exemplo, ENABLED (0), são mencionados apenas para referência.
Para obter mais informações, consulte a página do objeto da API vinculada na entrada da tabela ou no final de cada seção.

[comment]: # ({/8a9ebde1-869bd76e})