en-us	#### Overview  Zabbix strives to provide a growing list of useful out-of-the-box [templates](/manual/config/templates). Out-of-the-box templates come preconfigured and thus are a useful way for speeding up the deployment of monitoring jobs.  The templates are available:  -   In new installations - in *Configuration* → *Templates*; -   If you are upgrading from previous versions, you can find these     templates in the `templates` directory of the downloaded latest     Zabbix version. While in *Configuration* → *Templates* you can     import them manually from this directory. -   It is also possible to download the template from [Zabbix git     repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates)     directly (make sure the template is compatible with your Zabbix     version).  Please use the sidebar to access information about specific template types and operation requirements.  See also:  -   [Template import](/manual/xml_export_import/templates#importing) -   [Linking a     template](/manual/config/templates/linking#linking_a_template)
pt-br	#### Visão geral  O Zabbix se esforça para fornecer uma lista crescente de ferramentas úteis prontas para uso [modelos](/manual/config/templates). Os modelos prontos para uso vêm pré-configurados e, portanto, são uma maneira útil de acelerar a implantação de monitoramento de trabalhos.  Os moldes estão disponíveis:  - Em novas instalações - em *Configuração* → *Modelos*; - Se você estiver atualizando de versões anteriores, poderá encontrar esses     templates no diretório `templates` do último download     Versão Zabbix. Enquanto estiver em *Configuração* → *Modelos* você pode     importe-os manualmente deste diretório. - Também é possível baixar o template do [Zabbix git     repositório](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates)     diretamente (certifique-se de que o template é compatível com seu Zabbix     versão).  Por favor, use a barra lateral para acessar informações sobre um modelo específico tipos e requisitos de operação.  Veja também:  - [Importação de modelo](/manual/xml_export_import/templates#importing) - [Ligar um     template](/manual/config/templates/linking#linking_a_template)

en-us	#### Overview  Zabbix supports a number of built-in macros which may be used in various situations. These macros are variables, identified by a specific syntax:      {MACRO}   Macros resolve to a specific value depending on the context.  Effective use of macros allows to save time and make Zabbix configuration more transparent.  In one of typical uses, a macro may be used in a template. Thus a trigger on a template may be named "Processor load is too high on {HOST.NAME}". When the template is applied to the host, such as Zabbix server, the name will resolve to "Processor load is too high on Zabbix server" when the trigger is displayed in the Monitoring section.  Macros may be used in item key parameters. A macro may be used for only a part of the parameter, for example `item.key[server_{HOST.HOST}_local]`. Double-quoting the parameter is not necessary as Zabbix will take care of any ambiguous special symbols, if present in the resolved macro.  Besides built-in macros Zabbix also supports user-defined macros, user-defined macros with context and macros for low-level discovery.  See also:  -   full list of [built-in     macros](/manual/appendix/macros/supported_by_location) -   macro [functions](/manual/config/macros/macro_functions) -   [user macros](/manual/config/macros/user_macros) -   [user macros with     context](/manual/config/macros/user_macros_context) -   [low-level discovery macros](/manual/config/macros/lld_macros)
pt-br	#### Visão geral  O Zabbix suporta uma série de macros embutidas que podem ser usadas em vários situações. Essas macros são variáveis, identificadas por uma sintaxe específica:      {MACRO}  As macros resolvem para um valor específico dependendo do contexto.  O uso eficaz de macros permite economizar tempo e tornar o Zabbix configuração mais transparente.  Em um dos usos típicos, uma macro pode ser usada em um modelo. Assim um gatilho em um modelo pode ser chamado de "A carga do processador está muito alta no {HOST.NAME}". Quando o modelo é aplicado ao host, como Zabbix servidor, o nome será resolvido para "A carga do processador está muito alta no Zabbix server" quando o gatilho é exibido na seção Monitoring.  As macros podem ser usadas nos parâmetros-chave do item. Uma macro pode ser usada apenas para uma parte do parâmetro, por exemplo `item.key[server_{HOST.HOST}_local]`. A citação dupla do parâmetro é não é necessário, pois o Zabbix cuidará de quaisquer símbolos especiais ambíguos, se presente na macro resolvida.  Além de macros embutidas, o Zabbix também suporta macros definidas pelo usuário, macros definidas pelo usuário com contexto e macros para descoberta de baixo nível.  Veja também:  - lista completa de [incorporado     macros](/manual/appendix/macros/supported_by_location) - macro [funções](/manual/config/macros/macro_functions) - [macros do usuário](/manual/config/macros/user_macros) - [macros de usuário com     context](/manual/config/macros/user_macros_context) - [macros de descoberta de baixo nível](/manual/config/macros/lld_macros)

en-us	#### Overview  Zabbix supports encrypted communications between Zabbix components using Transport Layer Security (TLS) protocol v.1.2 and 1.3 (depending on the crypto library). Certificate-based and pre-shared key-based encryption is supported.  Encryption can be configured for connections:  -   Between Zabbix server, Zabbix proxy, Zabbix agent, zabbix\_sender     and zabbix\_get utilities -   To Zabbix database [from Zabbix frontend and     server/proxy](/manual/appendix/install/db_encrypt)  Encryption is optional and configurable for individual components:  -   Some proxies and agents can be configured to use certificate-based     encryption with the server, while others can use pre-shared     key-based encryption, and yet others continue with unencrypted     communications (as before) -   Server (proxy) can use different encryption configurations for     different hosts  Zabbix daemon programs use one listening port for encrypted and unencrypted incoming connections. Adding an encryption does not require opening new ports on firewalls.
pt-br	#### Visão geral  Zabbix suporta comunicações criptografadas entre componentes Zabbix usando Protocolo Transport Layer Security (TLS) v.1.2 e 1.3 (dependendo do biblioteca de criptografia). Criptografia baseada em certificado e baseada em chave pré-compartilhada é suportado.  A criptografia pode ser configurada para conexões:  - Entre servidor Zabbix, proxy Zabbix, agente Zabbix, zabbix\_sender     e utilitários zabbix\_get - Para o banco de dados Zabbix [do frontend Zabbix e     servidor/proxy](/manual/appendix/install/db_encrypt)  A criptografia é opcional e configurável para componentes individuais:  - Alguns proxies e agentes podem ser configurados para usar certificados     criptografia com o servidor, enquanto outros podem usar     criptografia baseada em chave, e ainda outros continuam com não criptografado     comunicações (como antes) - Servidor (proxy) pode usar diferentes configurações de criptografia para     diferentes anfitriões  Os programas daemon Zabbix usam uma porta de escuta para conexões de entrada não criptografadas. Adicionar uma criptografia não requer abrindo novas portas em firewalls.

en-us	#### Overview  Zabbix supports TimescaleDB, a PostgreSQL-based database solution of automatically partitioning data into time-based chunks to support faster performance at scale.  ::: notewarning Currently TimescaleDB is not supported by Zabbix proxy. :::  Instructions on this page can be used for creating TimescaleDB database or migrating from existing PostgreSQL tables to TimescaleDB.
pt-br	#### Visão geral  O Zabbix suporta TimescaleDB, uma solução de banco de dados baseada em PostgreSQL de particionando automaticamente os dados em pedaços baseados em tempo para oferecer suporte mais rápido desempenho em escala.  ::: aviso Atualmente TimescaleDB não é suportado pelo Zabbix procurador. :::  As instruções nesta página podem ser usadas para criar o banco de dados TimescaleDB ou migrando de tabelas PostgreSQL existentes para TimescaleDB.

en-us	#### Overview  [zabbix_utils](https://github.com/zabbix/python-zabbix-utils/blob/main/README.md) is a Python library for:  -  working with Zabbix API; -  acting like Zabbix sender; -  acting like Zabbix get.  It is supported for Zabbix 5.0, 6.0, 6.4 and later.
pt-br	#### Visão geral  O [zabbix_utils](https://github.com/zabbix/python-zabbix-utils/blob/main/README.md) é uma biblioteca de Python para:   -  trabalhar com a API do Zabbix; -  agir como um remetente do Zabbix; -  agir como um  receptor do Zabbix .  É suportado para Zabbix 5.0, 6.0, 6.4 e versões posteriores.

en-us	#### Overview  Zabbix web frontend can be temporarily disabled in order to prohibit access to it. This can be useful for protecting the Zabbix database from any changes initiated by users, thus protecting the integrity of database.  Zabbix database can be stopped and maintenance tasks can be performed while Zabbix frontend is in maintenance mode.  Users from defined IP addresses will be able to work with the frontend normally during maintenance mode.
pt-br	#### Visão geral  A interface web do Zabbix pode ser temporariamente desativada para bloquear o acesso a ela. Isso pode ser muito útil para evitar que o banco de dados de configuração do Zabbix seja alterado por seus usuários, protegendo a integridade do banco.  O banco de dados do Zabbix pode ser parado durante as tarefas de manutenção enquanto a interface web está em modo de manutenção.  Apenas usuários de determinados IPs pré-definidos conseguirão utilizar a interface web durante o modo de manutenção.

en-us	#### Overview  Zabbix Windows agent can be installed from Windows MSI installer packages (32-bit or 64-bit) available for [download](https://www.zabbix.com/download_agents#tab:44).  The minimum requirement for a Zabbix agent 2 MSI installation is Windows 10 32-bit/Server 2016.  The Zabbix get and sender utilities can also be installed, either together with Zabbix agent/agent 2 or separately.  A 32-bit package cannot be installed on a 64-bit Windows.  All packages come with TLS support, however, configuring TLS is optional.  Both UI and command-line based installation is supported.  ::: noteclassic Although Zabbix installation from MSI installer packages is fully supported, it is recommended to install at least *Microsoft .NET Framework 2* for proper error handling. See [Microsoft Download .NET Framework](https://dotnet.microsoft.com/en-us/download/dotnet-framework). :::  ::: noteimportant It is recommended to use default paths provided by the installer as using custom paths without proper permissions could compromise the security of the installation. :::
pt-br	#### Visão Geral  O agente do Zabbix para Windows pode ser instalado a partir dos pacotes de instalador MSI do Windows (32 bits ou 64 bits) disponíveis para [download](https://www.zabbix.com/download_agents#tab:44).  O requisito mínimo para a instalação do MSI do agente Zabbix 2 é o Windows 10 32 bits/Servidor 2016.  As utilidades Zabbix get e sender também podem ser instaladas, seja junto com o Zabbix agent/agent 2  ou separadamente.  Um pacote de 32 bits não pode ser instalado em um Windows de 64 bits.  Todos os pacotes vêm com suporte TLS, no entanto, configurar o TLS é opcional.  Tanto a instalação baseada em interface de usuário quanto a baseada em linha de comando são suportadas.  ::: noteclassic Embora a instalação do Zabbix a partir dos pacotes de instalador MSI seja totalmente suportada, é recomendável instalar pelo menos o _Microsoft .NET Framework 2_ para um tratamento adequado de erros. Consulte [Microsoft Download .NET Framework](https://dotnet.microsoft.com/en-us/download/dotnet-framework). :::  ::: noteimportant É recomendável usar os caminhos padrão fornecidos pelo instalador, pois o uso de caminhos personalizados sem as permissões adequadas pode comprometer a segurança da instalação. :::

en-us	### Packages  SQL scripts have been moved from the `/usr/share/doc` directory to `/usr/share` in Zabbix packages.
pt-br	### Pacotes  Os scripts  SQL foram movidos do diretório  `/usr/share/doc` para `/usr/share` nos pacotes Zabbix.

en-us	 ##### Parameter priority  *Since version 6.0.18*, Zabbix agent 2 plugins search for connection-related parameter values in the following order:   ![](../../../assets/en/diagrams/agent2_parameters.png)  1. The first item key parameter is compared to session names. If no match is found it is treated as an actual value; in this case, step 3 will be skipped. If a match is found, the parameter value (usually, a URI) must be defined in the named session. 2. Other parameters will be taken from the item key if defined. 3. If an item key parameter (for example, password) is empty, plugin will look for the corresponding named session parameter. 4. If the session parameter is also not specified, the value defined in the corresponding [default parameter](#default-values) will be used. 5. If all else fails, the plugin will use the hardcoded default value.
pt-br	##### Prioridade de parâmetro  *Desde a versão 6.0.18*, os plugins do Zabbix agent 2 procuram por valores de parâmetros relacionados à conexão na seguinte ordem:  ![](../../../assets/en/diagrams/agent2_parameters.png)  1. O primeiro parâmetro da chave do item é comparado com os nomes das sessões. Se nenhuma correspondência for encontrada, ele será tratado como um valor real; neste caso, a etapa 3 será ignorada. Se uma correspondência for encontrada, o valor do parâmetro (geralmente, um URI) deve ser definido na sessão nomeada. 2. Outros parâmetros serão retirados da chave do item se estiverem definidos. 3. Se um parâmetro da chave do item (por exemplo, senha) estiver vazio, o plugin procurará pelo parâmetro de sessão nomeada correspondente. 4. Se o parâmetro da sessão também não estiver especificado, o valor definido no parâmetro padrão correspondente [default parameter](#default-values) será usado. 5. Se tudo falhar, o plugin usará o valor padrão codificado.

en-us	### Parameters  `(array)` IDs of hosts to delete.
pt-br	### Parâmetros  `(array)` IDs de hosts a serem excluídos.

en-us	### Parameters  `(array)` IDs of items to clear.
pt-br	### Parâmetros  `(array)` IDs de itens a serem limpos.

en-us	### Parameters  `(array)` IDs of proxies to delete.
pt-br	### Parâmetros  `(array)` IDs de proxies a serem excluídos.

en-us	### Parameters  `(array)` IDs of the actions to delete.
pt-br	### Parâmetros  `(array)` IDs das ações a serem excluídas.

en-us	### Parameters  `(array)` IDs of the correlations to delete.
pt-br	### Parâmetros  `(array)` IDs das correlações a serem excluídas.

en-us	### Parameters  `(array)` IDs of the dashboards to delete.
pt-br	### Parâmetros  `(array)` IDs dos painéis a serem excluídos.

en-us	### Parameters  `(array)` IDs of the discovery rules to delete.
pt-br	### Parâmetros  `(array)` IDs das regras de descoberta a serem excluídas.

en-us	### Parameters  `(array)` IDs of the graph prototypes to delete.
pt-br	### Parâmetros  `(array)` IDs dos protótipos de gráfico a serem excluídos.

en-us	### Parameters  `(array)` IDs of the graphs to delete.
pt-br	### Parâmetros  `(array)` IDs dos gráficos a serem excluídos.

en-us	### Parameters  `(array)` IDs of the host groups to delete.
pt-br	### Parâmetros  `(array)` IDs dos grupos de hosts a serem excluídos.

en-us	### Parameters  `(array)` IDs of the host interfaces to delete.
pt-br	### Parâmetros  `(array)` IDs das interfaces de host a serem excluídas.

en-us	### Parameters  `(array)` IDs of the host macros to delete.
pt-br	### Parâmetros  `(array)` IDs das macros de hosts a serem deletadas.

en-us	### Parameters  `(array)` IDs of the host prototypes to delete.
pt-br	### Parâmetros  `(array)` IDs dos protótipos de host a serem excluídos.

en-us	### Parameters  `(array)` IDs of the icon maps to delete.
pt-br	### Parâmetros  `(array)` IDs dos mapas de ícones a serem excluídos.

en-us	### Parameters  `(array)` IDs of the images to delete.
pt-br	### Parâmetros  `(array)` IDs das imagens a serem excluídas.

en-us	### Parameters  `(array)` IDs of the item prototypes to delete.
pt-br	### Parâmetros  `(array)` IDs dos protótipos de itens a serem excluídos.

en-us	### Parameters  `(array)` IDs of the items to delete.
pt-br	### Parâmetros  `(array)` IDs dos itens a serem excluídos.

en-us	### Parameters  `(array)` IDs of the LLD rules to delete.
pt-br	### Parâmetros  `(array)` IDs das regras LLD a serem excluídas.

en-us	### Parameters  `(array)` IDs of the maintenances to delete.
pt-br	### Parâmetros  `(array)` IDs das manutenções a serem excluídas.

en-us	### Parameters  `(array)` IDs of the maps to delete.
pt-br	### Parâmetros  `(array)` IDs dos mapas a serem excluídos.

en-us	### Parameters  `(array)` IDs of the media types to delete.
pt-br	### Parâmetros  `(array)` IDs dos tipos de mídia a serem excluídos.

en-us	### Parameters  `(array)` IDs of the regular expressions to delete.
pt-br	### Parâmetros  `(array)` IDs das expressões regulares a serem excluídas.

en-us	### Parameters  `(array)` IDs of the roles to delete.
pt-br	### Parâmetros  `(array)` IDs das funções a serem excluídas.

en-us	### Parameters  `(array)` IDs of the scheduled reports to delete.
pt-br	### Parâmetros  `(array)` IDs dos relatórios programados a serem excluídos.

en-us	### Parameters  `(array)` IDs of the scripts to delete.
pt-br	### Parâmetros  `(array)` IDs dos scripts a serem excluídos.

en-us	### Parameters  `(array)` IDs of the services to delete.
pt-br	### Parâmetros  `(array)` IDs dos serviços a serem excluídos.

en-us	### Parameters  `(array)` IDs of the SLAs to delete.
pt-br	### Parâmetros  `(array)` IDs dos SLAs a serem excluídos.

en-us	### Parameters  `(array)` IDs of the template dashboards to delete.
pt-br	### Parâmetros  `(array)` IDs de templates de dashboard para deletar.

en-us	### Parameters  `(array)` IDs of the templates to delete.
pt-br	### Parâmetros  `(array)` IDs dos templates a serem deletados.

en-us	### Parameters  `(array)` IDs of the tokens to delete.
pt-br	### Parâmetros  `(array)` IDs dos tokens a serem excluídos.

en-us	### Parameters  `(array)` IDs of the tokens to generate.
pt-br	### Parâmetros      `(array)` IDs dos tokens a serem gerados.

en-us	### Parameters  `(array)` IDs of the trigger prototypes to delete.
pt-br	### Parâmetros  `(array)` IDs dos protótipos de trigger a serem excluídos.

en-us	### Parameters  `(array)` IDs of the triggers to delete.
pt-br	### Parâmetros  `(array)` IDs das trigger a serem excluídas.

en-us	### Parameters  `(array)` IDs of the user groups to delete.
pt-br	### Parâmetros    `(array)` IDs dos grupos de usuários a serem excluídos.

en-us	### Parameters  `(array)` IDs of the value maps to delete.
pt-br	### Parâmetros  `(array)` IDs dos valores de mapa a serem deletados.

en-us	### Parameters  `(array)` IDs of the web scenarios to delete.
pt-br	### Parâmetros  `(array)` IDs dos cenários Web a serem excluídos.

en-us	### Parameters  `(array)` IDs of users to delete.
pt-br	### Parâmetros  `(array)` IDs de usuários a serem excluídos.

en-us	### Parameters  `(array)` IDs of users to unblock.
pt-br	### Parâmetros  IDs de usuários para desbloquear `(array)`

en-us	### Parameters  `(array)` The method accepts an empty array.
pt-br	### Parâmetros  `(array)` O método aceita um array vazio.

en-us	### Parameters  `(array)` The method accepts an empty array.
pt-br	### Parâmetros  `(array)` O método aceita um array vazio.

en-us	#### Parameters  Foreach functions support two common parameters - item filter and time period:      foreach_function(item filter,time period)  for example:      avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)  Some functions support additional parameters.
pt-br	#### Parâmetros  As funções Foreach suportam dois parâmetros comuns - filtro de item e tempo período:      foreach_function (filtro de item, período de tempo)  por exemplo:      avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)  Algumas funções suportam parâmetros adicionais.

en-us	#### Parameters  ::: noteclassic In Zabbix versions before 6.0.6, parameter names start with *Plugins.Mongo.<Parameter>* instead of *Plugins.MongoDB.<Parameter>*. For example, *Plugins.Mongo.KeepAlive* :::  |Parameter|Mandatory|Range|Default|Description| |--|--|--|--|----------| |Plugins.MongoDB.Default.Password|no| | |Default password for connecting to MongoDB; used if no value is specified in an item key or named session.<br> Supported since version 6.0.18| |Plugins.MongoDB.Default.Uri|no| | |Default URI for connecting to MongoDB; used if no value is specified in an item key or named session. <br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Only `tcp` scheme is supported; a scheme can be omitted.<br>A port can be omitted (default=27017).<br>Examples: `tcp://127.0.0.1:27017`, `tcp:localhost`, `localhost`<br> Supported since version 6.0.18| |Plugins.MongoDB.Default.User|no| | |Default username for connecting to MongoDB; used if no value is specified in an item key or named session.<br> Supported since version 6.0.18| |Plugins.MongoDB.KeepAlive|no|60-900|300|The maximum time of waiting (in seconds) before unused plugin connections are closed.| |Plugins.MongoDB.Sessions.<SessionName>.Password|no| | |Named session password.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.MongoDB.Sessions.<SessionName>.TLSCAFile|no <br>(yes, if Plugins.MongoDB.Sessions.<SessionName>.TLSConnect is set to one of: verify_ca, verify_full)| | |Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification, used for encrypted communications between Zabbix agent 2 and monitored databases.<br>**<SessionName>** - define name of a session for using in item keys. <br><br> Supported in plugin versions 1.2.0, 6.0.13 and newer^[1](mongodb_plugin#footnotes)^. | |Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile|yes, if Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile is specified<br><br>Before version 6.0.24 always mandatory if Plugins.MongoDB.Sessions.<SessionName>.TLSConnect is set to one of: verify_ca, verify_full| | |Full pathname of a file containing the agent certificate or certificate chain, used for encrypted communications between Zabbix agent 2 and monitored databases.<br>**<SessionName>** - define name of a session for using in item keys. <br><br> Supported in plugin versions 1.2.0, 6.0.13 and newer^[1](mongodb_plugin#footnotes)^.| |Plugins.MongoDB.Sessions.<SessionName>.TLSConnect|no | | |Encryption type for communications between Zabbix agent 2 and monitored databases.<br>**<SessionName>** - define name of a session for using in item keys.<br><br>Supported values:<br>*required* - require TLS connection;<br>*verify\_ca* - verify certificates;<br>*verify\_full* - verify certificates and IP address. <br><br> Supported in plugin versions 1.2.0, 6.0.13 and newer^[1](mongodb_plugin#footnotes)^.| |Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile|yes, if Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile is specified<br><br>Before version 6.0.24 always mandatory if Plugins.MongoDB.Sessions.<SessionName>.TLSConnect is set to one of: verify_ca, verify_full| | |Full pathname of a file containing the database private key used for encrypted communications between Zabbix agent 2 and monitored databases.<br>**<SessionName>** - define name of a session for using in item keys. <br><br> Supported in plugin versions 1.2.0, 6.0.13 and newer^[1](mongodb_plugin#footnotes)^.| |Plugins.MongoDB.Sessions.<SessionName>.Uri|no| | |Connection string of a named session.<br>**<SessionName>** - define name of a session for using in item keys.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Only `tcp` scheme is supported; a scheme can be omitted.<br>A port can be omitted (default=27017).<br>Examples: `tcp://127.0.0.1:27017`, `tcp:localhost`, `localhost`| |Plugins.MongoDB.Sessions.<SessionName>.User|no| | |Named session username.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.MongoDB.System.Path|no| | |Path to external plugin executable. Supported since Zabbix 6.0.6| |Plugins.MongoDB.Timeout|no|1-30|global timeout|Request execution timeout (how long to wait for a request to complete before shutting it down).|  See also:  -   Description of general Zabbix agent 2 configuration parameters:     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instructions for configuring [plugins](/manual/config/items/plugins)
pt-br	#### Parâmetros  ::: noteclassic Nas versões do Zabbix anteriores à 6.0.6, os nomes dos parâmetros começam com *Plugins.Mongo.<Parameter>* em vez de *Plugins.MongoDB.<Parameter>*.  Por exemplo, *Plugins.Mongo.KeepAlive* :::  |Parâmetro|Obrigatório|Intervalo|Padrão|Descrição| |--|--|--|--|----------| |Plugins.MongoDB.Default.Password|não| | |Senha padrão para conectar ao MongoDB; usada se nenhum valor for especificado em uma chave de item ou sessão nomeada.<br> Suportado desde a versão 6.0.18| |Plugins.MongoDB.Default.Uri|não| | |URI padrão para conectar ao MongoDB; usada se nenhum valor for especificado em uma key de item ou sessão nomeada. <br><br>Não deve incluir credenciais incorporadas (serão ignoradas).<br>Deve corresponder ao formato de URI.<br>Apenas o esquema `tcp` é suportado, um esquema pode ser omitido.<br>Uma porta pode ser omitida (padrão=27017).<br>Exemplos: `tcp://127.0.0.1:27017`, `tcp:localhost`, `localhost`<br> Suportado desde a versão 6.0.18| |Plugins.MongoDB.Default.User|não| | |Nome de usuário padrão para conectar ao MongoDB; usado se nenhum valor for especificado em uma key de item ou sessão nomeada.<br> Suportado desde a versão 6.0.18| |Plugins.MongoDB.KeepAlive|não|60-900|300|O tempo máximo de espera (em segundos) antes que as conexões de plugin não utilizadas sejam fechadas.| |Plugins.MongoDB.Sessions.<SessionName>.Password|não| | |Senha da sessão nomeada.<br>**<SessionName>** - define o nome de uma sessão para uso em keys de item..| |Plugins.MongoDB.Sessions.<SessionName>.TLSCAFile|não <br>(sim, se Plugins.MongoDB.Sessions.<SessionName>.TLSConnect for definido como um dos: verify_ca, verify_full)| | |Nome completo do arquivo contendo os certificados CA (Certificado de Autoridade) de nível superior para verificação do certificado do par, usado para comunicações criptografadas entre o agente Zabbix 2 e os bancos de dados monitorados.<br>**<SessionName>** - define o nome de uma sessão para uso em keys de item.. <br><br> Suportado nas versões do plugin 1.2.0, 6.0.13 e mais recentes ^[1](mongodb_plugin#footnotes)^. | |Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile|sim, se Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile for especificado<br><br>Antes da versão 6.0.24 sempre obrigatório se Plugins.MongoDB.Sessions.<SessionName>.TLSConnectfor definido como um dos: verify_ca, verify_full| | |Nome completo do arquivo contendo o certificado do agente ou cadeia de certificados, usado para comunicações criptografadas entre o agente Zabbix 2 e os bancos de dados monitorados.<br>**<SessionName>** - define o nome de uma sessão para uso em keys de item. <br><br> Suportado nas versões do plugin 1.2.0, 6.0.13 e mais recente^[1](mongodb_plugin#footnotes)^.| |Plugins.MongoDB.Sessions.<SessionName>.TLSConnect|não | | |Tipo de criptografia para comunicações entre o agente Zabbix 2 e os bancos de dados monitorados.<br>**<SessionName>** - define o nome de uma sessão para uso em keys de item..<br><br>Valores suportados:<br>*required* - requer conexão TLS;<br>*verify\_ca* - verificar certificados;;<br>*verify\_full* - verificar certificados e endereço IP. <br><br> Suportado nas versões do plugin 1.2.0, 6.0.13 e mais recentes^[1](mongodb_plugin#footnotes)^.| |Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile|sim, se Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile for especificado<br><br>Antes da versão 6.0.24 sempre obrigatório se Plugins.MongoDB.Sessions.<SessionName>.TLSConnect estiver configurado para um dos: verify_ca, verify_full| | |Nome completo do arquivo contendo a chave privada do banco de dados usada para comunicações criptografadas entre o agente Zabbix 2 e os bancos de dados monitorados.<br>**<SessionName>** - define o nome de uma sessão para uso em keys de item. <br><br> uportado nas versões do plugin 1.2.0, 6.0.13 e mais recentes^[1](mongodb_plugin#footnotes)^.| |Plugins.MongoDB.Sessions.<SessionName>.Uri|não| | |   String de conexão de uma sessão nomeada.<br>**<SessionName>** - define o nome de uma sessão para uso em keys de item.<br><br>Não deve incluir credenciais incorporadas (serão ignoradas).<br>Deve corresponder ao formato de URI format.<br>Apenas o esquema `tcp` é suportado; um esquema pode ser omitido.<br>Uma porta pode ser omitida (padrão=27017).<br>Exemplos: `tcp://127.0.0.1:27017`, `tcp:localhost`, `localhost`| |Plugins.MongoDB.Sessions.<SessionName>.Usuário|não| | |Nome do usuário da sessão nomeada.<br>**<SessionName>** - define o nome de uma sessão para uso em key de item.| |Plugins.MongoDB.System.Path|não| | |Caminho para o executável do plugin externo. Suportado desde o Zabbix 6.0.6| |Plugins.MongoDB.Timeout|não|1-30|tempo limite global|Tempo limite da execução (quanto tempo esperar para que uma solicitação seja concluída antes de encerrá-la).|  Consulte também:  -   Descrição dos parâmetros de configuração do gerais do agente     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) -  Instruções para configurar [plugins](/manual/config/items/plugins)

en-us	### Parameters  `(object/array)` Action properties to be updated.  The `actionid` property must be defined for each action, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard action properties](object#action), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|Action [filter](/manual/api/reference/action/object#action_filter) object to replace the current filter.| |operations|array|Action [operations](/manual/api/reference/action/object#action_operation) to replace existing operations.| |recovery\_operations|array|Action [recovery operations](/manual/api/reference/action/object#action_recovery_operation) to replace existing recovery operations.| |update\_operations|array|Action [update operations](/manual/api/reference/action/object#action_update_operation) to replace existing update operations.|
pt-br	### Parâmetros  `(object/array)` Propriedades da ação a serem atualizadas.  A propriedade `actionid` deve ser definida para cada ação, todas as outras propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.  Além das [propriedades de ação padrão](object#action), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |filter|object|Action [filter](/manual/api/reference/action/object#action_filter) objeto para substituir o filtro atual.| |operações|array|Ação [operações](/manual/api/reference/action/object#action_operation) para substituir as operações existentes.| |recovery\_operations|array|Ação [operações de recuperação](/manual/api/reference/action/object#action_recovery_operation) para substituir as operações de recuperação existentes.| |update\_operations|array|Ação [operações de atualização](/manual/api/reference/action/object#action_update_operation) para substituir as operações de atualização existentes.|

en-us	### Parameters  `(object/array)` Actions to create.  Additionally to the [standard action properties](object#action), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |filter|object|Action [filter](/manual/api/reference/action/object#action_filter) object for the action.| |operations|array|Action [operations](/manual/api/reference/action/object#action_operation) to create for the action.| |recovery\_operations|array|Action [recovery operations](/manual/api/reference/action/object#action_recovery_operation) to create for the action.| |update\_operations|array|Action [update operations](/manual/api/reference/action/object#action_update_operation) to create for the action.|
pt-br	### Parâmetros  `(objeto/array)` Ações para criar.  Além das [propriedades de ação padrão](object#action), o O método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |filter|objeto|Ação [filtro](/manual/api/reference/action/object#action_filter) objeto para a ação.| |operações|array|Ação [operações](/manual/api/reference/action/object#action_operation) para criar para a ação.| |recovery\_operations|array|Ação [operações de recuperação](/manual/api/reference/action/object#action_recovery_operation) para criar para a ação.| |update\_operations|array|Ação [update operations](/manual/api/reference/action/object#action_update_operation) para criar para a ação.|

en-us	### Parameters  `(object/array)` A task to create.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**type**<br>(required)|integer|Task type.<br><br>Possible values:<br>1 - Diagnostic information;<br>6 - Check now.| |**request**<br>(required)|object|Task request object according to the task type. Correct format of request object is described in [Task object](/manual/api/reference/task/object) section.| |proxy\_hostid|integer|Proxy about which Diagnostic information task will collect data.<br><br>Ignored for 'Check now' tasks.|  *Note* that 'Check now' tasks can be created only for the following types of items/discovery rules:  -   Zabbix agent -   SNMPv1/v2/v3 agent -   Simple check -   Internal check -   External check -   Database monitor -   HTTP agent -   IPMI agent -   SSH agent -   TELNET agent -   Calculated check -   JMX agent
pt-br	### Parâmetros      `(object/array)` Uma tarefa para criar.      O método aceita os seguintes parâmetros.      |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**type**<br>(requerido)|integer|Tipo de tarefa.<br><br>Valores possíveis:<br>1 - Informações de diagnóstico;<br>6 - Verifique agora.| |**request**<br>(requerido)|object|Objeto de solicitação de tarefa de acordo com o tipo de tarefa. O formato correto do objeto de solicitação é descrito na seção [Task object](/manual/api/reference/task/object).| |proxy\_hostid|integer|Proxy sobre qual tarefa de informações de diagnóstico coletará dados.<br><br>Ignorado para tarefas "Verificar agora".|  *Observe* que as tarefas 'Verificar agora' podem ser criadas apenas para os seguintes tipos de itens/regras de descoberta:  -   Zabbix agent -   SNMPv1/v2/v3 agent -   Simple check -   Internal check -   External check -   Database monitor -   HTTP agent -   IPMI agent -   SSH agent -   TELNET agent -   Calculated check -   JMX agent

en-us	### Parameters  `(object/array)` Correlation properties to be updated.  The `correlationid` property must be defined for each correlation, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard correlation properties](object#correlation), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |filter|object|Correlation [filter](/manual/api/reference/correlation/object#correlation_filter) object to replace the current filter.| |operations|array|Correlation [operations](/manual/api/reference/correlation/object#correlation_operation) to replace existing operations.|
pt-br	### Parâmetros  `(object/array)` Propriedades de correlação a serem atualizadas.  A propriedade `correlationid` deve ser definida para cada correlação, todas outras propriedades são opcionais. Somente as propriedades passadas serão atualizado, todos os outros permanecerão inalterados.  Além da [correlação padrão properties](object#correlation), o método aceita o seguinte parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |filter|object|Correlation [filter](/manual/api/reference/correlation/object#correlation_filter) objeto para substituir o filtro atual.| |operações|matriz|Correlação [operações](/manual/api/reference/correlation/object#correlation_operation) para substituir as operações existentes.|

en-us	### Parameters  `(object/array)` Correlations to create.  Additionally to the [standard correlation properties](object#correlation), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**operations**<br>(required)|array|Correlation [operations](/manual/api/reference/correlation/object#correlation_operation) to create for the correlation.| |**filter**<br>(required)|object|Correlation [filter](/manual/api/reference/correlation/object#correlation_filter) object for the correlation.|
pt-br	### Parâmetros  `(objeto/array)` Correlações a serem criadas.  Além da [correlação padrão properties](object#correlation), o método aceita o seguinte parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**operações**<br>(obrigatório)|array|Correlação [operações](/manual/api/reference/correlation/object#correlation_operation) para criar para a correlação.| |**filtro**<br>(obrigatório)|objeto|Correlation [filtro](/manual/api/reference/correlation/object#correlation_filter) objeto para a correlação.|

en-us	### Parameters  `(object/array)` Dashboard properties to be updated.  The `dashboardid` property must be specified for each dashboard, all other properties are optional. Only the specified properties will be updated.  Additionally to the [standard dashboard properties](object#dashboard), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |pages|array|Dashboard [pages](object#dashboard_page) to replace the existing dashboard pages.<br><br>Dashboard pages are updated by the `dashboard_pageid` property. New dashboard pages will be created for objects without `dashboard_pageid` property and the existing dashboard pages will be deleted if not reused. Dashboard pages will be ordered in the same order as specified. Only the specified properties of the dashboard pages will be updated. At least one dashboard page object is required for `pages` property.| |users|array|Dashboard [user](object#dashboard_user) shares to replace the existing elements.| |userGroups|array|Dashboard [user group](object#dashboard_user_group) shares to replace the existing elements.|
pt-br	### Parâmetros  `(object/array)` Propriedades do painel a serem atualizadas.  A propriedade `dashboardid` deve ser especificada para cada painel, todos outras propriedades são opcionais. Somente as propriedades especificadas serão Atualizada.  Além das [propriedades padrão do painel](object#dashboard), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |pages|array|Painel [páginas](object#dashboard_page) para substituir as páginas do painel existentes.<br><br>As páginas do painel são atualizadas pela propriedade `dashboard_pageid`. Novas páginas de painel serão criadas para objetos sem a propriedade `dashboard_pageid` e as páginas de painel existentes serão excluídas se não forem reutilizadas. As páginas do painel serão ordenadas na mesma ordem especificada. Somente as propriedades especificadas das páginas do painel serão atualizadas. Pelo menos um objeto de página do painel é necessário para a propriedade `pages`.| |users|array|Dashboard [user](object#dashboard_user) compartilha para substituir os elementos existentes.| |userGroups|array|Dashboard [grupo de usuários](object#dashboard_user_group) compartilha para substituir os elementos existentes.|

en-us	### Parameters  `(object/array)` Dashboards to create.  Additionally to the [standard dashboard properties](object#dashboard), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**pages**<br>(required)|array|Dashboard [pages](object#dashboard_page) to be created for the dashboard. Dashboard pages will be ordered in the same order as specified. At least one dashboard page object is required for `pages` property.| |users|array|Dashboard [user](object#dashboard_user) shares to be created on the dashboard.| |userGroups|array|Dashboard [user group](object#dashboard_user_group) shares to be created on the dashboard.|
pt-br	### Parâmetros  `(object/array)` Dashboards para criar.  Além das [propriedades padrão do painel](object#dashboard), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**páginas**<br>(obrigatório)|array|Painel [páginas](object#dashboard_page) a ser criado para o painel. As páginas do painel serão ordenadas na mesma ordem especificada. Pelo menos um objeto de página do painel é necessário para a propriedade `pages`.| |users|array|Dashboard [user](object#dashboard_user) compartilhamentos a serem criados no painel.| |userGroups|array|Dashboard [grupo de usuários](object#dashboard_user_group) compartilhamentos a serem criados no painel.|

en-us	### Parameters  `(object/array)` Discovery rule properties to be updated.  The `druleid` property must be defined for each discovery rule, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard discovery rule properties](object#discovery_rule), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |dchecks|array|Discovery [checks](/manual/api/reference/dcheck/object) to replace existing checks.|
pt-br	### Parâmetros  `(object/array)` Propriedades da regra de descoberta a serem atualizadas.  A propriedade `druleid` deve ser definida para cada regra de descoberta, todas outras propriedades são opcionais. Somente as propriedades passadas serão atualizado, todos os outros permanecerão inalterados.  Além da [regra de descoberta padrão properties](object#discovery_rule), o método aceita o seguinte parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |dchecks|array|Discovery [checks](/manual/api/reference/dcheck/object) para substituir as verificações existentes.|

en-us	### Parameters  `(object/array)` Discovery rules to create.  Additionally to the [standard discovery rule properties](object#discovery_rule), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**dchecks**<br>(required)|array|Discovery [checks](/manual/api/reference/dcheck/object) to create for the discovery rule.|
pt-br	### Parâmetros  `(object/array)` Regras de descoberta a serem criadas.  Além da [propriedades padão da regra de descoberta] (object#discovery_rule), o método aceita os seguintes parâmetros  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**dchecks**<br>(obrigatório)|array|Discovery [checks](/manual/api/reference/dcheck/object) para criar para a regra de descoberta.|

en-us	### Parameters  `(object/array)` Global macros to create.  The method accepts global macros with the [standard global macro properties](object#global_macro).
pt-br	### Parâmetros    `(object/array)` Macros globais a serem criadas.      O método aceita macros globais com as [propriedades de macros globais padrão](object#global_macro).

en-us	### Parameters  `(object/array)` Graph properties to be updated.  The `graphid` property must be defined for each graph, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard graph properties](object#graph) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |gitems|array|Graph [items](/manual/api/reference/graphitem/object) to replace existing graph items. If a graph item has the `gitemid` property defined it will be updated, otherwise a new graph item will be created.|
pt-br	### Parâmetros  `(object/array)` Propriedades do gráfico a serem atualizadas.  A propriedade `graphid` deve ser definida para cada gráfico, todos os outros propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas outros permanecerão inalterados.  Além das [propriedades de gráfico padrão](object#graph), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |gitems|array|Gráfico [items](/manual/api/reference/graphitem/object) para substituir itens de gráfico existentes. Se um item de gráfico tiver a propriedade `gitemid` definida, ele será atualizado, caso contrário, um novo item de gráfico será criado.|

en-us	### Parameters  `(object/array)` Graph prototype properties to be updated.  The `graphid` property must be defined for each graph prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard graph prototype properties](object#graph_prototype), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |gitems|array|Graph [items](/manual/api/reference/graphitem/object) to replace existing graph items. If a graph item has the `gitemid` property defined it will be updated, otherwise a new graph item will be created.|
pt-br	### Parâmetros  `(object/array)` Propriedades do protótipo do gráfico a serem atualizadas.  A propriedade `graphid` deve ser definida para cada protótipo de gráfico, todos outras propriedades são opcionais. Somente as propriedades passadas serão atualizado, todos os outros permanecerão inalterados.  Além do [protótipo de gráfico padrão properties](object#graph_prototype), o método aceita o seguinte parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |gitems|array|Gráfico [items](/manual/api/reference/graphitem/object) para substituir itens de gráfico existentes. Se um item de gráfico tiver a propriedade `gitemid` definida, ele será atualizado, caso contrário, um novo item de gráfico será criado.|

en-us	### Parameters  `(object/array)` Graph prototypes to create.  Additionally to the [standard graph prototype properties](object#graph_prototype), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**gitems**<br>(required)|array|Graph [items](/manual/api/reference/graphitem/object) to be created for the graph prototypes. Graph items can reference both items and item prototypes, but at least one item prototype must be present.|
pt-br	### Parâmetros  `(object/array)` Protótipos de gráfico para criar.  Além do [protótipo de gráfico padrão properties](object#graph_prototype), o método aceita o seguinte parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**gitems**<br>(obrigatório)|array|Gráfico [itens](/manual/api/reference/graphitem/object) a ser criado para os protótipos do gráfico. Itens de gráfico podem referenciar itens e protótipos de itens, mas pelo menos um protótipo de item deve estar presente.|

en-us	### Parameters  `(object/array)` Graphs to create.  Additionally to the [standard graph properties](object#graph), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**gitems**<br>(required)|array|Graph [items](/manual/api/reference/graphitem/object) to be created for the graph.|
pt-br	### Parâmetros  `(object/array)` Gráficos para criar.  Além das [propriedades de gráfico padrão](object#graph), o O método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**gitems**<br>(obrigatório)|array|Gráfico [itens](/manual/api/reference/graphitem/object) a ser criado para o gráfico.|

en-us	### Parameters  `(object/array)` [Host group properties](object#host_group) to be updated.  The `groupid` property must be defined for each host group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged.
pt-br	### Parâmetros  `(object/array)` [Propriedades do grupo de hosts](object#host_group) a ser Atualizada.  A propriedade `groupid` deve ser definida para cada grupo de hosts, todos os outros propriedades são opcionais. Apenas as propriedades fornecidas serão atualizadas, todas outros permanecerão inalterados.

en-us	### Parameters  `(object/array)` Host groups to create. The method accepts host groups with the [standard host group properties](object#host_group).
pt-br	### Parâmetros  `(objeto/array)` Grupos de hosts a serem criados. O método aceita grupos de hosts com as [propriedades padrão do grupo de hosts](object#host_group).

en-us	### Parameters  `(object/array)` [Host interface properties](object#host_interface) to be updated.  The `interfaceid` property must be defined for each host interface, all other properties are optional. Only the given properties will be updated, all others will remain unchanged.
pt-br	### Parâmetros  `(object/array)` [Propriedades da interface do host](object#host_interface) para ser atualizado.  A propriedade `interfaceid` deve ser definida para cada interface do host, todas outras propriedades são opcionais. Apenas as propriedades dadas serão atualizado, todos os outros permanecerão inalterados.

en-us	### Parameters  `(object/array)` Host interfaces to create. The method accepts host interfaces with the [standard host interface properties](object#host_interface).
pt-br	### Parâmetros  `(objeto/array)` Interfaces de host para criar. O método aceita host interfaces com a [interface de host padrão propriedades](object#host_interface).

en-us	### Parameters  `(object/array)` Host macros to create.  The method accepts host macros with the [standard host macro properties](object#host_macro).
pt-br	### Parâmetros    `(objeto/array)` Macros de host a serem criadas.      O método aceita macros de host com as [propriedades de macro de host padrão](object#host_macro).

en-us	### Parameters  `(object/array)` Host properties to be updated.  The `hostid` property must be defined for each host, all other properties are optional. Only the given properties will be updated, all others will remain unchanged.  Note, however, that updating the host technical name will also update the host's visible name (if not given or empty) by the host's technical name value.  Additionally to the [standard host properties](object#host), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object#host_group) to replace the current host groups the host belongs to.<br><br>The host groups must have the `groupid` property defined. All host groups that are not listed in the request will be unlinked.| |interfaces|object/array|Host [interfaces](/manual/api/reference/hostinterface/object) to replace the current host interfaces.<br><br>All interfaces that are not listed in the request will be removed.| |tags|object/array|Host [tags](/manual/api/reference/host/object#host_tag) to replace the current host tags.<br><br>All tags that are not listed in the request will be removed.| |inventory|object|Host [inventory](/manual/api/reference/host/object#host_inventory) properties.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to replace the current user macros.<br><br>All macros that are not listed in the request will be removed.| |templates|object/array|[Templates](/manual/api/reference/template/object) to replace the currently linked templates. All templates that are not listed in the request will be only unlinked.<br><br>The templates must have the `templateid` property defined.| |templates\_clear|object/array|[Templates](/manual/api/reference/template/object) to unlink and clear from the host.<br><br>The templates must have the `templateid` property defined.|  ::: notetip As opposed to the Zabbix frontend, when `name` (visible host name) is the same as `host` (technical host name), updating `host` via API will not automatically update `name`. Both properties need to be updated explicitly. :::
pt-br	### Parâmetros  `(object/array)` Propriedades do host a serem atualizadas.  A propriedade `hostid` deve ser definida para cada host, todos os outros propriedades são opcionais. Somente as propriedades fornecidas serão atualizadas, todas outros permanecerão inalterados.  Observe, no entanto, que atualizar o nome técnico do host também atualizará o nome visível do host (se não fornecido ou vazio) pelo técnico do host valor do nome.  Além das [propriedades padrão do host](object#host), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object#host_group) para substituir os grupos de hosts atuais aos quais o host pertence.<br><br>Os grupos de hosts devem ter o `groupid ` propriedade definida. Todos os grupos de hosts que não estão listados na solicitação serão desvinculados.| |interfaces|object/array|Host [interfaces](/manual/api/reference/hostinterface/object) para substituir as interfaces de host atuais.<br><br>Todas as interfaces que não estiverem listadas na solicitação serão removidas.| |tags|object/array|Host [tags](/manual/api/reference/host/object#host_tag) para substituir as tags de host atuais.<br><br>Todas as tags que não estiverem listadas na solicitação serão removidas .| |inventário|objeto|Host [inventário](/manual/api/reference/host/object#host_inventory) propriedades.| |macros|object/array|[Macros de usuário](/manual/api/reference/usermacro/object) para substituir as macros de usuário atuais.<br><br>Todas as macros que não estiverem listadas na solicitação serão removidas.| |templates|object/array|[Templates](/manual/api/reference/template/object) para substituir os templates atualmente vinculados. Todos os modelos que não estiverem listados na solicitação serão apenas desvinculados.<br><br>Os modelos devem ter a propriedade `templateid` definida.| |templates\_clear|object/array|[Templates](/manual/api/reference/template/object) para desvincular e limpar do host.<br><br>Os templates devem ter a propriedade `templateid` definida.|  ::: dica Ao contrário do frontend Zabbix, quando `name` (visível nome do host) é o mesmo que `host` (nome técnico do host), atualizando o `host` via API não atualizará automaticamente `name`. Ambas as propriedades precisam ser atualizado explicitamente. :::

en-us	### Parameters  `(object/array)` Host prototype properties to be updated.  The `hostid` property must be defined for each host prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard host prototype properties](object#host_prototype), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |groupLinks|array|Group [links](/manual/api/reference/hostprototype/object#group_link) to replace the current group links on the host prototype.| |groupPrototypes|array|Group [prototypes](/manual/api/reference/hostprototype/object#group_prototype) to replace the existing group prototypes on the host prototype.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to replace the current user macros.<br><br>All macros that are not listed in the request will be removed.| |tags|object/array|Host prototype [tags](/manual/api/reference/hostprototype/object#host_prototype_tag) to replace the current tags.<br><br>All tags that are not listed in the request will be removed.| |interfaces|object/array|Host prototype [custom interfaces](/manual/api/reference/hostprototype/object#custom_interface) to replace the current interfaces.<br><br>Custom interface object should contain all its parameters.<br>All interfaces that are not listed in the request will be removed.| |templates|object/array|[Templates](/manual/api/reference/template/object) to replace the currently linked templates.<br><br>The templates must have the `templateid` property defined.|
pt-br	### Parâmetros  `(object/array)` Propriedades do protótipo do host a serem atualizadas.  A propriedade `hostid` deve ser definida para cada protótipo de host, todos os outros propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas outros permanecerão inalterados.  Além do [protótipo de host padrão properties](object#host_prototype), o método aceita o seguinte parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |groupLinks|array|Grupo [links](/manual/api/reference/hostprototype/object#group_link) para substituir os links de grupo atuais no protótipo do host.| |groupPrototypes|array|Grupo [protótipos](/manual/api/reference/hostprototype/object#group_prototype) para substituir os protótipos de grupo existentes no protótipo do host.| |macros|object/array|[Macros de usuário](/manual/api/reference/usermacro/object) para substituir as macros de usuário atuais.<br><br>Todas as macros que não estiverem listadas na solicitação serão removidas.| |tags|object/array|Protótipo de host [tags](/manual/api/reference/hostprototype/object#host_prototype_tag) para substituir as tags atuais.<br><br>Todas as tags que não estiverem listadas na solicitação serão removidas .| |interfaces|object/array|Protótipo de host [interfaces personalizadas](/manual/api/reference/hostprototype/object#custom_interface) para substituir as interfaces atuais.<br><br>O objeto de interface personalizada deve conter todos os seus parâmetros.<br >Todas as interfaces que não estão listadas na solicitação serão removidas.| |templates|object/array|[Templates](/manual/api/reference/template/object) para substituir os templates atualmente vinculados.<br><br>Os templates devem ter a propriedade `templateid` definida.|

en-us	### Parameters  `(object/array)` Host prototypes to create.  Additionally to the [standard host prototype properties](object#host_prototype), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**groupLinks**<br>(required)|array|Group [links](/manual/api/reference/hostprototype/object#group_link) to be created for the host prototype.| |**ruleid**<br>(required)|string|ID of the LLD rule that the host prototype belongs to.| |groupPrototypes|array|Group [prototypes](/manual/api/reference/hostprototype/object#group_prototype) to be created for the host prototype.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the host prototype.| |tags|object/array|Host prototype [tags](/manual/api/reference/hostprototype/object#host_prototype_tag).| |interfaces|object/array|Host prototype [custom interfaces](/manual/api/reference/hostprototype/object#custom_interface).| |templates|object/array|[Templates](/manual/api/reference/template/object) to be linked to the host prototype.<br><br>The templates must have the `templateid` property defined.|
pt-br	### Parâmetros  `(object/array)` Protótipos de host para criar.  Além do [protótipo de host padrão properties](object#host_prototype), o método aceita o seguinte parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**groupLinks**<br>(obrigatório)|array|Grupo [links](/manual/api/reference/hostprototype/object#group_link) a ser criado para o protótipo do host.| |**ruleid**<br>(obrigatório)|string|ID da regra LLD à qual o protótipo do host pertence.| |groupPrototypes|array|Grupo [protótipos](/manual/api/reference/hostprototype/object#group_prototype) a ser criado para o protótipo do host.| |macros|object/array|[Macros do usuário](/manual/api/reference/usermacro/object) a serem criadas para o protótipo do host.| |tags|objeto/array|Protótipo de host [tags](/manual/api/reference/hostprototype/object#host_prototype_tag).| |interfaces|object/array|Protótipo de host [interfaces personalizadas](/manual/api/reference/hostprototype/object#custom_interface).| |templates|object/array|[Templates](/manual/api/reference/template/object) a serem vinculados ao protótipo do host.<br><br>Os templates devem ter a propriedade `templateid` definida.|

en-us	### Parameters  `(object/array)` Hosts to create.  Additionally to the [standard host properties](object#host), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**groups**<br>(required)|object/array|Host [groups](/manual/api/reference/hostgroup/object) to add the host to.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|[Interfaces](/manual/api/reference/hostinterface/object) to be created for the host.| |tags|object/array|Host [tags](/manual/api/reference/host/object#host_tag).| |templates|object/array|[Templates](/manual/api/reference/template/object) to be linked to the host.<br><br>The templates must have the `templateid` property defined.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the host.| |inventory|object|Host [inventory](/manual/api/reference/host/object#host_inventory) properties.|
pt-br	### Parâmetros  `(objeto/array)` Hosts para criar.  Além das [propriedades padrão do host](object#host), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**grupos**<br>(obrigatório)|objeto/matriz|Host [grupos](/manual/api/reference/hostgroup/object) ao qual adicionar o host.<br><br>Os grupos de hosts devem ter a propriedade `groupid` definida.| |interfaces|object/array|[Interfaces](/manual/api/reference/hostinterface/object) a ser criado para o host.| |tags|object/array|Host [tags](/manual/api/reference/host/object#host_tag).| |templates|object/array|[Templates](/manual/api/reference/template/object) a serem vinculados ao host.<br><br>Os templates devem ter a propriedade `templateid` definida.| |macros|object/array|[Macros do usuário](/manual/api/reference/usermacro/object) a serem criados para o host.| |inventário|objeto|Host [inventário](/manual/api/reference/host/object#host_inventory) propriedades.|

en-us	### Parameters  `(object/array)` Icon map properties to be updated.  The `iconmapid` property must be defined for each icon map, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard icon map properties](object#icon_map), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |mappings|array|[Icon mappings](/manual/api/reference/iconmap/object#icon_mapping) to replace the existing icon mappings.|
pt-br	### Parâmetros  `(object/array)` Propriedades do mapa de ícones a serem atualizadas.  A propriedade `iconmapid` deve ser definida para cada mapa de ícones, todos os outros propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas outros permanecerão inalterados.  Além das [propriedades padrão do mapa de ícones](object#icon_map), o O método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |mappings|array|[Mapeamentos de ícones](/manual/api/reference/iconmap/object#icon_mapping) para substituir os mapeamentos de ícones existentes.|

en-us	### Parameters  `(object/array)` Icon maps to create.  Additionally to the [standard icon map properties](object#icon_map), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**mappings**<br>(required)|array|[Icon mappings](/manual/api/reference/iconmap/object#icon_mapping) to be created for the icon map.|
pt-br	### Parâmetros  `(object/array)` Mapas de ícones para criar.  Além das [propriedades padrão do mapa de ícones](object#icon_map), o O método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**mapeamentos**<br>(obrigatório)|array|[Mapeamentos de ícones](/manual/api/reference/iconmap/object#icon_mapping) a serem criados para o mapa de ícones.|

en-us	### Parameters  `(object/array)` Image properties to be updated.  The `imageid` property must be defined for each image, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard image properties](object#image), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |image|string|Base64 encoded image. The maximum size of the encoded image is 1 MB. Maximum size can be adjusted by changing ZBX\_MAX\_IMAGE\_SIZE constant value.<br>Supported image formats are: PNG, JPEG, GIF.|
pt-br	### Parâmetros  `(object/array)` Propriedades da imagem a serem atualizadas.  A propriedade `imageid` deve ser definida para cada imagem, todas as outras propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas outros permanecerão inalterados.  Além das [propriedades de imagem padrão](object#image), o O método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |image|string|imagem codificada em Base64. O tamanho máximo da imagem codificada é 1 MB. O tamanho máximo pode ser ajustado alterando o valor da constante ZBX\_MAX\_IMAGE\_SIZE.<br>Os formatos de imagem suportados são: PNG, JPEG, GIF.|

en-us	### Parameters  `(object/array)` Images to create.  Additionally to the [standard image properties](object#image), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**name**<br>(required)|string|Name of the image.| |**imagetype**<br>(required)|integer|Type of image.<br><br>Possible values:<br>1 - *(default)* icon;<br>2 - background image.| |**image**<br>(required)|string|Base64 encoded image. The maximum size of the encoded image is 1 MB. Maximum size can be adjusted by changing ZBX\_MAX\_IMAGE\_SIZE constant value.<br>Supported image formats are: PNG, JPEG, GIF.|
pt-br	### Parâmetros  `(objeto/array)` Imagens para criar.  Além das [propriedades de imagem padrão](object#image), o O método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**nome**<br>(obrigatório)|string|Nome da imagem.| |**tipo de imagem**<br>(obrigatório)|inteiro|Tipo de imagem.<br><br>Valores possíveis:<br>1 - ícone *(padrão)*;<br>2 - imagem de fundo.| |**imagem**<br>(obrigatório)|string|imagem codificada em Base64. O tamanho máximo da imagem codificada é 1 MB. O tamanho máximo pode ser ajustado alterando o valor da constante ZBX\_MAX\_IMAGE\_SIZE.<br>Os formatos de imagem suportados são: PNG, JPEG, GIF.|

en-us	### Parameters  `(object/array)` Item properties to be updated.  The `itemid` property must be defined for each item, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard item properties](object#item), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |preprocessing|array|[Item preprocessing](/manual/api/reference/item/object#item_preprocessing) options to replace the current preprocessing options.| |tags|array|Item [tags.](/manual/api/reference/item/object#item_tag)|
pt-br	### Parâmetros  `(object/array)` Propriedades do item a serem atualizadas.  A propriedade `itemid` deve ser definida para cada item, todos os outros propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas outros permanecerão inalterados.  Além das [propriedades padrão do item](objeto#item), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |preprocessing|array|[Pré-processamento de item](/manual/api/reference/item/object#item_preprocessing) opções para substituir as opções de pré-processamento atuais.| |tags|array|Item [tags.](/manual/api/reference/item/object#item_tag)|

en-us	### Parameters  `(object/array)` Item prototype properties to be updated.  The `itemid` property must be defined for each item prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard item prototype properties](object#item_prototype), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |preprocessing|array|Item prototype [preprocessing](/manual/api/reference/itemprototype/object#item_prototype_preprocessing) options to replace the current preprocessing options.| |tags|array|Item prototype [tags](/manual/api/reference/itemprototype/object#item_prototype_tag).|
pt-br	### Parâmetros  `(object/array)` Propriedades do protótipo do item a serem atualizadas.  A propriedade `itemid` deve ser definida para cada protótipo de item,  todas as outras propriedades são opcionais. Apenas as propriedades passadas  serão atualizadas, todas as outras permanecerão inalteradas.  Além das [propriedades de protótipo de item padrão](object#item_prototype),  o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |preprocessing|array|Protótipo de item [preprocessing](/manual/api/reference/itemprototype/object#item_prototype_preprocessing) opções para substituir as opções de pré-processamento atuais.| |tags|array|Protótipo de item [tags](/manual/api/reference/itemprototype/object#item_prototype_tag).|

en-us	### Parameters  `(object/array)` Item prototype to create.  Additionally to the [standard item prototype properties](object#item_prototype), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**ruleid**<br>(required)|string|ID of the LLD rule that the item belongs to.| |preprocessing|array|Item prototype [preprocessing](/manual/api/reference/itemprototype/object#item_prototype_preprocessing) options.| |tags|array|Item prototype [tags](/manual/api/reference/itemprototype/object#item_prototype_tag).|
pt-br	### Parâmetros  `(object/array)` Protótipo de item a ser criado.  Além do [protótipo de item padrão properties](object#item_prototype), o método aceita o seguinte parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**ruleid**<br>(obrigatório)|string|ID da regra LLD à qual o item pertence.| |preprocessing|array|Protótipo de item [pré-processamento](/manual/api/reference/itemprototype/object#item_prototype_preprocessing) opções.| |tags|array|Protótipo de item [tags](/manual/api/reference/itemprototype/object#item_prototype_tag).|

en-us	### Parameters  `(object/array)` Items to create.  Additionally to the [standard item properties](object#host), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |preprocessing|array|Item [preprocessing](/manual/api/reference/item/object#item_preprocessing) options.| |tags|array|Item [tags.](/manual/api/reference/item/object#item_tag)|
pt-br	### Parâmetros  `(object/array)` Itens para criar.  Além das [propriedades padrão do item](object#host), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |preprocessing|array|Opções [preprocessing](/manual/api/reference/item/object#item_preprocessing) de itens.| |tags|array|Item [tags.](/manual/api/reference/item/object#item_tag)|

en-us	### Parameters  `(object/array)` Maintenance properties to be updated.  The `maintenanceid` property must be defined for each maintenance, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard maintenance properties](object#maintenance), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object) to replace the current groups.<br><br>The host groups must have the `groupid` property defined.| |hosts|object/array|[Hosts](/manual/api/reference/host/object) to replace the current hosts.<br><br>The hosts must have the `hostid` property defined.| |timeperiods|object/array|Maintenance [time periods](/manual/api/reference/maintenance/object#time_period) to replace the current periods.| |tags|object/array|[Problem tags](/manual/api/reference/maintenance/object#problem_tag) to replace the current tags.|  ::: noteimportant At least one host or host group must be defined for each maintenance. :::
pt-br	### Parâmetros  `(object/array)` Propriedades de manutenção a serem atualizadas.  A propriedade `maintenanceid` deve ser definida para cada manutenção, todas as outras propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.  Além das [propriedades de manutenção padrão](object#maintenance), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |groups|object/array|Host [grupos](/manual/api/reference/hostgroup/object) para substituir os grupos atuais.<br><br>Os grupos de hosts devem ter a propriedade `groupid` definida.| |hosts|object/array|[Hosts](/manual/api/reference/host/object) para substituir os hosts atuais.<br><br>Os hosts devem ter a propriedade `hostid` definida| |timeperiods|object/array|Manutenção [períodos de tempo](/manual/api/reference/maintenance/object#time_period) para substituir os períodos atuais.| |tags|object/array|[Tags de problema](/manual/api/reference/maintenance/object#problem_tag) para substituir as tags atuais.|  ::: noteimportant Pelo menos um host ou grupo de hosts deve ser definido para cada manutenção. :::

en-us	### Parameters  `(object/array)` Maintenances to create.  Additionally to the [standard maintenance properties](object#maintenance), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object) that will undergo maintenance.<br><br>The host groups must have the `groupid` property defined.<br><br>At least one object of `groups` or `hosts` must be specified.| |hosts|object/array|[Hosts](/manual/api/reference/host/object) that will undergo maintenance.<br><br>The hosts must have the `hostid` property defined.<br><br>At least one object of `groups` or `hosts` must be specified.| |**timeperiods**<br>(required)|object/array|Maintenance [time periods](/manual/api/reference/maintenance/object#time_period).| |tags|object/array|[Problem tags](/manual/api/reference/maintenance/object#problem_tag).<br><br>Define what problems must be suppressed.<br>If no tags are given, all active maintenance host problems will be suppressed.|
pt-br	### Parâmetros  `(object/array)` Manutenções a criar.  Além das [propriedades de manutenção padrão](object#maintenance),  o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |groups|object/array|Host [grupos](/manual/api/reference/hostgroup/object) que passará por manutenção.<br><br>Os grupos de hosts devem ter a propriedade `groupid` definida.<br><br>Pelo menos um objeto de `groups` ou `hosts` deve ser especificado.| |hosts|object/array|[Hosts](/manual/api/reference/host/object) que passará por manutenção.<br><br>Os hosts devem ter a propriedade `hostid` definida.<br><br>Pelo menos um objeto de `groups` ou `hosts` deve ser especificado.| |**timeperiods**<br>(requerido)|object/array|Manutenção [time periods](/manual/api/reference/maintenance/object#time_period).| |tags|object/array|[Problem tags](/manual/api/reference/maintenance/object#problem_tag).<br><br>Defina quais problemas devem ser suprimidos.<br>Se nenhuma tag for fornecida, todos os problemas de host de manutenção ativos serão suprimidos.|

en-us	### Parameters  `(object/array)` Map properties to be updated.  The `mapid` property must be defined for each map, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard map properties](object#map), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |links|array|Map [links](/manual/api/reference/map/object#map_link) to replace the existing links.| |selements|array|Map [elements](/manual/api/reference/map/object#map_element) to replace the existing elements.| |urls|array|Map [URLs](/manual/api/reference/map/object#map_url) to replace the existing URLs.| |users|array|Map [user](/manual/api/reference/map/object#map_user) shares to replace the existing elements.| |userGroups|array|Map [user group](/manual/api/reference/map/object#map_user_group) shares to replace the existing elements.| |shapes|array|Map [shapes](/manual/api/reference/map/object#map_shapes) to replace the existing shapes.| |lines|array|Map [lines](/manual/api/reference/map/object#map_lines) to replace the existing lines.|  ::: notetip To create map links between new map elements you'll need to set an element's `selementid` to an arbitrary value and then use this value to reference this element in the links `selementid1` or `selementid2` properties. When the element is created, this value will be replaced with the correct ID generated by Zabbix. [See example for map.create.](create#create_a_host_map) :::
pt-br	### Parâmetros  `(object/array)` Propriedades do mapa a serem atualizadas.  A propriedade `mapid` deve ser definida para cada mapa, todas as outras propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.  Além das [propriedades padrão do mapa](object#map), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |links|array|Mapeie [links](/manual/api/reference/map/object#map_link) para substituir os links existentes.| |selements|array|Mapeie [elements](/manual/api/reference/map/object#map_element) para substituir os elementos existentes.| |urls|array|Mapeie [URLs](/manual/api/reference/map/object#map_url) para substituir os URLs existentes.| |users|array|Mapeie os compartilhamentos de [user](/manual/api/reference/map/object#map_user) para substituir os elementos existentes.| |userGroups|array|Mapeie os compartilhamentos de [grupo de usuários](/manual/api/reference/map/object#map_user_group) para substituir os elementos existentes.| |shapes|array|Mapeie [formas](/manual/api/reference/map/object#map_shapes) para substituir as formas existentes.| |lines|array|Mapeie [linhas](/manual/api/reference/map/object#map_lines) para substituir as linhas existentes.|  ::: notetip Para criar links de mapa entre novos elementos de mapa, você precisará definir o `selementid` de um elemento para um valor arbitrário e, em seguida, usar esse valor para fazer referência a esse elemento nas propriedades `selementid1` ou `selementid2` dos links. Quando o elemento for criado, este valor será substituído pelo ID correto gerado pelo Zabbix. [Veja exemplo para map.create.](create#create_a_host_map) :::

en-us	### Parameters  `(object/array)` Maps to create.  Additionally to the [standard map properties](object#map), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |links|array|Map [links](/manual/api/reference/map/object#map_link) to be created on the map.| |selements|array|Map [elements](/manual/api/reference/map/object#map_element) to be created on the map.| |urls|array|Map [URLs](/manual/api/reference/map/object#map_url) to be created on the map.| |users|array|Map [user](/manual/api/reference/map/object#map_user) shares to be created on the map.| |userGroups|array|Map [user group](/manual/api/reference/map/object#map_user_group) shares to be created on the map.| |shapes|array|Map [shapes](/manual/api/reference/map/object#map_shapes) to be created on the map.| |lines|array|Map [lines](/manual/api/reference/map/object#map_lines) to be created on the map.|  ::: notetip To create map links you'll need to set a map element `selementid` to an arbitrary value and then use this value to reference this element in the links `selementid1` or `selementid2` properties. When the element is created, this value will be replaced with the correct ID generated by Zabbix. [See example.](create#create_a_host_map) :::
pt-br	### Parâmetros  `(object/array)` Mapas para criar.  Além das [propriedades padrão do mapa](object#map), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |links|array|Mapa [links](/manual/api/reference/map/object#map_link) a ser criado no mapa.| |selements|array|Mapa [elementos](/manual/api/reference/map/object#map_element) a ser criado no mapa.| |urls|array|Mapa [URLs](/manual/api/reference/map/object#map_url) a ser criado no mapa.| |users|array|Mapeie os compartilhamentos de [usuário](/manual/api/reference/map/object#map_user) a serem criados no mapa.| |userGroups|array|Map [user group](/manual/api/reference/map/object#map_user_group) shares to be created on the map.| |shapes|array|Mapa [shapes](/manual/api/reference/map/object#map_shapes) a ser criado no mapa.| |lines|array|Mapa [linhas](/manual/api/reference/map/object#map_lines) a ser criado no mapa.|  ::: notetip Para criar links de mapa, você precisará definir um elemento de mapa `selementid` para um valor arbitrário e, em seguida, usar esse valor para fazer referência a esse elemento nas propriedades `selementid1` ou `selementid2` dos links. Quando o elemento for criado, este valor será substituído pelo ID correto gerado pelo Zabbix. [Veja exemplo.](create#create_a_host_map) :::

en-us	### Parameters  `(object/array)` Media type properties to be updated.  The `mediatypeid` property must be defined for each media type, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard media type properties](object#media_type), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |parameters|array|[Webhook parameters](object#webhook_parameters) to replace the current webhook parameters.| |message\_templates|array|[Message templates](object#message_template) to replace the current message templates.|
pt-br	### Parâmetros      `(object/array)` Propriedades do tipo de mídia a serem atualizadas.      A propriedade `mediatypeid` deve ser definida para cada tipo de mídia, todas as outras propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.      Além das [propriedades de tipo de mídia padrão](object#media_type), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |parameters|array|[Parâmetros do webhook](object#webhook_parameters) para substituir os parâmetros atuais do webhook.| |message\_templates|array|[Modelos de mensagem](object#message_template) para substituir os modelos de mensagem atuais.|

en-us	### Parameters  `(object/array)` Media types to create.  Additionally to the [standard media type properties](object#media_type), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |parameters|array|[Webhook parameters](object#webhook_parameters) to be created for the media type.| |message\_templates|array|[Message templates](object#message_template) to be created for the media type.|
pt-br	### Parâmetros  `(object/array)` Tipos de mídia para criar.  Além das [propriedades de tipo de mídia padrão](object#media_type), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |parameters|array|[Parâmetros do webhook](object#webhook_parameters) a serem criados para o tipo de mídia.| |message\_templates|array|[Modelos de mensagem](object#message_template) a serem criados para o tipo de mídia.|

en-us	### Parameters  `(object/array)` Parameters containing the IDs of the events and update operations that should be performed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**eventids**<br>(required)|string/object|IDs of the events to acknowledge.| |**action**<br>(required)|integer|Event update action(s). This is bitmask field, any combination of values is acceptable.<br><br>Possible values:<br>1 - close problem;<br>2 - acknowledge event;<br>4 - add message;<br>8 - change severity;<br>16 - unacknowledge event.| |message|string|Text of the message.<br>**Required**, if action contains 'add message' flag.| |severity|integer|New severity for events.<br>**Required**, if action contains 'change severity' flag.<br><br>Possible values:<br>0 - not classified;<br>1 - information;<br>2 - warning;<br>3 - average;<br>4 - high;<br>5 - disaster.|
pt-br	### Parâmetros  `(object/array)` Parâmetros contendo os IDs dos eventos e atualização operações que devem ser realizadas.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**eventids**<br>(obrigatório)|string/object|IDs dos eventos a serem reconhecidos.| |**ação**<br>(obrigatório)|inteiro|Ação(ões) de atualização do evento. Este é um campo de máscara de bits, qualquer combinação de valores é aceitável.<br><br>Valores possíveis:<br>1 - fechar problema;<br>2 - reconhecer evento;<br>4 - adicionar mensagem;<br>8 - alterar a gravidade;<br>16 - evento de não confirmação.| |message|string|Texto da mensagem.<br>**Requerido**, se a ação contiver o sinalizador 'adicionar mensagem'.| |severity|integer|Nova gravidade para eventos.<br>**Obrigatório**, se a ação contiver o sinalizador 'alterar gravidade'.<br><br>Valores possíveis:<br>0 - não classificado;<br>1 - informações;<br>2 - aviso;<br>3 - média;<br>4 - alta;<br>5 - desastre.|

en-us	### Parameters  `(object/array)` Proxies to create.  Additionally to the [standard proxy properties](object#proxy), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hosts|array|[Hosts](/manual/api/reference/host/object) to be monitored by the proxy. If a host is already monitored by a different proxy, it will be reassigned to the current proxy.<br><br>The hosts must have the `hostid` property defined.| |interface|object|Host [interface](/manual/api/reference/hostinterface/object) to be created for the passive proxy.<br><br>Required for passive proxies.|
pt-br	### Parâmetros      `(object/array)` Proxies para criar.      Além das [propriedades de proxy padrão](object#proxy), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |hosts|array|[Hosts](/manual/api/reference/host/object) a serem monitorados pelo proxy. Se um host já for monitorado por um proxy diferente, ele será reatribuído ao proxy atual.<br><br>Os hosts devem ter a propriedade `hostid` definida.| |interface|object|Host [interface](/manual/api/reference/hostinterface/object) a ser criado para o proxy passivo.<br><br>Obrigatório para proxies passivos.|

en-us	### Parameters  `(object/array)` Proxy properties to be updated.  The `proxyid` property must be defined for each proxy, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard proxy properties](object#proxy), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hosts|array|[Hosts](/manual/api/reference/host/object) to be monitored by the proxy. If a host is already monitored by a different proxy, it will be reassigned to the current proxy.<br><br>The hosts must have the `hostid` property defined.| |interface|object|Host [interface](/manual/api/reference/hostinterface/object) to replace the existing interface for the passive proxy.|
pt-br	### Parâmetros      `(object/array)` Propriedades de proxy a serem atualizadas.  A propriedade `proxyid` deve ser definida para cada proxy, todas as outras propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.  Além das [propriedades de proxy padrão](object#proxy), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |hosts|array|[Hosts](/manual/api/reference/host/object) a serem monitorados pelo proxy. Se um host já for monitorado por um proxy diferente, ele será reatribuído ao proxy atual.<br><br>Os hosts devem ter a propriedade `hostid` definida.| |interface|object|Host [interface](/manual/api/reference/hostinterface/object) para substituir a interface existente para o proxy passivo.|

en-us	### Parameters  `(object/array)` Regular expression properties to be updated.  The `regexpid` property must be defined for each object, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard properties](object#expressions), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |expressions|array|[Expressions](/manual/api/reference/regexp/object#expressions) options.|
pt-br	### Parâmetros      `(object/array)` Propriedades de expressão regular a serem atualizadas.      A propriedade `regexpid` deve ser definida para cada objeto, todas as outras propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.      Além das [propriedades padrão](object#expressions_object), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição|   |--|--|------| |expressions|array|[Expressões](/manual/api/reference/regexp/object#expressions_object) opções.|

en-us	### Parameters  `(object/array)` Role properties to be updated.  The `roleid` property must be defined for each role, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard role properties](object#role) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |rules|array|Access [rules](object#role_rules) to replace the current access rules assigned to the role.|
pt-br	### Parâmetros      `(object/array)` Propriedades da função a serem atualizadas.  A propriedade `roleid` deve ser definida para cada função, todas as outras propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.      Além das [propriedades de função padrão](object#role), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |rules|array|Acesse [rules](object#role_rules) para substituir as regras de acesso atuais atribuídas à função.|

en-us	### Parameters  `(object/array)` Roles to create.  Additionally to the [standard role properties](object#role), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |rules|array|Role [rules](object#role_rules) to be created for the role.|
pt-br	### Parâmetros  `(object/array)` Funções para criar.  Além das [propriedades de função padrão](object#role), o método aceita os seguintes parâmetros.      |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |rules|array|Função [rules](object#role_rules) a ser criada para a função.|

en-us	### Parameters  `(object/array)` [Script properties](object#script) to be updated.  The `scriptid` property must be defined for each script, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. An exception is `type` property change from 5 (Webhook) to other: the `parameters` property will be cleaned.
pt-br	### Parâmetros      `(object/array)` [Propriedades do script](object#script) a ser atualizado.      A propriedade `scriptid` deve ser definida para cada script, todas as outras propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas. Uma exceção é a mudança da propriedade `type` de 5 (Webhook) para outra: a propriedade `parameters` será limpa.

en-us	### Parameters  `(object/array)` Scripts to create.  The method accepts scripts with the [standard script properties](/manual/api/reference/script/object#script).
pt-br	### Parâmetros      `(objeto/array)` Scripts para criar.      O método aceita scripts com as [propriedades de script padrão](/manual/api/reference/script/object#script).

en-us	### Parameters  `(object/array)` service properties to be updated.  The `serviceid` property must be defined for each service, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard service properties](object#service), the method accepts the following parameters.  | Parameter     | [Type](/manual/api/reference_commentary#data_types) | Description                                                                                                             | |---------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------| | children      | array                                               | Child services to replace the current service children.<br><br>The children must have the `serviceid` property defined. | | parents       | array                                               | Parent services to replace the current service parents.<br><br>The parents must have the `serviceid` property defined.  | | tags          | array                                               | Service [tags](/manual/api/reference/service/object#service_tag) to replace the current service tags.                   | | problem\_tags | array                                               | [Problem tags](/manual/api/reference/service/object#problem_tag) to replace the current problem tags.                   | | status\_rules | array                                               | [Status rules](/manual/api/reference/service/object#status_rule) to replace the current status rules.                   |
pt-br	### Parameters  `(object/array)` propriedades de serviço a serem atualizadas.  A propriedade `serviceid` deve ser definida para cada serviço, todas as outras propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.      Além das [propriedades de serviço padrão](object#service), o método aceita os seguintes parâmetros.      | Parâmetro | [Tipo](/manual/api/reference_commentary#data_types) | Descrição                                                                                                             | |---------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------| | children      | array                                               | Serviços filho para substituir os serviços filhos do serviço atual.<br><br>Os serviços filhos devem ter a propriedade `serviceid` definida. | | parents       | array                                               | Serviços pai para substituir os pais de serviço atuais.<br><br>Os pais devem ter a propriedade `serviceid` definida.  | | tags          | array                                               | [Etiquetas](/manual/api/reference/service/object#service_tag) de serviço para substituir as etiquetas de serviço atuais.                   | | problem\_tags | array                                               | [Etiquetas de problema](/manual/api/reference/service/object#problem_tag) para substituir as etiquetas de problema atuais.                   | | status\_rules | array                                               | [Regras de status](/manual/api/reference/service/object#status_rule) para substituir as regras de status atuais.                   |

en-us	### Parameters  `(object/array)` services to create.  Additionally to the [standard service properties](object#service), the method accepts the following parameters.  | Parameter     | [Type](/manual/api/reference_commentary#data_types) | Description                                                                                                 | |---------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------| | children      | array                                               | Child services to be linked to the service.<br><br>The children must have the `serviceid` property defined. | | parents       | array                                               | Parent services to be linked to the service.<br><br>The parents must have the `serviceid` property defined. | | tags          | array                                               | Service [tags](/manual/api/reference/service/object#service_tag) to be created for the service.             | | problem\_tags | array                                               | [Problem tags](/manual/api/reference/service/object#problem_tag) to be created for the service.             | | status\_rules | array                                               | [Status rules](/manual/api/reference/service/object#status_rule) to be created for the service.             |
pt-br	### Parâmetros      serviços `(objeto/array)` para criar.      Além das [propriedades de serviço padrão](object#service), o método aceita os seguintes parâmetros.      | Parâmetro | [Tipo](/manual/api/reference_commentary#data_types) | Descrição                                                                                                 | |---------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------| | children      | array                                               | Serviços filho a serem vinculados ao serviço.<br><br>Os serviços filhos devem ter a propriedade `serviceid` definida. | | parents       | array                                               | Serviços pai a serem vinculados ao serviço.<br><br>Os serviços pais devem ter a propriedade `serviceid` definida. | | tags          | array                                               | [Etiqueta](/manual/api/reference/service/object#service_tag) de serviço a ser criada para o serviço.             | | problem\_tags | array                                               | [Etiquetas de problema](/manual/api/reference/service/object#problem_tag) a serem criadas para o serviço.             | | status\_rules | array                                               | [Regras de status](/manual/api/reference/service/object#status_rule) a serem criadas para o serviço.             |

en-us	### Parameters  `(object/array)` SLA objects to create.  Additionally to the [standard SLA properties](object#sla), the method accepts the following parameters.  | Parameter                      | [Type](/manual/api/reference_commentary#data_types) | Description                                                                                                                                 | |--------------------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------| | **service_tags**<br>(required) | array                                               | SLA service tags to be created for the SLA.<br>At least one service tag must be specified.                                                  | | schedule                       | array                                               | SLA schedule to be created for the SLA.<br>Specifying an empty parameter will be interpreted as a 24x7 schedule.<br>Default: 24x7 schedule. | | excluded_downtimes             | array                                               | SLA excluded downtimes to be created for the SLA.                                                                                           |
pt-br	### Parâmetros      `(object/array)` Objetos SLA para criar.      Além das [propriedades de SLA padrão](object#sla), o método aceita os seguintes parâmetros.      | Parâmetro | [Tipo](/manual/api/reference_commentary#data_types) | Descrição                                                                                                                                 | |--------------------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------| | **service_tags**<br>(requerido) | array                                               | Etiquetas de serviço SLA a serem criadas para o SLA.<br>Pelo menos uma etiqueta de serviço deve ser especificada.                                                  | | schedule                       | array                                               | Programação de SLA a ser criada para o SLA.<br>A especificação de um parâmetro vazio será interpretada como uma programação 24 horas por dia, 7 dias por semana.<br>Padrão: programação 24 horas por dia, 7 dias por semana. | | excluded_downtimes             | array                                               | SLA excluídos tempos de inatividade a serem criados para o SLA.                                                                                           |

en-us	### Parameters  `(object/array)` SLA properties to be updated.  The `slaid` property must be defined for each SLA, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard SLA properties](object#sla), the method accepts the following parameters.  | Parameter           | [Type](/manual/api/reference_commentary#data_types) | Description                                                                                                                                                            | |---------------------|-----------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | service\_tags       | array                                               | SLA [service tags](/manual/api/reference/sla/object#sla-service-tag) to replace the current SLA service tags.<br><br>At least one service tag must be specified.       | | schedule            | array                                               | SLA [schedule](/manual/api/reference/sla/object#sla-schedule) to replace the current one.<br><br>Specifying parameter as empty will be interpreted as a 24x7 schedule. | | excluded\_downtimes | array                                               | SLA [excluded downtimes](/manual/api/reference/sla/object#sla-excluded-downtime) to replace the current ones.                                                          |
pt-br	### Parâmetros      `(object/array)` Propriedades de SLA a serem atualizadas.      A propriedade `slaid` deve ser definida para cada SLA, todas as outras propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.      Além das [propriedades de SLA padrão](object#sla), o método aceita os seguintes parâmetros.      | Parâmetro | [Tipo](/manual/api/reference_commentary#data_types) | Descrição                                                                                                                                                            | |---------------------|-----------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | service\_tags       | array                                               | SLA [service_tags](/manual/api/reference/sla/object#sla-service-tag) para substituir as atuais etiquetas de serviço SLA.<br><br>Pelo menos uma etiqueta de serviço deve ser especificada.       | | schedule            | array                                               | SLA [schedule](/manual/api/reference/sla/object#sla-schedule) para substituir o atual.<br><br>Especificar o parâmetro como vazio será interpretado como uma programação 24x7. | | excluded\_downtimes | array                                               | SLA [excluded_downtimes](/manual/api/reference/sla/object#sla-excluded-downtime) para substituir os atuais.                                                          |

en-us	### Parameters  `(object/array)` Template dashboard properties to be updated.  The `dashboardid` property must be specified for each dashboard, all other properties are optional. Only the specified properties will be updated.  Additionally to the [standard template dashboard properties](object#template_dashboard), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |pages|array|Template dashboard [pages](object#template_dashboard_page) to replace the existing dashboard pages.<br><br>Dashboard pages are updated by the `dashboard_pageid` property. New dashboard pages will be created for objects without `dashboard_pageid` property and the existing dashboard pages will be deleted if not reused. Dashboard pages will be ordered in the same order as specified. Only the specified properties of the dashboard pages will be updated. At least one dashboard page object is required for `pages` property.|
pt-br	### Parâmetros  `(object/array)` Propriedades do painel do modelo a serem atualizadas.  A propriedade `dashboardid` deve ser especificada para cada painel, todas as outras propriedades são opcionais. Somente as propriedades especificadas serão atualizadas.  Além das [propriedades do painel de modelo padrão](object#template_dashboard), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |páginas|array|[páginas](object#template_dashboard_page) de painel de modelo para substituir as páginas de painel existentes.<br><br>As páginas do painel são atualizadas pela propriedade `dashboard_pageid`. Novas páginas de painel serão criadas para objetos sem a propriedade `dashboard_pageid` e as páginas de painel existentes serão excluídas se não forem reutilizadas. As páginas do painel serão ordenadas na mesma ordem especificada. Somente as propriedades especificadas das páginas do painel serão atualizadas. Pelo menos um objeto de página do painel é necessário para a propriedade `pages`.|

en-us	### Parameters  `(object/array)` Template dashboards to create.  Additionally to the [standard template dashboard properties](object#template_dashboard), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**pages**<br>(required)|array|Template dashboard [pages](object#dashboard_page) to be created for the dashboard. Dashboard pages will be ordered in the same order as specified. At least one dashboard page object is required for `pages` property.|
pt-br	### Parâmetros  `(object/array)` Painéis de modelo a serem criados.  Além das [propriedades do painel de modelo padrão](object#template_dashboard), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**páginas**<br>(obrigatório)|array|[Páginas](object#dashboard_page) de painel de modelo a serem criadas para o painel. As páginas do painel serão ordenadas na mesma ordem específica. Pelo menos um objeto de página do painel é necessário para a `página` propriedade.|

en-us	### Parameters  `(object/array)` Templates to create.  Additionally to the [standard template properties](object#template), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groups**<br>(required)|object/array|Host [groups](/manual/api/reference/hostgroup/object) to add the template to.<br><br>The host groups must have the `groupid` property defined.| |tags|object/array|Template [tags](/manual/api/reference/template/object#template_tag).| |templates|object/array|[Templates](/manual/api/reference/template/object) to be linked to the template.<br><br>The templates must have the `templateid` property defined.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the template.|
pt-br	### Parâmetros      `(object/array)` Modelos para criar.      Além das [propriedades de modelo padrão](object#template), o método aceita os seguintes parâmetros.      |Parâmetro|[Type](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**groups**<br>(requerido)|object/array|Host [grupos](/manual/api/reference/hostgroup/object) para adicionar o modelo.<br><br>Os grupos de host devem ter a propriedade `groupid` definida.| |tags|object/array|Modelo [etiquetas](/manual/api/reference/template/object#template_tag).| |templates|object/array|[Modelos](/manual/api/reference/template/object) a serem vinculados ao modelo.<br><br>Os modelos devem ter a propriedade `templateid` definida.| |macros|object/array|[Macros do usuário](/manual/api/reference/usermacro/object) a serem criadas para o modelo.|

en-us	### Parameters  `(object/array)` Token properties to be updated.  The `tokenid` property must be defined for each token, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  The method accepts tokens with the [standard token properties](object).
pt-br	### Parâmetros      `(object/array)` Propriedades do token a serem atualizadas.      A propriedade `tokenid` deve ser definida para cada token, todas as outras propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.  O método aceita tokens com as [propriedades de token padrão](object).

en-us	### Parameters  `(object/array)` Tokens to create.  The method accepts tokens with the [standard token properties](object).
pt-br	### Parâmetros      `(objeto/array)` Tokens para criar.      O método aceita tokens com as [propriedades de token padrão](object).

en-us	### Parameters  `(object/array)` Trigger dependencies to create.  Each trigger dependency has the following parameters:  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**triggerid**<br>(required)|string|ID of the dependent trigger.| |**dependsOnTriggerid**<br>(required)|string|ID of the trigger that the trigger depends on.|
pt-br	### Parâmetros      `(object/array)` Dispara dependências para criar.      Cada dependência de trigger tem os seguintes parâmetros:      |Parâmetro|[Type](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**triggerid**<br>(requerido)|string|ID da trigger dependente.| |**dependsOnTriggerid**<br>(requerido)|string|ID da trigger do qual a trigger depende.|

en-us	### Parameters  `(object/array)` Trigger properties to be updated.  The `triggerid` property must be defined for each trigger, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard trigger properties](object#trigger) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dependencies|array|Triggers that the trigger is dependent on.<br><br>The triggers must have the `triggerid` property defined.| |tags|array|Trigger [tags.](/manual/api/reference/trigger/object#trigger_tag)|  ::: noteimportant The trigger expression has to be given in its expanded form. :::
pt-br	### Parâmetros      `(object/array)` Propriedades da trigger a serem atualizadas.      A propriedade `triggerid` deve ser definida para cada trigger, todas as outras propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.      Além das [propriedades padrão da trigger](object#trigger), o método aceita os seguintes parâmetros.      |Parâmetro|[Type](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |dependencies|array|Acionadores dos quais a trigger depende.<br><br>As trigger devem ter a propriedade `triggerid` definida.| |tags|array|Trigger [tags.](/manual/api/reference/trigger/object#trigger_tag)|  ::: noteimportant A expressão de trigger deve ser fornecida em sua forma expandida. :::

en-us	### Parameters  `(object/array)` Trigger prototypes to create.  Additionally to the [standard trigger prototype properties](object#trigger_prototype) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dependencies|array|Triggers and trigger prototypes that the trigger prototype is dependent on.<br><br>The triggers must have the `triggerid` property defined.| |tags|array|Trigger prototype [tags](/manual/api/reference/triggerprototype/object#trigger_prototype_tag).|  ::: noteimportant The trigger expression has to be given in its expanded form and must contain at least one item prototype. :::
pt-br	### Parameters  `(object/array)` Criar protótipos de trigger.  Além das [propriedades de protótipo de trigger padrão](object#trigger_prototype), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |dependencies|array|Trigger e protótipos de trigger dos quais o protótipo de trigger depende.<br><br>As triggers devem ter a propriedade `triggerid` definida.| |tags|array| [Etiquetas](/manual/api/reference/triggerprototype/object#trigger_prototype_tag) de Protótipo de trigger. |  ::: noteimportant A expressão de trigger deve ser fornecida em sua forma expandida e deve conter pelo menos um protótipo de item. :::

en-us	### Parameters  `(object/array)` Triggers to create.  Additionally to the [standard trigger properties](object#trigger) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dependencies|array|Triggers that the trigger is dependent on.<br><br>The triggers must have the `triggerid` property defined.| |tags|array|Trigger [tags.](/manual/api/reference/trigger/object#trigger_tag)|  ::: noteimportant The trigger expression has to be given in its expanded form. :::
pt-br	### Parâmetros      `(objeto/array)` Triggers para criar.      Além das [propriedades padrão do gatilho](object#trigger), o método aceita os seguintes parâmetros.      |Parâmetro|[Type](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |dependencies|array|Triggers dos quais o trigger é dependente.<br><br>As triggers devem ter a propriedade `triggerid` definida.|   |tags|array|Trigger [tags.](/manual/api/reference/trigger/object#trigger_tag)|      ::: noteimportant   A expressão de trigger deve ser fornecida em sua forma expandida. :::

en-us	### Parameters  `(object/array)` User groups to create.  Additionally to the [standard user group properties](object#user_group), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |rights|object/array|[Permissions](/manual/api/reference/usergroup/object#permission) to assign to the group| |tag\_filters|array|[Tag based permissions](/manual/api/reference/usergroup/object#tag_based_permission) to assign to the group| |users|object/array|[Users](/manual/api/reference/user/create) to add to the user group.<br><br>The user must have the `userid` property defined.|
pt-br	### Parameters  `(object/array)` Grupos de usuários a serem criados.  Álem dos  [standard user group properties](object#user_group), o método aceito os seguinte parâmetros. ### Parâmetros      `(object/array)` Grupos de usuários a serem criados.      Além das [propriedades do grupo de usuários padrão](object#user_group), o método aceita os seguintes parâmetros.      |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |rights|object/array|[Permissões](/manual/api/reference/usergroup/object#permission) para atribuir ao grupo| |tag\_filters|array|[Permissões baseadas em etiquetas](/manual/api/reference/usergroup/object#tag_based_permission) para atribuir ao grupo| |users|object/array|[Usuários](/manual/api/reference/user/create) para adicionar ao grupo de usuários.<br><br>O usuário deve ter a propriedade `userid` definida.| |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |rights|object/array|[Permissions](/manual/api/reference/usergroup/object#permission) to assign to the group| |tag\_filters|array|[Tag based permissions](/manual/api/reference/usergroup/object#tag_based_permission) to assign to the group| |users|object/array|[Users](/manual/api/reference/user/create) to add to the user group.<br><br>The user must have the `userid` property defined.|

en-us	### Parameters  `(object/array)` Users to create.  Additionally to the [standard user properties](object#user), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**passwd**<br>*(required)*|string|User's password.<br><br>Can be omitted if user is added only to groups that have LDAP access.| |**usrgrps**<br>(required)|array|User [groups](/manual/api/reference/user/create) to add the user to.<br><br>The user groups must have the `usrgrpid` property defined.| |medias|array|User [media](/manual/api/reference/user/object#media) to be created.|
pt-br	### Parâmetros    `(objeto/array)` Usuários a serem criados.    Além das [propriedades de usuário padrão](object#user), o método aceita os seguintes parâmetros.    |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**passwd**<br>*(requerido)*|string|Senha do usuário.<br><br>Pode ser omitido se o usuário for adicionado apenas a grupos que tenham acesso LDAP.| |**usrgrps**<br>(requerido)|array|Usuário [grupos](/manual/api/reference/user/create) ao qual adicionar o usuário.<br><br>Os grupos de usuários devem ter a propriedade `usrgrpid` definida.| |medias|array|Usuário [mídia](/manual/api/reference/user/object#media) a ser criado.|

en-us	### Parameters  `(object/array)` Web scenario properties to be updated.  The `httptestid` property must be defined for each web scenario, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |steps|array|Scenario [steps](/manual/api/reference/httptest/object#scenario_step) to replace existing steps.| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)|
pt-br	### Parâmetros  `(object/array)` Propriedades do cenário da Web a serem atualizadas.  A propriedade `httptestid` deve ser definida para cada cenário web, todos   outras propriedades são opcionais. Somente as propriedades passadas serão   atualizado, todos os outros permanecerão inalterados.  Além das [propriedades padrão do cenário da web](object#web_scenario),  o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |steps|array|Cenário [etapas](/manual/api/reference/httptest/object#scenario_step) para substituir as etapas existentes.| |tags|array|Cenário Web [tags.](/manual/api/reference/httptest/object#web_scenario_tag)|

en-us	### Parameters  `(object/array)` Web scenarios to create.  Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**steps**<br>(required)|array|Web scenario [steps](/manual/api/reference/httptest/object#scenario_step).| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)|
pt-br	### Parâmetros  `(object/array)` criar Cenários Web.  Além das [propriedades padrão do cenário da web](object#web_scenario),  o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**steps**<br>(requerido)|array|Cenário Web [steps](/manual/api/reference/httptest/object#scenario_step).| |tags|array|Cenário Web [tags.](/manual/api/reference/httptest/object#web_scenario_tag)|

en-us	### Parameters  `(object)` Authentication properties to be updated.
pt-br	### Parâmetros  `(object)` Propriedades de autenticação a serem atualizadas.

en-us	### Parameters  `(object)` Autoregistration properties to be updated.
pt-br	### Parâmetros  `(object)` Propriedades de autoregistro a serem atualizadas.

en-us	### Parameters  `(object)` Housekeeping properties to be updated.
pt-br	### Parâmetros  `(object)` Propriedades de limpeza a serem atualizadas.

en-us	### Parameters  `(object)` Parameters containing the data to import and rules how the data should be handled.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**format**<br>(required)|string|Format of the serialized string.<br><br>Possible values:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON.| |**source**<br>(required)|string|Serialized string containing the configuration data.| |**rules**<br>(required)|object|Rules on how new and existing objects should be imported.<br><br>The `rules` parameter is described in detail in the table below.|  ::: notetip If no rules are given, the configuration will not be updated. :::  The `rules` object supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |discoveryRules|object|Rules on how to import LLD rules.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new LLD rules will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing LLD rules will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, LLD rules not present in the imported data will be deleted from the database; default: `false`.| |graphs|object|Rules on how to import graphs.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new graphs will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing graphs will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, graphs not present in the imported data will be deleted from the database; default: `false`.| |groups|object|Rules on how to import host groups.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new host groups will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing host groups will be updated; default: `false`.| |hosts|object|Rules on how to import hosts.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new hosts will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing hosts will be updated; default: `false`.| |httptests|object|Rules on how to import web scenarios.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new web scenarios will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing web scenarios will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, web scenarios not present in the imported data will be deleted from the database; default: `false`.| |images|object|Rules on how to import images.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new images will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing images will be updated; default: `false`.| |items|object|Rules on how to import items.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new items will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing items will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, items not present in the imported data will be deleted from the database; default: `false`.| |maps|object|Rules on how to import maps.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new maps will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing maps will be updated; default: `false`.| |mediaTypes|object|Rules on how to import media types.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new media types will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing media types will be updated; default: `false`.| |templateLinkage|object|Rules on how to import template links.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new links between templates and host will be created; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, template links not present in the imported data will be deleted from the database; default: `false`.| |templates|object|Rules on how to import templates.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new templates will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing templates will be updated; default: `false`.| |templateDashboards|object|Rules on how to import template dashboards.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new template dashboards will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing template dashboards will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, template dashboards not present in the imported data will be deleted from the database; default: `false`.| |triggers|object|Rules on how to import triggers.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new triggers will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing triggers will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, triggers not present in the imported data will be deleted from the database; default: `false`.| |valueMaps|object|Rules on how to import host or template value maps.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new value maps will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing value maps will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, value maps not present in the imported data will be deleted from the database; default: `false`.|
pt-br	### Parâmetros  `(object)` Parâmetros contendo os dados a serem importados e regras de como o dados devem ser tratados.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**formato**<br>(obrigatório)|string|Formato da string serializada.<br><br>Valores possíveis:<br>`yaml` - YAML;<br>`xml` - XML;<br >`json` - JSON.| |**source**<br>(obrigatório)|string|String serializada contendo os dados de configuração.| |**rules**<br>(obrigatório)|object|Regras sobre como objetos novos e existentes devem ser importados.<br><br>O parâmetro `rules` é descrito em detalhes na tabela abaixo.|  ::: dica Se nenhuma regra for fornecida, a configuração não será Atualizada. :::  O objeto `rules` suporta os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |discoveryRules|object|Regras sobre como importar regras LLD.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novas regras LLD serão criadas; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, as regras LLD existentes serão atualizadas; default: `false`;<br>`deleteMissing` - `(boolean)` se definido como `true`, as regras LLD não presentes nos dados importados serão excluídas do banco de dados; padrão: `falso`.| |graphs|object|Regras sobre como importar gráficos.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos gráficos serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os gráficos existentes serão atualizados; default: `false`;<br>`deleteMissing` - `(boolean)` se definido como `true`, os gráficos não presentes nos dados importados serão excluídos do banco de dados; padrão: `falso`.| |groups|object|Regras sobre como importar grupos de hosts.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos grupos de hosts serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os grupos de hosts existentes serão atualizados; padrão: `falso`.| |hosts|object|Regras sobre como importar hosts.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos hosts serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os hosts existentes serão atualizados; padrão: `falso`.| |httptests|object|Regras sobre como importar cenários da web.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos cenários da web serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os cenários da web existentes serão atualizados; default: `false`;<br>`deleteMissing` - `(boolean)` se definido como `true`, os cenários da web não presentes nos dados importados serão excluídos do banco de dados; padrão: `falso`.| |images|object|Regras sobre como importar imagens.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novas imagens serão criadas; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, as imagens existentes serão atualizadas; padrão: `falso`.| |items|object|Regras sobre como importar itens.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos itens serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os itens existentes serão atualizados; default: `false`;<br>`deleteMissing` - `(boolean)` se definido como `true`, os itens não presentes nos dados importados serão excluídos do banco de dados; padrão: `falso`.| |maps|object|Regras sobre como importar mapas.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos mapas serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os mapas existentes serão atualizados; padrão: `falso`.| |mediaTypes|object|Regras sobre como importar tipos de mídia.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos tipos de mídia serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os tipos de mídia existentes serão atualizados; padrão: `falso`.| |templateLinkage|object|Regras sobre como importar links de modelo.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos links entre os modelos e o host serão criados ; default: `false`;<br>`deleteMissing` - `(boolean)` se definido como `true`, os links de modelo não presentes nos dados importados serão excluídos do banco de dados; padrão: `falso`.| |templates|object|Regras sobre como importar modelos.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos modelos serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os modelos existentes serão atualizados; padrão: `falso`.| |templateDashboards|object|Regras sobre como importar painéis de modelo.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos painéis de modelo serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os painéis de modelos existentes serão atualizados; default: `false`;<br>`deleteMissing` - `(boolean)` se definido como `true`, os painéis de modelo não presentes nos dados importados serão excluídos do banco de dados; padrão: `falso`.| |triggers|object|Regras sobre como importar gatilhos.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos gatilhos serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os gatilhos existentes serão atualizados; default: `false`;<br>`deleteMissing` - `(boolean)` se definido como `true`, triggers não presentes nos dados importados serão excluídos do banco de dados; padrão: `falso`.| |valueMaps|object|Regras sobre como importar mapas de valor de host ou modelo.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos mapas de valor serão criados ; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os mapas de valores existentes serão atualizados; default: `false`;<br>`deleteMissing` - `(boolean)` se definido como `true`, os mapas de valores não presentes nos dados importados serão excluídos do banco de dados; padrão: `falso`.|

en-us	### Parameters  `(object)` Parameters containing the host interfaces to be created on the given hosts.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**hosts**<br>(required)|object/array|Hosts to be updated.<br><br>The hosts must have the `hostid` property defined.| |**interfaces**<br>(required)|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to create on the given hosts.|
pt-br	### Parâmetros  `(object)` Parâmetros contendo as interfaces do host a serem criadas os hospedeiros dados.  O método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**hosts**<br>(obrigatório)|object/array|Hosts a serem atualizados.<br><br>Os hosts devem ter a propriedade `hostid` definida.| |**interfaces**<br>(obrigatório)|object/array|[Interfaces de host](/manual/api/reference/hostinterface/object) para criar nos hosts fornecidos.|

en-us	### Parameters  `(object)` Parameters containing the ID of the host to be updated and the new host interfaces.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**hostid**<br>(required)|string|ID of the host to be updated.| |**interfaces**<br>(required)|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to replace the current host interfaces with.|
pt-br	### Parâmetros  Parâmetros `(object)` contendo o ID do host a ser atualizado e as novas interfaces de host.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**hostid**<br>(obrigatório)|string|ID do host a ser atualizado.| |**interfaces**<br>(obrigatório)|object/array|[Interfaces de host](/manual/api/reference/hostinterface/object) para substituir as interfaces de host atuais.|

en-us	### Parameters  `(object)` Parameters containing the ID of the script to run and either the ID of the host or the ID of the event.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**scriptid**<br>(required)|string|ID of the script to run.| |hostid|string|ID of the host to run the script on.| |eventid|string|ID of the event to run the script on.|
pt-br	### Parâmetros      `(object)` Parâmetros contendo o ID do script a ser executado e o ID do host ou o ID do evento.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**scriptid**<br>(requerido)|string|ID do script a ser executado.| |hostid|string|ID do host para executar o script.| |eventid|string|ID do evento para executar o script.|

en-us	### Parameters  `(object)` Parameters containing the IDs of the host groups to update and the objects that should be removed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**groupids**<br>(required)|string/array|IDs of the host groups to be updated.| |hostids|string/array|Hosts to remove from all host groups.| |templateids|string/array|Templates to remove from all host groups.|
pt-br	### Parâmetros  Parâmetros `(object)` contendo os IDs dos grupos de hosts a serem atualizados e os objetos que devem ser removidos.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**groupids**<br>(obrigatório)|string/array|IDs dos grupos de hosts a serem atualizados.| |hostids|string/array|Hosts a serem removidos de todos os grupos de hosts.| |templateids|string/array|Modelos a serem removidos de todos os grupos de hosts.|

en-us	### Parameters  `(object)` Parameters containing the IDs of the host groups to update and the objects that should be updated.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**groups**<br>(required)|object/array|Host groups to be updated.<br><br>The host groups must have the `groupid` property defined.| |**hosts**<br>(required)|object/array|Hosts to replace the current hosts on the given host groups.<br>All other hosts, except the ones mentioned, will be excluded from host groups.<br>Discovered hosts will not be affected.<br><br>The hosts must have the `hostid` property defined.| |**templates**<br>(required)|object/array|Templates to replace the current templates on the given host groups.<br>All other templates, except the ones mentioned, will be excluded from host groups.<br><br>The templates must have the `templateid` property defined.|
pt-br	### Parâmetros  Parâmetros `(object)` contendo os IDs dos grupos de hosts a serem atualizados e os objetos que devem ser atualizados.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**grupos**<br>(obrigatório)|objeto/array|Grupos de hosts a serem atualizados.<br><br>Os grupos de hosts devem ter a propriedade `groupid` definida.| |**hosts**<br>(obrigatório)|object/array|Hosts para substituir os hosts atuais nos grupos de hosts fornecidos.<br>Todos os outros hosts, exceto os mencionados, serão excluídos dos grupos de hosts.<br> >Os hosts descobertos não serão afetados.<br><br>Os hosts devem ter a propriedade `hostid` definida.| |**modelos**<br>(obrigatório)|objeto/array|Modelos para substituir os modelos atuais nos grupos de hosts especificados.<br>Todos os outros modelos, exceto os mencionados, serão excluídos dos grupos de hosts.<br> ><br>Os templates devem ter a propriedade `templateid` definida.|

en-us	### Parameters  `(object)` Parameters containing the IDs of the host groups to update and the objects to add to all the host groups.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groups**<br>(required)|object/array|Host groups to be updated.<br><br>The host groups must have the `groupid` property defined.| |hosts|object/array|Hosts to add to all host groups.<br><br>The hosts must have the `hostid` property defined.| |templates|object/array|Templates to add to all host groups.<br><br>The templates must have the `templateid` property defined.|
pt-br	### Parâmetros  `(object)` Todos os parâmetros de identificação dos grupos de hosts foram atualizados e os objetos a serem adicionados a todos os grupos de hosts.  O método aceita os seguintes parâmetros.  |Parâmetros|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**groups**<br>(requerido)|object/array|Grupos de hosts a serem atualizados.<br><br>Os grupos de hosts devem ter a propriedade `groupid` definida.| |hosts|object/array|Hosts para adicionar a todos os grupos de hosts.<br><br>Os hosts devem ter a propriedade `hostid` definida.| |templates|object/array|Modelos para adicionar a todos os grupos de hosts.<br><br>Os templates devem ter a propriedade `templateid` definida.|

en-us	### Parameters  `(object)` Parameters containing the IDs of the hosts to be updated and the interfaces to be removed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**hostids**<br>(required)|string/array|IDs of the hosts to be updated.| |**interfaces**<br>(required)|object/array|Host interfaces to remove from the given hosts.<br><br>The host interface object must have the ip, dns and port properties defined|
pt-br	### Parâmetros  `(object)` Parâmetros contendo os IDs dos hosts a serem atualizados e as interfaces a serem removidas.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**hostids**<br>(obrigatório)|string/array|IDs dos hosts a serem atualizados.| |**interfaces**<br>(obrigatório)|objeto/array|Interfaces de host a serem removidas dos hosts fornecidos.<br><br>O objeto de interface de host deve ter as propriedades de ip, dns e porta definidas|

en-us	### Parameters  `(object)` Parameters containing the IDs of the hosts to update and the objects that should be removed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**hostids**<br>(required)|string/array|IDs of the hosts to be updated.| |groupids|string/array|Host groups to remove the given hosts from.| |interfaces|object/array|Host interfaces to remove from the given hosts.<br><br>The host interface object must have the `ip`, `dns` and `port` properties defined.| |macros|string/array|User macros to delete from the given hosts.| |templateids|string/array|Templates to unlink from the given hosts.| |templateids\_clear|string/array|Templates to unlink and clear from the given hosts.|
pt-br	### Parâmetros  Parâmetros `(object)` contendo os IDs dos hosts a serem atualizados e o objetos que devem ser removidos.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**hostids**<br>(obrigatório)|string/array|IDs dos hosts a serem atualizados.| |groupids|string/array|Grupos de hosts dos quais remover os hosts fornecidos.| |interfaces|object/array|Interfaces de host a serem removidas dos hosts fornecidos.<br><br>O objeto de interface de host deve ter as propriedades `ip`, `dns` e `port` definidas.| |macros|string/array|Macros de usuário a serem excluídos dos hosts fornecidos.| |templateids|string/array|Modelos para desvincular dos hosts fornecidos.| |templateids\_clear|string/array|Modelos para desvincular e limpar dos hosts fornecidos.|

en-us	### Parameters  `(object)` Parameters containing the IDs of the hosts to update and the objects to add to all the hosts.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**hosts**<br>(required)|object/array|Hosts to be updated.<br><br>The hosts must have the `hostid` property defined.| |groups|object/array|Host groups to add to the given hosts.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to be created for the given hosts.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the given hosts.| |templates|object/array|Templates to link to the given hosts.<br><br>The templates must have the `templateid` property defined.|
pt-br	### Parâmetros  Parâmetros `(object)` contendo os IDs dos hosts a serem atualizados e o objetos para adicionar a todos os hosts.  O método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**hosts**<br>(obrigatório)|object/array|Hosts a serem atualizados.<br><br>Os hosts devem ter a propriedade `hostid` definida.| |grupos|objeto/array|Grupos de hosts para adicionar aos hosts fornecidos.<br><br>Os grupos de hosts devem ter a propriedade `groupid` definida.| |interfaces|object/array|[Interfaces de host](/manual/api/reference/hostinterface/object) a serem criadas para os hosts fornecidos.| |macros|object/array|[Macros do usuário](/manual/api/reference/usermacro/object) a serem criados para os hosts fornecidos.| |templates|object/array|Modelos para vincular aos hosts fornecidos.<br><br>Os templates devem ter a propriedade `templateid` definida.|

en-us	### Parameters  `(object)` Parameters containing the IDs of the hosts to update and the properties that should be updated.  Additionally to the [standard host properties](object#host), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**hosts**<br>(required)|object/array|[Hosts](/manual/api/reference/host/object) to be updated.<br><br>The hosts must have the `hostid` property defined.| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object) to replace the current host groups the hosts belong to.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|Host [interfaces](/manual/api/reference/hostinterface/object) to replace the current host interfaces on the given hosts.| |inventory|object|Host [inventory](/manual/api/reference/host/object#host_inventory) properties.<br><br>Host inventory mode cannot be updated using the `inventory` parameter, use `inventory_mode` instead.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to replace the current user macros on the given hosts.| |templates|object/array|[Templates](/manual/api/reference/template/object) to replace the currently linked templates on the given hosts.<br><br>The templates must have the `templateid` property defined.| |templates\_clear|object/array|[Templates](/manual/api/reference/template/object) to unlink and clear from the given hosts.<br><br>The templates must have the `templateid` property defined.|
pt-br	### Parâmetros  Parâmetros `(object)` contendo os IDs dos hosts a serem atualizados e o propriedades que devem ser atualizadas.  Além das [propriedades padrão do host](object#host), o método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**hosts**<br>(obrigatório)|object/array|[Hosts](/manual/api/reference/host/object) a serem atualizados.<br><br>Os hosts devem ter o `hostid` propriedade definida.| |grupos|objeto/array|Host [grupos](/manual/api/reference/hostgroup/object) para substituir os grupos de hosts atuais aos quais os hosts pertencem.<br><br>Os grupos de hosts devem ter a propriedade `groupid` definido.| |interfaces|object/array|Host [interfaces](/manual/api/reference/hostinterface/object) para substituir as interfaces de host atuais nos hosts fornecidos.| |inventory|object|Host [inventory](/manual/api/reference/host/object#host_inventory) propriedades.<br><br>O modo de inventário do host não pode ser atualizado usando o parâmetro `inventory`, use `inventory_mode`. | |macros|object/array|[Macros de usuário](/manual/api/reference/usermacro/object) para substituir as macros de usuário atuais nos hosts fornecidos.| |templates|object/array|[Templates](/manual/api/reference/template/object) para substituir os templates atualmente vinculados nos hosts fornecidos.<br><br>Os templates devem ter a propriedade `templateid` definida. | |templates\_clear|object/array|[Templates](/manual/api/reference/template/object) para desvincular e limpar dos hosts fornecidos.<br><br>Os templates devem ter a propriedade `templateid` definida. |

en-us	### Parameters  `(object)` Parameters containing the IDs of the templates to update and the objects that should be removed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**templateids**<br>(required)|string/array|IDs of the templates to be updated.| |groupids|string/array|Host groups to remove the given templates from.| |macros|string/array|User macros to delete from the given templates.| |templateids\_clear|string/array|Templates to unlink and clear from the given templates (upstream).| |templateids\_link|string/array|Templates to unlink from the given templates (upstream).|
pt-br	### Parâmetros  `(object)` Parâmetros contendo os IDs dos templates a serem atualizados e os objetos que devem ser removidos.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**templateids**<br>(required)|string/array|IDs dos templates a serem atualizados.| |groupids|string/array|Grupos de hosts dos quais remover os templates fornecidos.| |macros|string/array|Macros de usuário para excluir dos templates fornecidos.| |templateids\_clear|string/array|Templates para desvincular e limpar dos templates fornecidos (upstream).| |templateids\_link|string/array|Templates para desvincular dos templates fornecidos (upstream).|

en-us	### Parameters  `(object)` Parameters containing the IDs of the templates to update and the objects to add to the templates.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**templates**<br>(required)|object/array|Templates to be updated.<br><br>The templates must have the `templateid` property defined.| |groups|object/array|Host groups to add the given templates to.<br><br>The host groups must have the `groupid` property defined.| |macros|object/array|User macros to be created for the given templates.| |templates\_link|object/array|Templates to link to the given templates.<br><br>The templates must have the `templateid` property defined.|
pt-br	### Parâmetros  `(object)` Parâmetros contendo os IDs dos modelos a serem atualizados e os objetos a serem adicionados aos modelos.  O método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**templates**<br>(obrigatório)|object/array|Templates a serem atualizados.<br><br>Os templates devem ter a propriedade `templateid` definida.| |grupos|object/array|Grupos de hosts aos quais adicionar os modelos fornecidos.<br><br>Os grupos de hosts devem ter a propriedade `groupid` definida.| |macros|object/array|Macros de usuário a serem criadas para os templates fornecidos.| |templates\_link|object/array|Templates para vincular aos templates fornecidos.<br><br>Os templates devem ter a `templateid` propriedade definida.|

en-us	### Parameters  `(object)` Parameters containing the IDs of the templates to update and the objects to replace for the templates.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**templates**<br>(required)|object/array|Templates to be updated.<br><br>The templates must have the `templateid` property defined.| |groups|object/array|Host groups to replace the current host groups the templates belong to.<br><br>The host groups must have the `groupid` property defined.| |macros|object/array|User macros to replace the current user macros on the given templates.| |templates\_clear|object/array|Templates to unlink and clear from the given templates.<br><br>The templates must have the `templateid` property defined.| |templates\_link|object/array|Templates to replace the currently linked templates.<br><br>The templates must have the `templateid` property defined.|
pt-br	### Parâmetros  `(object)` Parâmetros contendo os IDs dos templates a serem atualizados e os objetos a serem substituídos pelos templates.  O método aceita os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**templates**<br>(obrigatório)|object/array|Modelos a serem atualizados.<br><br>Os modelos devem ter a propriedade `templateid` definida.| |grupos|object/array|Grupos de hosts para substituir os grupos de hosts atuais aos quais os templates pertencem.<br><br>Os grupos de hosts devem ter a propriedade `groupid` definida.| |macros|object/array|Macros de usuário para substituir as macros de usuário atuais nos templatesa fornecidos.| |templates\_clear|object/array|Templates para desvincular e limpar dos templates fornecidos.<br><br>Os templates devem ter a propriedade `templateid` definida.| |templates\_link|object/array|Templates para substituir os templates atualmente vinculados.<br><br>Os templates devem ter a propriedade `templateid` definida.|

en-us	### Parameters  `(object)` Parameters containing the possible data to import and rules how the data should be handled.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**format**<br>(required)|string|Format of the serialized string.<br><br>Possible values:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON.| |**source**<br>(required)|string|Serialized string containing the configuration data.| |**rules**<br>(required)|object|Rules on how new and existing objects should be imported.<br><br>The `rules` parameter is described in detail in the table below.|  ::: notetip If no rules are given, there will be nothing to update and result will be empty. :::   ::: notetip Comparison will be done only for host groups and templates. Triggers and graphs will be compared only for imported templates, any other will be considered as "new". :::  The `rules` object supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |discoveryRules|object|Rules on how to import LLD rules.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new LLD rules will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing LLD rules will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, LLD rules not present in the imported data will be deleted from the database; default: `false`.| |graphs|object|Rules on how to import graphs.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new graphs will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing graphs will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, graphs not present in the imported data will be deleted from the database; default: `false`.| |groups|object|Rules on how to import host groups.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new host groups will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing host groups will be updated; default: `false`.| |hosts|object|Rules on how to import hosts.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new hosts will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing hosts will be updated; default: `false`.<br><br>This parameter will make no difference to the output. It is allowed only for consistency with `configuration.import`.| |httptests|object|Rules on how to import web scenarios.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new web scenarios will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing web scenarios will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, web scenarios not present in the imported data will be deleted from the database; default: `false`.| |images|object|Rules on how to import images.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new images will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing images will be updated; default: `false`.<br><br>This parameter will make no difference to the output. It is allowed only for consistency with `configuration.import`.| |items|object|Rules on how to import items.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new items will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing items will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, items not present in the imported data will be deleted from the database; default: `false`.| |maps|object|Rules on how to import maps.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new maps will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing maps will be updated; default: `false`.<br><br>This parameter will make no difference to the output. It is allowed only for consistency with `configuration.import`.| |mediaTypes|object|Rules on how to import media types.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new media types will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing media types will be updated; default: `false`.<br><br>This parameter will make no difference to the output. It is allowed only for consistency with `configuration.import`.| |templateLinkage|object|Rules on how to import template links.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new links between templates and host will be created; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, template links not present in the imported data will be deleted from the database; default: `false`.| |templates|object|Rules on how to import templates.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new templates will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing templates will be updated; default: `false`.| |templateDashboards|object|Rules on how to import template dashboards.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new template dashboards will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing template dashboards will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, template dashboards not present in the imported data will be deleted from the database; default: `false`.| |triggers|object|Rules on how to import triggers.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new triggers will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing triggers will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, triggers not present in the imported data will be deleted from the database; default: `false`.| |valueMaps|object|Rules on how to import host or template value maps.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new value maps will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing value maps will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, value maps not present in the imported data will be deleted from the database; default: `false`.|
pt-br	### Parâmetros  `(object)` Parâmetros contendo os dados possíveis para importar e regras como os dados devem ser tratados.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**formato**<br>(obrigatório)|string|Formato da string serializada.<br><br>Valores possíveis:<br>`yaml` - YAML;<br>`xml` - XML;<br >`json` - JSON.| |**source**<br>(obrigatório)|string|String serializada contendo os dados de configuração.| |**rules**<br>(obrigatório)|object|Regras sobre como objetos novos e existentes devem ser importados.<br><br>O parâmetro `rules` é descrito em detalhes na tabela abaixo.|  ::: dica Se nenhuma regra for fornecida, não haverá nada para atualizar e o resultado estará vazio. :::  ::: dica A comparação vai ser feito apenas para grupos de hosts e modelos. Triggers e gráficos serão comparado apenas para templates importados, qualquer outro será considerado como "novo". :::  O objeto `rules` suporta os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |discoveryRules|object|Regras sobre como importar regras LLD.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novas regras LLD serão criadas; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, as regras LLD existentes serão atualizadas; default: `false`;<br>`deleteMissing` - `(boolean)` se definido como `true`, as regras LLD não presentes nos dados importados serão excluídas do banco de dados; padrão: `falso`.| |graphs|object|Regras sobre como importar gráficos.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos gráficos serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os gráficos existentes serão atualizados; default: `false`;<br>`deleteMissing` - `(boolean)` se definido como `true`, os gráficos não presentes nos dados importados serão excluídos do banco de dados; padrão: `falso`.| |groups|object|Regras sobre como importar grupos de hosts.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos grupos de hosts serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os grupos de hosts existentes serão atualizados; padrão: `falso`.| |hosts|object|Regras sobre como importar hosts.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos hosts serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os hosts existentes serão atualizados; default: `false`.<br><br>Este parâmetro não fará diferença na saída. É permitido apenas para consistência com `configuration.import`.| |httptests|object|Regras sobre como importar cenários da web.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos cenários da web serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os cenários da web existentes serão atualizados; default: `false`;<br>`deleteMissing` - `(boolean)` se definido como `true`, os cenários da web não presentes nos dados importados serão excluídos do banco de dados; padrão: `falso`.| |images|object|Regras sobre como importar imagens.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novas imagens serão criadas; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, as imagens existentes serão atualizadas; default: `false`.<br><br>Este parâmetro não fará diferença na saída. É permitido apenas para consistência com `configuration.import`.| |items|object|Regras sobre como importar itens.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos itens serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os itens existentes serão atualizados; default: `false`;<br>`deleteMissing` - `(boolean)` se definido como `true`, os itens não presentes nos dados importados serão excluídos do banco de dados; padrão: `falso`.| |maps|object|Regras sobre como importar mapas.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos mapas serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os mapas existentes serão atualizados; default: `false`.<br><br>Este parâmetro não fará diferença na saída. É permitido apenas para consistência com `configuration.import`.| |mediaTypes|object|Regras sobre como importar tipos de mídia.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos tipos de mídia serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os tipos de mídia existentes serão atualizados; default: `false`.<br><br>Este parâmetro não fará diferença na saída. É permitido apenas para consistência com `configuration.import`.| |templateLinkage|object|Regras sobre como importar links de modelo.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos links entre os modelos e o host serão criados ; padrão: `falso`;<br>  `deleteMissing` - `(boolean)` se definido como `true`, os links de modelo não presentes nos dados importados serão excluídos do banco de dados; padrão: `falso`.| |templates|object|Regras sobre como importar modelos.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos modelos serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os modelos existentes serão atualizados; padrão: `falso`.| |templateDashboards|object|Regras sobre como importar painéis de modelo.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos painéis de modelo serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os painéis de modelos existentes serão atualizados; default: `false`;<br>`deleteMissing` - `(boolean)` se definido como `true`, os painéis de modelo não presentes nos dados importados serão excluídos do banco de dados; padrão: `falso`.| |triggers|object|Regras sobre como importar gatilhos.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos gatilhos serão criados; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os gatilhos existentes serão atualizados; default: `false`;<br>`deleteMissing` - `(boolean)` se definido como `true`, triggers não presentes nos dados importados serão excluídos do banco de dados; padrão: `falso`.| |valueMaps|object|Regras sobre como importar mapas de valor de host ou modelo.<br><br>Parâmetros suportados:<br>`createMissing` - `(boolean)` se definido como `true`, novos mapas de valor serão criados ; default: `false`;<br>`updateExisting` - `(boolean)` se definido como `true`, os mapas de valores existentes serão atualizados; default: `false`;<br>`deleteMissing` - `(boolean)` se definido como `true`, os mapas de valores não presentes nos dados importados serão excluídos do banco de dados; padrão: `falso`.|

en-us	### Parameters  `(object)` Parameters containing the user name and password.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**password**<br>(required)|string|User password.| |**username**<br>(required)|string|User name.| |userData|flag|Return information about the authenticated user.|
pt-br	### Parâmetros    `(object)` Parâmetros contendo o nome de usuário e senha.      O método aceita os seguintes parâmetros.      |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição|   |--|--|------|   |**password**<br>(requerido)|string|Senha do usuário.|   |**username**<br>(requerido)|string|Nome de usuário.|   |userData|flag|Retorna informações sobre o usuário autenticado.|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports only one parameter.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).|
pt-br	### Parâmetros      `(object)` Parâmetros que definem a saída desejada.      O método suporta apenas um parâmetro.      |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |output|query|Este parâmetro é comum para todos os métodos `get` descritos no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports only one parameter.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).|
pt-br	### Parâmetros  `(object)` Parâmetros que definem a saída desejada.  O método suporta apenas um parâmetro.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |output|query|Este parâmetro é comum para todos os métodos `get` descritos no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports only one parameter.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).|
pt-br	### Parâmetros  `(object)` Parâmetros que definem a saída desejada.  O método suporta apenas um parâmetro.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |output|query|Este parâmetro é comum para todos os métodos `get` descritos no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports only one parameter.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).|
pt-br	### Parâmetros  `(object)` Parâmetros que definem a saída desejada.  O método suporta apenas um parâmetro.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |output|query|Este parâmetro é comum para todos os métodos `get` descritos no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |actionids|string/array|Return only actions with the given IDs.| |groupids|string/array|Return only actions that use the given host groups in action conditions.| |hostids|string/array|Return only actions that use the given hosts in action conditions.| |triggerids|string/array|Return only actions that use the given triggers in action conditions.| |mediatypeids|string/array|Return only actions that use the given media types to send messages.| |usrgrpids|string/array|Return only actions that are configured to send messages to the given user groups.| |userids|string/array|Return only actions that are configured to send messages to the given users.| |scriptids|string/array|Return only actions that are configured to run the given scripts.| |selectFilter|query|Return a [filter](/manual/api/reference/action/object#action_filter) property with the action condition filter.| |selectOperations|query|Return an [operations](/manual/api/reference/action/object#action_operation) property with action operations.| |selectRecoveryOperations|query|Return a [recovery\_operations](/manual/api/reference/action/object#action_recovery_operation) property with action recovery operations.| |selectUpdateOperations|query|Return an [update\_operations](/manual/api/reference/action/object#action_update_operation) property with action update operations.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `actionid`, `name` and `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
pt-br	### Parâmetros  `(object)` Parâmetros que definem a saída desejada.  O método oferece suporte aos seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |actionids|string/array|Retorna apenas ações com os IDs fornecidos.| |groupids|string/array|Retorna apenas as ações que usam os grupos de hosts fornecidos em condições de ação.| |hostids|string/array|Retorna apenas ações que usam os hosts fornecidos em condições de ação.| |triggerids|string/array|Retorna apenas ações que usam os gatilhos fornecidos em condições de ação.| |mediatypeids|string/array|Retorna apenas ações que usam os tipos de mídia fornecidos para enviar mensagens.| |usrgrpids|string/array|Retorna apenas as ações configuradas para enviar mensagens para os grupos de usuários especificados.| |userids|string/array|Retorna apenas as ações configuradas para enviar mensagens para os usuários especificados.| |scriptids|string/array|Retorna apenas as ações configuradas para executar os scripts fornecidos.| |selectFilter|query|Retorne uma propriedade [filter](/manual/api/reference/action/object#action_filter) com o filtro de condição de ação.| |selectOperations|query|Retorne uma propriedade [operações](/manual/api/reference/action/object#action_operation) com operações de ação.| |selectRecoveryOperations|query|Retorne uma propriedade [recovery\_operations](/manual/api/reference/action/object#action_recovery_operation) com operações de recuperação de ação.| |selectUpdateOperations|query|Retorne uma propriedade [update\_operations](/manual/api/reference/action/object#action_update_operation) com operações de atualização de ação.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `actionid`, `name` e `status`.| |countOutput|boolean|Esses parâmetros sendo comuns para todos os métodos `get` são descritos no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).| |editável|booleano|^| |excludePesquisa|boolean|^| |filtro|objeto|^| |limite|inteiro|^| |saída|consulta|^| |preservekeys|boolean|^| |pesquisar|objeto|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |ordem de classificação|cadeia/matriz|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |active|flag|Return only enabled trigger prototypes that belong to monitored hosts.| |discoveryids|string/array|Return only trigger prototypes that belong to the given LLD rules.| |functions|string/array|Return only triggers that use the given functions.<br><br>Refer to the [supported trigger functions](/manual/appendix/triggers/functions) page for a list of supported functions.| |group|string|Return only trigger prototypes that belong to hosts from the host groups with the given name.| |groupids|string/array|Return only trigger prototypes that belong to hosts from the given host groups.| |host|string|Return only trigger prototypes that belong to hosts with the given name.| |hostids|string/array|Return only trigger prototypes that belong to the given hosts.| |inherited|boolean|If set to `true` return only trigger prototypes inherited from a template.| |maintenance|boolean|If set to `true` return only enabled trigger prototypes that belong to hosts in maintenance.| |min\_severity|integer|Return only trigger prototypes with severity greater or equal than the given severity.| |monitored|flag|Return only enabled trigger prototypes that belong to monitored hosts and contain only enabled items.| |templated|boolean|If set to `true` return only trigger prototypes that belong to templates.| |templateids|string/array|Return only trigger prototypes that belong to the given templates.| |triggerids|string/array|Return only trigger prototypes with the given IDs.| |expandExpression|flag|Expand functions and macros in the trigger expression.| |selectDependencies|query|Return trigger prototypes and triggers that the trigger prototype depends on in the `dependencies` property.| |selectDiscoveryRule|query|Return the [LLD rule](/manual/api/reference/discoveryrule/object) that the trigger prototype belongs to.| |selectFunctions|query|Return functions used in the trigger prototype in the `functions` property.<br><br>The function objects represent the functions used in the trigger expression and has the following properties:<br>`functionid` - *(string)* ID of the function;<br>`itemid` - *(string)* ID of the item used in the function;<br>`function` - *(string)* name of the function;<br>`parameter` - *(string)* parameter passed to the function. Query parameter is replaced by `$` symbol in returned string.| |selectGroups|query|Return the host groups that the trigger prototype belongs to in the [groups](/manual/api/reference/hostgroup/object) property.| |selectHosts|query|Return the hosts that the trigger prototype belongs to in the [hosts](/manual/api/reference/host/object) property.| |selectItems|query|Return items and item prototypes used the trigger prototype in the [items](/manual/api/reference/item/object) property.| |selectTags|query|Return the trigger prototype tags in [tags](/manual/api/reference/triggerprototype/object#Trigger_prototype_tag) property.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Supports additional filters:<br>`host` - technical name of the host that the trigger prototype belongs to;<br>`hostid` - ID of the host that the trigger prototype belongs to.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectHosts` - results will be sorted by `host`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `triggerid`, `description`, `status` and `priority`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
pt-br	### Parâmetros      `(object)` Parâmetros que definem a saída desejada.      O método oferece suporte aos parâmetros a seguir.      |Parâmetro|[Type](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |active|flag|Retorna apenas protótipos de trigger habilitados que pertencem a hosts monitorados.|   |discoveryids|string/array|Retorna apenas protótipos de trigger que pertencem às regras LLD fornecidas.| |functions|string/array|Retorne apenas triggers que usam as funções fornecidas.<br><br>Consulte a página [supported trigger functions](/manual/appendix/triggers/functions) para obter uma lista de funções compatíveis.| |group|string|Retorna apenas protótipos de trigger que pertencem a hosts dos grupos de hosts com o nome fornecido.|   |groupids|string/array|Retorna apenas protótipos de trigger que pertencem a hosts dos grupos de hosts fornecidos.| |host|string|Retorna apenas protótipos de trigger que pertencem a hosts com o nome fornecido.|   |inherited|boolean|Se definido como `true`, retorna apenas protótipos de trigger herdados de um modelo.|   |manutenção|boolean|Se definido como `true` retorna apenas protótipos de trigger habilitados que pertencem a hosts em manutenção.| |min\_severity|integer|Retorna apenas protótipos de trigger com gravidade maior ou igual à gravidade especificada.|   |monitored|flag|Retorna apenas protótipos de trigger ativados que pertencem a hosts monitorados e contêm apenas itens ativados.| |templated|boolean|Se definido como `true`, retornará apenas protótipos de trigger que pertencem a templates.|   |templateids|string/array|Retorna apenas protótipos de trigger que pertencem aos modelos fornecidos.|   |triggerids|string/array|Retorna apenas protótipos de trigger com os IDs fornecidos.| |expandExpression|flag|Expandir funções e macros na expressão da trigger.|   |selectDependencies|query|Retorne protótipos de trigger e triggers dos quais o protótipo de trigger depende na propriedade `dependencies`.| |selectDiscoveryRule|query|Retorne a [LLD rule](/manual/api/reference/discoveryrule/object) à qual o protótipo da trigger pertence.| |selectFunctions|query|Retorna as funções usadas no protótipo do trigger na propriedade `functions`.<br><br>Os objetos de função representam as funções usadas na expressão do trigger e possuem as seguintes propriedades:<br>`functionid` - * (string)* ID da função;<br>`itemid` - *(string)* ID do item usado na função;<br>`function` - *(string)* nome da função;<br> `parameter` - *(string)* parâmetro passado para a função. O parâmetro de consulta é substituído pelo símbolo `$` na string retornada.| |selectGroups|query|Retorne os grupos de hosts aos quais o protótipo do trigger pertence na propriedade [groups](/manual/api/reference/hostgroup/object).| |selectHosts|query|Retorne os hosts aos quais o protótipo do trigger pertence na propriedade [hosts](/manual/api/reference/host/object).| |selectItems|query|Itens de retorno e protótipos de itens usaram o protótipo de trigger na propriedade [items](/manual/api/reference/item/object).| |selectTags|query|Retorne as etiquetas de protótipo de trigger na propriedade [etiquetas](/manual/api/reference/triggerprototype/object#Trigger_prototype_tag).|   |filter|object|Retorna apenas os resultados que correspondem exatamente ao filtro fornecido.<br><br>Aceita uma array, em que as chaves são nomes de propriedades e os valores são um único valor ou uma array de valores para correspondência. <br><br>Suporta filtros adicionais:<br>`host` - nome técnico do host ao qual o protótipo da trigger pertence;<br>`hostid` - ID do host ao qual o protótipo da trigger pertence.| |limitSelects|integer|Limite o número de registros retornados por subseleções.<br><br>Aplica-se às seguintes subseleções:<br>`selectHosts` - os resultados serão classificados por `host`.|   |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `triggerid`, `description`, `status` e `priority`.| |countOutput|boolean|Esses parâmetros sendo comuns para todos os métodos `get` são descritos em detalhes no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |alertids|string/array|Return only alerts with the given IDs.| |actionids|string/array|Return only alerts generated by the given actions.| |eventids|string/array|Return only alerts generated by the given events.| |groupids|string/array|Return only alerts generated by objects from the given host groups.| |hostids|string/array|Return only alerts generated by objects from the given hosts.| |mediatypeids|string/array|Return only message alerts that used the given media types.| |objectids|string/array|Return only alerts generated by the given objects| |userids|string/array|Return only message alerts that were sent to the given users.| |eventobject|integer|Return only alerts generated by events related to objects of the given type.<br><br>See event ["object"](/manual/api/reference/event/object#event) for a list of supported object types.<br><br>Default: 0 - trigger.| |eventsource|integer|Return only alerts generated by events of the given type.<br><br>See event ["source"](/manual/api/reference/event/object#event) for a list of supported event types.<br><br>Default: 0 - trigger events.| |time\_from|timestamp|Return only alerts that have been generated after the given time.| |time\_till|timestamp|Return only alerts that have been generated before the given time.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with data of hosts that triggered the action operation.| |selectMediatypes|query|Return a [mediatypes](/manual/api/reference/mediatype/object) property with an array of the media types that were used for the message alert.| |selectUsers|query|Return a [users](/manual/api/reference/user/object) property with an array of the users that the message was addressed to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `alertid`, `clock`, `eventid`, `mediatypeid`, `sendto` and `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
pt-br	### Parâmetros  `(object)` Parâmetros que definem a saída desejada.  O método oferece suporte aos parâmetros a seguir.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |alertids|string/array|Retorna apenas alertas com os IDs fornecidos.| |actionids|string/array|Retorna apenas alertas gerados pelas ações fornecidas.| |eventids|string/array|Retorna apenas os alertas gerados pelos eventos fornecidos.| |groupids|string/array|Retorna apenas alertas gerados por objetos dos grupos de hosts fornecidos.| |hostids|string/array|Retorna apenas alertas gerados por objetos dos hosts fornecidos.| |mediatypeids|string/array|Retorna apenas alertas de mensagens que usaram os tipos de mídia fornecidos.| |objectids|string/array|Retorna apenas alertas gerados pelos objetos fornecidos| |userids|string/array|Retorna apenas alertas de mensagens que foram enviadas para os usuários indicados.| |eventobject|integer|Retorna apenas alertas gerados por eventos relacionados a objetos de um determinado tipo.<br><br>Veja event ["object"](/manual/api/reference/event/object#event) para obter uma lista de tipos de objetos suportados.<br><br>Padrão: 0 - trigger.| |eventsource|integer|Retorna apenas alertas gerados por eventos de um determinado tipo.<br><br>Consulte event ["source"](/manual/api/reference/event/object#event) para obter uma lista de tipos de eventos suportados .<br><br>Padrão: 0 - acionar eventos.| |time\_from|timestamp|Retorna apenas os alertas que foram gerados após o tempo determinado.| |time\_till|timestamp|Retorna apenas os alertas que foram gerados antes do tempo determinado.| |selectHosts|query|Retorne uma propriedade [hosts](/manual/api/reference/host/object) com dados de hosts que acionaram a operação de ação.| |selectMediatypes|query|Retorne uma propriedade [mediatypes](/manual/api/reference/mediatype/object) com uma matriz dos tipos de mídia que foram usados para o alerta de mensagem.| |selectUsers|query|Retorne uma propriedade [users](/manual/api/reference/user/object) com um array dos usuários aos quais a mensagem foi endereçada.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `alertid`, `clock`, `eventid`, `mediatypeid`, `sendto` e `status`.| |countOutput|boolean|Esses parâmetros sendo comuns para todos os métodos `get` são descritos no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).| |editável|booleano|^| |excludePesquisa|boolean|^| |filtro|objeto|^| |limite|inteiro|^| |saída|consulta|^| |preservekeys|boolean|^| |pesquisar|objeto|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |ordem de classificação|cadeia/matriz|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |auditids|string/array|Return only audit log with the given IDs.| |userids|string/array|Return only audit log that were created by the given users.| |time\_from|timestamp|Returns only audit log entries that have been created after or at the given time.| |time\_till|timestamp|Returns only audit log entries that have been created before or at the given time.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `auditid`, `userid`, `clock`.| |filter|object|Return only results that exactly match the given filter.<br><br>Accepts an array, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Additionally supports filtering by details property fields: `table_name`, `field_name`.| |search|object|Case insensitive sub-string search in content of fields: `username`, `ip`, `resourcename`, `details`.| |countOutput|boolean|These parameters being common for all `get` methods are described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
pt-br	### Parâmetros  `(object)` Parâmetros que definem a saída desejada.  O método oferece suporte aos seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |auditids|string/array|Retorna apenas o log de auditoria com os IDs fornecidos.| |userids|string/array|Retorna apenas o log de auditoria que foi criado pelos usuários fornecidos.| |time\_from|timestamp|Retorna apenas as entradas de log de auditoria que foram criadas após ou em determinado momento.| |time\_till|timestamp|Retorna apenas as entradas de log de auditoria que foram criadas antes ou em determinado momento.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `auditid`, `userid`, `clock`.| |filter|object|Retorna apenas os resultados que correspondem exatamente ao filtro fornecido.<br><br>Aceita uma matriz, em que as chaves são nomes de propriedades e os valores são um valor único ou uma matriz de valores para correspondência.< br><br>Suporta adicionalmente a filtragem por campos de propriedade de detalhes: `table_name`, `field_name`.| |pesquisa|objeto|Pesquisa de substring sem distinção entre maiúsculas e minúsculas no conteúdo dos campos: `username`, `ip`, `resourcename`, `details`.| |countOutput|boolean|Esses parâmetros sendo comuns para todos os métodos `get` são descritos no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).| |excludePesquisa|boolean|^| |limite|inteiro|^| |saída|consulta|^| |preservekeys|boolean|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |ordem de classificação|cadeia/matriz|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |correlationids|string/array|Return only correlations with the given IDs.| |selectFilter|query|Return a [filter](/manual/api/reference/correlation/object#correlation_filter) property with the correlation conditions.| |selectOperations|query|Return an [operations](/manual/api/reference/correlation/object#correlation_operation) property with the correlation operations.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `correlationid`, `name` and `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
pt-br	### Parâmetros  `(object)` Parâmetros que definem a saída desejada.  O método oferece suporte aos parâmetros a seguir.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |correlationids|string/array|Retorna apenas correlações com os IDs fornecidos.| |selectFilter|query|Retorne uma propriedade [filter](/manual/api/reference/correlation/object#correlation_filter) com as condições de correlação.| |selectOperations|query|Retorne uma propriedade [operações](/manual/api/reference/correlation/object#correlation_operation) com as operações de correlação.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `correlationid`, `name` e `status`.| |countOutput|boolean|Esses parâmetros sendo comuns para todos os métodos `get` são descritos no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).| |editável|booleano|^| |excludePesquisa|boolean|^| |filtro|objeto|^| |limite|inteiro|^| |saída|consulta|^| |preservekeys|boolean|^| |pesquisar|objeto|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |ordem de classificação|cadeia/matriz|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |dashboardids|string/array|Return only dashboards with the given IDs.| |selectPages|query|Return a [pages](/manual/api/reference/dashboard/object#dashboard_page) property with dashboard pages, correctly ordered.| |selectUsers|query|Return a [users](/manual/api/reference/dashboard/object#dashboard_user) property with users that the dashboard is shared with.| |selectUserGroups|query|Return a [userGroups](/manual/api/reference/dashboard/object#dashboard_user_group) property with user groups that the dashboard is shared with.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible value is: `dashboardid`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
pt-br	### Parâmetros  `(object)` Parâmetros que definem a saída desejada.  O método oferece suporte aos seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |dashboardids|string/array|Retorne apenas painéis com os IDs fornecidos.| |selectPages|query|Retorne uma propriedade [pages](/manual/api/reference/dashboard/object#dashboard_page) com páginas do painel, ordenadas corretamente.| |selectUsers|query|Retorne uma propriedade [users](/manual/api/reference/dashboard/object#dashboard_user) com os usuários com os quais o painel é compartilhado.| |selectUserGroups|query|Retorne uma propriedade [userGroups](/manual/api/reference/dashboard/object#dashboard_user_group) com grupos de usuários com os quais o painel é compartilhado.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>O valor possível é: `dashboardid`.| |countOutput|boolean|Esses parâmetros sendo comuns para todos os métodos `get` são descritos em detalhes na página [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).| |editável|booleano|^| |excludePesquisa|boolean|^| |filtro|objeto|^| |limite|inteiro|^| |saída|consulta|^| |preservekeys|boolean|^| |pesquisar|objeto|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |ordem de classificação|cadeia/matriz|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dashboardids|string/array|Return only template dashboards with the given IDs.| |templateids|string/array|Return only template dashboards that belong to the given templates.| |selectPages|query|Return a [pages](/manual/api/reference/templatedashboard/object#template_dashboard_page) property with template dashboard pages, correctly ordered.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `dashboardid` and `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
pt-br	### Parâmetros  `(object)` Parâmetros que definem a saída desejada.  O método suporta os seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |dashboardids|string/array|Retorne apenas painéis de modelo com os IDs fornecidos.| |templateids|string/array|Retorne apenas os painéis de modelo que pertencem aos modelos fornecidos.| |selectPages|query| Retorne uma propriedade de [páginas](/manual/api/reference/templatedashboard/object#template_dashboard_page) com páginas de painel de modelo, ordenadas corretamente.| |sortfield|string/array|Classifique o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `dashboardid` and `name`.| |countOutput|boolean|Esses parâmetros sendo comuns para todos os `get` métodos são descritos em detalhes no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |dcheckids|string/array|Return only discovery checks with the given IDs.| |druleids|string/array|Return only discovery checks that belong to the given discovery rules.| |dserviceids|string/array|Return only discovery checks that have detected the given discovered services.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `dcheckid` and `druleid`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
pt-br	### Parâmetros  `(object)` Parâmetros que definem a saída desejada.  O método oferece suporte aos seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |dcheckids|string/array|Retorna apenas verificações de descoberta com os IDs fornecidos.| |druleids|string/array|Retorna apenas verificações de descoberta que pertencem às regras de descoberta fornecidas.| |dserviceids|string/array|Retorna apenas verificações de descoberta que detectaram os serviços descobertos fornecidos.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `dcheckid` e `druleid`.| |countOutput|boolean|Estes parâmetros sendo comuns para todos os métodos `get` são descritos em detalhes no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).| |editável|booleano|^| |excludePesquisa|boolean|^| |filtro|objeto|^| |limite|inteiro|^| |saída|consulta|^| |preservekeys|boolean|^| |pesquisar|objeto|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |ordem de classificação|cadeia/matriz|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |dhostids|string/array|Return only discovered hosts with the given IDs.| |druleids|string/array|Return only discovered hosts that have been created by the given discovery rules.| |dserviceids|string/array|Return only discovered hosts that are running the given services.| |selectDRules|query|Return a [drules](/manual/api/reference/drule/object) property with an array of the discovery rules that detected the host.| |selectDServices|query|Return a [dservices](/manual/api/reference/dservice/object) property with the discovered services running on the host.<br><br>Supports `count`.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectDServices` - results will be sorted by `dserviceid`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `dhostid` and `druleid`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
pt-br	### Parâmetros  `(object)` Parâmetros que definem a saída desejada.  O método oferece suporte aos seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |dhostids|string/array|Retorna apenas hosts descobertos com os IDs fornecidos.| |druleids|string/array|Retorna apenas hosts descobertos que foram criados pelas regras de descoberta fornecidas.| |dserviceids|string/array|Retorna apenas os hosts descobertos que estão executando os serviços fornecidos.| |selectDRules|query|Retorne uma propriedade [drules](/manual/api/reference/drule/object) com uma matriz das regras de descoberta que detectaram o host.| |selectDServices|query|Retorne uma propriedade [dservices](/manual/api/reference/dservice/object) com os serviços descobertos em execução no host.<br><br>Suporta `count`.| |limitSelects|integer|Limite o número de registros retornados por subseleções.<br><br>Aplica-se às seguintes subseleções:<br>`selectDServices` - os resultados serão classificados por `dserviceid`.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `dhostid` e `druleid`.| |countOutput|boolean|Esses parâmetros sendo comuns para todos os métodos `get` são descritos em detalhes no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).| |editável|booleano|^| |excludePesquisa|boolean|^| |filtro|objeto|^| |limite|inteiro|^| |saída|consulta|^| |preservekeys|boolean|^| |pesquisar|objeto|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |ordem de classificação|cadeia/matriz|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |dhostids|string/array|Return only discovery rules that created the given discovered hosts.| |druleids|string/array|Return only discovery rules with the given IDs.| |dserviceids|string/array|Return only discovery rules that created the given discovered services.| |selectDChecks|query|Return a [dchecks](/manual/api/reference/dcheck/object) property with the discovery checks used by the discovery rule.<br><br>Supports `count`.| |selectDHosts|query|Return a [dhosts](/manual/api/reference/dhost/object) property with the discovered hosts created by the discovery rule.<br><br>Supports `count`.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectDChecks` - results will be sorted by `dcheckid`;<br>`selectDHosts` - results will be sorted by `dhostsid`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `druleid` and `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
pt-br	### Parâmetros  `(object)` Parâmetros que definem a saída desejada.  O método oferece suporte aos seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |dhostids|string/array|Retorna apenas as regras de descoberta que criaram os hosts descobertos fornecidos.| |druleids|string/array|Retorna apenas regras de descoberta com os IDs fornecidos.| |dserviceids|string/array|Retorna apenas as regras de descoberta que criaram os serviços descobertos fornecidos.| |selectDChecks|query|Retorne uma propriedade [dchecks](/manual/api/reference/dcheck/object) com as verificações de descoberta usadas pela regra de descoberta.<br><br>Suporta `count`.| |selectDHosts|query|Retorne uma propriedade [dhosts](/manual/api/reference/dhost/object) com os hosts descobertos criados pela regra de descoberta.<br><br>Suporta `count`.| |limitSelects|integer|Limite o número de registros retornados por subseleções.<br><br>Aplica-se às seguintes subseleções:<br>`selectDChecks` - os resultados serão classificados por `dcheckid`;<br>`selectDHosts` - resultados será ordenado por `dhostsid`.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `druleid` e `name`.| |countOutput|boolean|Esses parâmetros sendo comuns para todos os métodos `get` são descritos em detalhes no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).| |editável|booleano|^| |excludePesquisa|boolean|^| |filtro|objeto|^| |limite|inteiro|^| |saída|consulta|^| |preservekeys|boolean|^| |pesquisar|objeto|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |ordem de classificação|cadeia/matriz|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |discoveryids|string/array|Return only graph prototypes that belong to the given discovery rules.| |graphids|string/array|Return only graph prototypes with the given IDs.| |groupids|string/array|Return only graph prototypes that belong to hosts in the given host groups.| |hostids|string/array|Return only graph prototypes that belong to the given hosts.| |inherited|boolean|If set to `true` return only graph prototypes inherited from a template.| |itemids|string/array|Return only graph prototypes that contain the given item prototypes.| |templated|boolean|If set to `true` return only graph prototypes that belong to templates.| |templateids|string/array|Return only graph prototypes that belong to the given templates.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/discoveryrule/object#lld_rule) property with the LLD rule that the graph prototype belongs to.| |selectGraphItems|query|Return a [gitems](/manual/api/reference/graphitem/object) property with the graph items used in the graph prototype.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with the host groups that the graph prototype belongs to.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts that the graph prototype belongs to.| |selectItems|query|Return an `items` property with the [items](/manual/api/reference/item/object) and [item prototypes](/manual/api/reference/itemprototype/object) used in the graph prototype.| |selectTemplates|query|Return a [templates](/manual/api/reference/template/object) property with the templates that the graph prototype belongs to.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Supports additional filters:<br>`host` - technical name of the host that the graph prototype belongs to;<br>`hostid` - ID of the host that the graph prototype belongs to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `graphid`, `name` and `graphtype`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
pt-br	### Parâmetros  `(object)` Parâmetros que definem a saída desejada.  O método oferece suporte aos seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |discoveryids|string/array|Retorna apenas protótipos de gráfico que pertencem às regras de descoberta fornecidas.| |graphids|string/array|Retorna apenas protótipos de gráfico com os IDs fornecidos.| |groupids|string/array|Retorna apenas protótipos de gráfico que pertencem a hosts nos grupos de hosts fornecidos.| |hostids|string/array|Retorna apenas protótipos de gráfico que pertencem aos hosts fornecidos.| |inherited|boolean|Se definido como `true`, retornará apenas protótipos de gráfico herdados de um modelo.| |itemids|string/array|Retorna apenas protótipos de gráfico que contenham os protótipos de itens fornecidos.| |templated|boolean|Se definido como `true`, retornará apenas protótipos de gráficos que pertencem a templates.| |templateids|string/array|Retorna apenas protótipos de gráfico que pertencem aos modelos fornecidos.| |selectDiscoveryRule|query|Retorne uma propriedade [discoveryRule](/manual/api/reference/discoveryrule/object#lld_rule) com a regra LLD à qual o protótipo do gráfico pertence.| |selectGraphItems|query|Retorne uma propriedade [gitems](/manual/api/reference/graphitem/object) com os itens do gráfico usados no protótipo do gráfico.| |selectGroups|query|Retorne uma propriedade [groups](/manual/api/reference/hostgroup/object) com os grupos de hosts aos quais o protótipo gráfico pertence.| |selectHosts|query|Retorne uma propriedade [hosts](/manual/api/reference/host/object) com os hosts aos quais o protótipo gráfico pertence.| |selectItems|query|Retorne uma propriedade `items` com os [items](/manual/api/reference/item/object) e [item prototypes](/manual/api/reference/itemprototype/object) usados no protótipo do gráfico .| |selectTemplates|query|Retorne uma propriedade [templates](/manual/api/reference/template/object) com os templates aos quais o protótipo gráfico pertence.| |filter|object|Retorna apenas os resultados que correspondem exatamente ao filtro fornecido.<br><br>Aceita uma matriz, em que as chaves são nomes de propriedades e os valores são um único valor ou uma matriz de valores para correspondência. <br><br>Suporta filtros adicionais:<br>`host` - nome técnico do host ao qual o protótipo gráfico pertence;<br>`hostid` - ID do host ao qual o protótipo gráfico pertence.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `graphid`, `name` e `graphtype`.| |countOutput|boolean|Esses parâmetros sendo comuns para todos os métodos `get` são descritos em detalhes no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).| |editável|booleano|^| |excludePesquisa|boolean|^| |limite|inteiro|^| |saída|consulta|^| |preservekeys|boolean|^| |pesquisar|objeto|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |ordem de classificação|cadeia/matriz|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |discoveryids|string/array|Return only item prototypes that belong to the given LLD rules.| |graphids|string/array|Return only item prototypes that are used in the given graph prototypes.| |hostids|string/array|Return only item prototypes that belong to the given hosts.| |inherited|boolean|If set to `true` return only item prototypes inherited from a template.| |itemids|string/array|Return only item prototypes with the given IDs.| |monitored|boolean|If set to `true` return only enabled item prototypes that belong to monitored hosts.| |templated|boolean|If set to `true` return only item prototypes that belong to templates.| |templateids|string/array|Return only item prototypes that belong to the given templates.| |triggerids|string/array|Return only item prototypes that are used in the given trigger prototypes.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/discoveryrule/object#lld_rule) property with the low-level discovery rule that the item prototype belongs to.| |selectGraphs|query|Return a [manual/api/reference/graphprototype/object\#graph\_prototype](/manual/api/reference/graphprototype/object#graph_prototype) property with graph prototypes that the item prototype is used in.<br><br>Supports `count`.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with an array of hosts that the item prototype belongs to.| |selectTags|query|Return the item prototype tags in [tags](/manual/api/reference/itemprototype/object#Item_prototype_tag) property.| |selectTriggers|query|Return a [triggers](/manual/api/reference/triggerprototype/object#trigger_prototype) property with trigger prototypes that the item prototype is used in.<br><br>Supports `count`.| |selectPreprocessing|query|Return a [preprocessing](/manual/api/reference/item/object#item_preprocessing) property with item preprocessing options.<br><br>It has the following properties:<br>`type` - `(string)` The preprocessing option type:<br>1 - Custom multiplier;<br>2 - Right trim;<br>3 - Left trim;<br>4 - Trim;<br>5 - Regular expression matching;<br>6 - Boolean to decimal;<br>7 - Octal to decimal;<br>8 - Hexadecimal to decimal;<br>9 - Simple change;<br>10 - Change per second;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - In range;<br>14 - Matches regular expression;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>18 - Check for error using regular expression;<br>19 - Discard unchanged;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>22 - Prometheus pattern;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>26 - Check for not supported value;<br>27- XML to JSON.<br><br>`params` - `(string)` Additional parameters used by preprocessing option. Multiple parameters are separated by LF (\\n)character.<br>`error_handler` - `(string)` Action type used in case of preprocessing step failure:<br>0 - Error message is set by Zabbix server;<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.<br><br>`error_handler_params` - `(string)` Error handler parameters.| |selectValueMap|query|Return a [valuemap](/manual/api/reference/valuemap/object) property with item prototype value map.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Supports additional filters:<br>`host` - technical name of the host that the item prototype belongs to.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectGraphs` - results will be sorted by `name`;<br>`selectTriggers` - results will be sorted by `description`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `itemid`, `name`, `key_`, `delay`, `type` and `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
pt-br	### Parâmetros  `(object)` Parâmetros que definem a saída desejada.  O método oferece suporte aos seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |discoveryids|string/array|Retorna apenas protótipos de itens que pertencem às regras LLD fornecidas.| |graphids|string/array|Retorna apenas protótipos de itens que são usados nos protótipos de gráficos fornecidos.| |hostids|string/array|Retorna apenas protótipos de itens que pertencem aos hosts fornecidos.| |inherited|boolean|Se definido como `true`, retornará apenas protótipos de itens herdados de um modelo.| |itemids|string/array|Retorna apenas protótipos de itens com os IDs fornecidos.| |monitored|boolean|Se definido como `true` retorna apenas protótipos de itens habilitados que pertencem a hosts monitorados.| |templated|boolean|Se definido como `true`, retornará apenas protótipos de itens que pertencem a templates.| |templateids|string/array|Retorna apenas protótipos de itens que pertencem aos modelos fornecidos.| |triggerids|string/array|Retorna apenas os protótipos de item que são usados nos protótipos de gatilho fornecidos.| |selectDiscoveryRule|query|Retorne uma propriedade [discoveryRule](/manual/api/reference/discoveryrule/object#lld_rule) com a regra de descoberta de baixo nível à qual o protótipo do item pertence.| |selectGraphs|query|Retorne uma propriedade [manual/api/reference/graphprototype/object\#graph\_prototype](/manual/api/reference/graphprototype/object#graph_prototype) com protótipos de gráfico nos quais o protótipo de item é usado.< br><br>Suporta `contagem`.| |selectHosts|query|Retorne uma propriedade [hosts](/manual/api/reference/host/object) com uma matriz de hosts aos quais o protótipo do item pertence.| |selectTags|query|Retorne as tags de protótipo do item na propriedade [tags](/manual/api/reference/itemprototype/object#Item_prototype_tag).| |selectTriggers|query|Retorne uma propriedade [triggers](/manual/api/reference/triggerprototype/object#trigger_prototype) com protótipos de gatilho nos quais o protótipo do item é usado.<br><br>Suporta `count`.| |selectPreprocessing|query|Retorna uma propriedade de [pré-processamento](/manual/api/reference/item/object#item_preprocessing) com opções de pré-processamento de item.<br><br>Tem as seguintes propriedades:<br>`type` - ` (string)` O tipo de opção de pré-processamento:<br>1 - Multiplicador personalizado;<br>2 - Aparar à direita;<br>3 - Aparar à esquerda;<br>4 - Aparar;<br>5 - Correspondência de 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 - No intervalo;<br>14 - Corresponde à expressão regular;<br>15 - Não corresponde à expressão regular;<br>16 - Verifique se há erro no JSON;<br> 17 - Verificar erro no XML;<br>18 - Verificar erro usando expressão regular;<br>19 - Descartar inalterado;<br>20 - Descartar inalterado com pulsação;<br>21 - JavaScript;<br>22 - Padrão Prometheus;<br>23 - Prometheus para JSON;<br>24 - CSV para JSON;<br>25 - Substituir;<br>26 - Verificar valor não suportado;<br>27- XML para JSON.<br> ><br>`params` - `(str ing)` Parâmetros adicionais usados pela opção de pré-processamento. Vários parâmetros são separados pelo caractere LF (\\n).<br>`error_handler` - `(string)` Tipo de ação usado em caso de falha na etapa de pré-processamento:<br>0 - Mensagem de erro é definida pelo servidor Zabbix;<br> >1 - Descartar valor;<br>2 - Definir valor personalizado;<br>3 - Definir mensagem de erro personalizada.<br><br>`error_handler_params` - `(string)` Parâmetros do manipulador de erro.| |selectValueMap|query|Retorne uma propriedade [valuemap](/manual/api/reference/valuemap/object) com o mapa de valor do protótipo do item.| |filter|object|Retorna apenas os resultados que correspondem exatamente ao filtro fornecido.<br><br>Aceita uma matriz, em que as chaves são nomes de propriedades e os valores são um único valor ou uma matriz de valores para correspondência. <br><br>Suporta filtros adicionais:<br>`host` - nome técnico do host ao qual o protótipo do item pertence.| |limitSelects|integer|Limite o número de registros retornados por subseleções.<br><br>Aplica-se às seguintes subseleções:<br>`selectGraphs` - os resultados serão classificados por `name`;<br>`selectTriggers` - resultados será ordenado por `descrição`.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `itemid`, `name`, `key_`, `delay`, `type` e `status`.| |countOutput|boolean|Esses parâmetros sendo comuns para todos os métodos `get` são descritos em detalhes no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).| |editável|booleano|^| |excludePesquisa|boolean|^| |limite|inteiro|^| |saída|consulta|^| |preservekeys|boolean|^| |pesquisar|objeto|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |ordem de classificação|cadeia/matriz|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |dserviceids|string/array|Return only discovered services with the given IDs.| |dhostids|string/array|Return only discovered services that belong to the given discovered hosts.| |dcheckids|string/array|Return only discovered services that have been detected by the given discovery checks.| |druleids|string/array|Return only discovered services that have been detected by the given discovery rules.| |selectDRules|query|Return a [drules](/manual/api/reference/drule/object) property with an array of the discovery rules that detected the service.| |selectDHosts|query|Return a [dhosts](/manual/api/reference/dhost/object) property with an array the discovered hosts that the service belongs to.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts with the same IP address and proxy as the service.<br><br>Supports `count`.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectHosts` - result will be sorted by `hostid`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `dserviceid`, `dhostid` and `ip`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
pt-br	### Parâmetros  `(object)` Parâmetros que definem a saída desejada.  O método oferece suporte aos seguintes parâmetros.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |dserviceids|string/array|Retorna apenas serviços descobertos com os IDs fornecidos.| |dhostids|string/array|Retorna apenas serviços descobertos que pertencem aos hosts descobertos fornecidos.| |dcheckids|string/array|Retorna apenas os serviços descobertos que foram detectados pelas verificações de descoberta fornecidas.| |druleids|string/array|Retorna apenas os serviços descobertos que foram detectados pelas regras de descoberta fornecidas.| |selectDRules|query|Retorne uma propriedade [drules](/manual/api/reference/drule/object) com uma matriz das regras de descoberta que detectaram o serviço.| |selectDHosts|query|Retorne uma propriedade [dhosts](/manual/api/reference/dhost/object) com uma matriz dos hosts descobertos aos quais o serviço pertence.| |selectHosts|query|Retorne uma propriedade [hosts](/manual/api/reference/host/object) com os hosts com o mesmo endereço IP e proxy do serviço.<br><br>Suporta `count`.| |limitSelects|integer|Limite o número de registros retornados por subseleções.<br><br>Aplica-se às seguintes subseleções:<br>`selectHosts` - o resultado será classificado por `hostid`.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `dserviceid`, `dhostid` e `ip`.| |countOutput|boolean|Estes parâmetros sendo comuns para todos os métodos `get` são descritos em detalhes no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).| |editável|booleano|^| |excludePesquisa|boolean|^| |filtro|objeto|^| |limite|inteiro|^| |saída|consulta|^| |preservekeys|boolean|^| |pesquisar|objeto|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |ordem de classificação|cadeia/matriz|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |eventids|string/array|Return only events with the given IDs.| |groupids|string/array|Return only events created by objects that belong to the given host groups.| |hostids|string/array|Return only events created by objects that belong to the given hosts.| |objectids|string/array|Return only events created by the given objects.| |source|integer|Return only events with the given type.<br><br>Refer to the [event object page](object#event) for a list of supported event types.<br><br>Default: 0 - trigger events.| |object|integer|Return only events created by objects of the given type.<br><br>Refer to the [event object page](object#event) for a list of supported object types.<br><br>Default: 0 - trigger.| |acknowledged|boolean|If set to `true` return only acknowledged events.| |suppressed|boolean|`true` - return only suppressed events;<br>`false` - return events in the normal state.| |severities|integer/array|Return only events with given event severities. Applies only if object is trigger.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only events with given tags. Exact match by tag and case-insensitive search by value and operator.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all events.<br><br>Possible operator types:<br>0 - (default) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.| |eventid\_from|string|Return only events with IDs greater or equal to the given ID.| |eventid\_till|string|Return only events with IDs less or equal to the given ID.| |time\_from|timestamp|Return only events that have been created after or at the given time.| |time\_till|timestamp|Return only events that have been created before or at the given time.| |problem\_time\_from|timestamp|Returns only events that were in the problem state starting with `problem_time_from`. Applies only if the source is trigger event and object is trigger. Mandatory if `problem_time_till` is specified.| |problem\_time\_till|timestamp|Returns only events that were in the problem state until `problem_time_till`. Applies only if the source is trigger event and object is trigger. Mandatory if `problem_time_from` is specified.| |value|integer/array|Return only events with the given values.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with hosts containing the object that created the event. Supported only for events generated by triggers, items or LLD rules.| |selectRelatedObject|query|Return a `relatedObject` property with the object that created the event. The type of object returned depends on the event type.| |select\_alerts|query|Return an [alerts](/manual/api/reference/alert/object) property with alerts generated by the event. Alerts are sorted in reverse chronological order.| |select\_acknowledges|query|Return an `acknowledges` property with event updates. Event updates are sorted in reverse chronological order.<br><br>The event update object has the following properties:<br>`acknowledgeid` - `(string)` acknowledgment's ID;<br>`userid` - `(string)` ID of the user that updated the event;<br>`eventid` - `(string)` ID of the updated event;<br>`clock` - `(timestamp)` time when the event was updated;<br>`message` - `(string)` text of the message;<br>`action` - `(integer)` update action that was performed see [event.acknowledge](/manual/api/reference/event/acknowledge);<br>`old_severity` - `(integer)` event severity before this update action;<br>`new_severity` - `(integer)` event severity after this update action;<br>`username` - `(string)` username of the user that updated the event;<br>`name` - `(string)` name of the user that updated the event;<br>`surname` - `(string)` surname of the user that updated the event.<br><br>Supports `count`.| |selectTags|query|Return a [tags](/manual/api/reference/event/object#Event_tag) property with event tags.| |selectSuppressionData|query|Return a `suppression_data` property with the list of maintenances:<br>`maintenanceid` - `(string)` ID of the maintenance;<br>`suppress_until` - `(integer)` time until the event is suppressed.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `eventid`, `objectid` and `clock`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
pt-br	### Parâmetros  `(object)` Parâmetros que definem a saída desejada.  O método oferece suporte aos parâmetros a seguir.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |eventids|string/array|Retorna apenas eventos com os IDs fornecidos.| |groupids|string/array|Retorna apenas eventos criados por objetos que pertencem aos grupos de hosts especificados.| |hostids|string/array|Retorna apenas eventos criados por objetos que pertencem aos hosts fornecidos.| |objectids|string/array|Retorna apenas eventos criados pelos objetos fornecidos.| |source|integer|Retorna apenas eventos com o tipo fornecido.<br><br>Consulte a [página do objeto do evento](object#event) para obter uma lista de tipos de eventos suportados.<br><br>Padrão: 0 - acionar eventos.| |objeto|inteiro|Retorna apenas eventos criados por objetos de um determinado tipo.<br><br>Consulte a [página do objeto do evento](objeto#evento) para obter uma lista de tipos de objetos compatíveis.<br><br>Padrão : 0 - gatilho.| |acknowledged|boolean|Se definido como `true` retorna apenas eventos reconhecidos.| |suppressed|boolean|`true` - retorna somente eventos suprimidos;<br>`false` - retorna eventos no estado normal.| |severities|integer/array|Retorna apenas eventos com as severidades de eventos especificadas. Aplica-se apenas se o objeto for acionador.| |evaltype|integer|Regras para pesquisa de tags.<br><br>Valores possíveis:<br>0 - (padrão) E/Ou;<br>2 - Ou.| |tags|array de objetos|Retorna apenas eventos com as tags fornecidas. Correspondência exata por tag e pesquisa sem distinção entre maiúsculas e minúsculas por valor e operador.<br>Formato: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator> "}, ...]`.<br>Um array vazio retorna todos os eventos.<br><br>Possíveis tipos de operadores:<br>0 - (padrão) Like;<br>1 - Igual;<br>2 - Não gosta;<br>3 - Não é igual<br>4 - Existe;<br>5 - Não existe.| |eventid\_from|string|Retorna apenas eventos com IDs maiores ou iguais ao ID fornecido.| |eventid\_till|string|Retorna apenas eventos com IDs menores ou iguais ao ID fornecido.| |time\_from|timestamp|Retorna apenas eventos que foram criados após ou no momento determinado.| |time\_till|timestamp|Retorna apenas eventos que foram criados antes ou no momento determinado.| |problem\_time\_from|timestamp|Retorna apenas eventos que estavam no estado de problema começando com `problem_time_from`. Aplica-se apenas se a origem for um evento de acionamento e o objeto for um acionador. Obrigatório se `problem_time_till` for especificado.| |problem\_time\_till|timestamp|Retorna apenas eventos que estavam no estado de problema até `problem_time_till`. Aplica-se apenas se a origem for um evento de acionamento e o objeto for um acionador. Obrigatório se `problem_time_from` for especificado.| |valor|inteiro/array|Retorna apenas eventos com os valores fornecidos.| |selectHosts|query|Retorne uma propriedade [hosts](/manual/api/reference/host/object) com hosts contendo o objeto que criou o evento. Com suporte apenas para eventos gerados por gatilhos, itens ou regras LLD.| |selectRelatedObject|query|Retorna uma propriedade `relatedObject` com o objeto que criou o evento. O tipo de objeto retornado depende do tipo de evento.| |select\_alerts|query|Retorna uma propriedade [alerts](/manual/api/reference/alert/object) com alertas gerados pelo evento. Os alertas são classificados em ordem cronológica inversa.| |select\_acknowledges|query|Retorna uma propriedade `acknowledges` com atualizações de eventos. As atualizações de eventos são classificadas em ordem cronológica inversa.<br><br>O objeto de atualização de evento tem as seguintes propriedades:<br>`acknowledgeid` - ID da confirmação de `(string)`;<br>`userid` - `(string) ` ID do usuário que atualizou o evento;<br>`eventid` - `(string)` ID do evento atualizado;<br>`clock` - `(timestamp)` hora em que o evento foi atualizado;<br> `message` - texto `(string)` da mensagem;<br>`action` - `(integer)` ação de atualização que foi executada veja [event.acknowledge](/manual/api/reference/event/acknowledge); <br>`old_severity` - gravidade do evento `(integer)` antes desta ação de atualização;<br>`new_severity` - gravidade do evento `(integer)` após esta ação de atualização;<br>`username` - `(string)` nome de usuário do usuário que atualizou o evento;<br>`name` - `(string)` nome do usuário que atualizou o evento;<br>`surname` - `(string)` sobrenome do usuário que atualizou o evento .<br><br>Suporta `contagem`.| |selectTags|query|Retorne uma propriedade [tags](/manual/api/reference/event/object#Event_tag) com tags de evento.| |selectSuppressionData|query|Retorna uma propriedade `suppression_data` com a lista de manutenções:<br>`maintenanceid` - `(string)` ID da manutenção;<br>`suppress_until` - `(integer)` tempo até o evento é suprimido.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `eventid`, `objectid` e `clock`.| |countOutput|boolean|Esses parâmetros sendo comuns para todos os métodos `get` são descritos em detalhes na página [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).| |editável|booleano|^| |excludePesquisa|boolean|^| |filtro|objeto|^| |limite|inteiro|^| |saída|consulta|^| |preservekeys|boolean|^| |pesquisar|objeto|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |ordem de classificação|cadeia/matriz|^| |startSearch|boolean|^|