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 problems with the given IDs.| |groupids|string/array|Return only problems created by objects that belong to the given host groups.| |hostids|string/array|Return only problems created by objects that belong to the given hosts.| |objectids|string/array|Return only problems created by the given objects.| |source|integer|Return only problems with the given type.<br><br>Refer to the [problem event object page](object#problem) for a list of supported event types.<br><br>Default: 0 - problem created by a trigger.| |object|integer|Return only problems created by objects of the given type.<br><br>Refer to the [problem event object page](object#problem) for a list of supported object types.<br><br>Default: 0 - trigger.| |acknowledged|boolean|`true` - return acknowledged problems only;<br>`false` - unacknowledged only.| |suppressed|boolean|`true` - return only suppressed problems;<br>`false` - return problems in the normal state.| |severities|integer/array|Return only problems 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 problems 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 problems.<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.| |recent|boolean|`true` - return PROBLEM and recently RESOLVED problems (depends on Display OK triggers for N seconds)<br>Default: `false` - UNRESOLVED problems only| |eventid\_from|string|Return only problems with IDs greater or equal to the given ID.| |eventid\_till|string|Return only problems with IDs less or equal to the given ID.| |time\_from|timestamp|Return only problems that have been created after or at the given time.| |time\_till|timestamp|Return only problems that have been created before or at the given time.| |selectAcknowledges|query|Return an `acknowledges` property with the problem updates. Problem updates are sorted in reverse chronological order.<br><br>The problem update object has the following properties:<br>`acknowledgeid` - `(string)` update'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)`type of update action (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><br>Supports `count`.| |selectTags|query|Return a [tags](/manual/api/reference/problem/object#problem_tag) property with the problem tags. Output format: `[{"tag": "<tag>", "value": "<value>"}, ...]`.| |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 problem is suppressed.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `eventid`.| |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|Retornar apenas problemas com os IDs fornecidos.| |groupids|string/array|Retorna apenas problemas criados por objetos que pertencem aos grupos de hosts fornecidos.| |hostids|string/array|Retorna apenas problemas criados por objetos que pertencem aos hosts fornecidos.| |objectids|string/array|Retorna apenas os problemas criados pelos objetos fornecidos.| |source|integer|Retorna apenas problemas com o tipo fornecido.<br><br>Consulte a [página de objeto de evento de problema](object#problem) para obter uma lista de tipos de eventos compatíveis.<br><br>Padrão: 0 - problema criado por uma trigger.| |object|integer|Retorne apenas os problemas criados por objetos de um determinado tipo.<br><br>Consulte a [página do objeto de evento do problema](object#problem) para obter uma lista de tipos de objetos compatíveis.<br><br>Padrão: 0 - trigger.| |acknowledged|boolean|`true` - retornar somente problemas reconhecidos;<br>`false` - somente não reconhecidos.| |suppressed|boolean|`true` - retorna apenas problemas suprimidos;<br>`false` - retorna problemas no estado normal.| |severities|integer/array|Retorne apenas problemas com determinadas gravidades de eventos. Aplica-se apenas se o objeto for trigger.| |evaltype|integer|Regras para pesquisa de tags.<br><br>Valores possíveis:<br>0 - (padrão) And/Or;<br>2 - Or.| |tags|array of objects|Retorna apenas problemas 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 problemas.<br><br>Tipos de operadores possíveis:<br>0 - (padrão) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.| |recent|boolean|`true` - Retorna PROBLEM e recentemente RESOLVED problemas (depende dos acionadores de exibição OK por N segundos)<br>Padrão: `false` - apenas problemas UNRESOLVED| |eventid\_from|string|Retornar apenas problemas com IDs maiores ou iguais ao ID fornecido.| |eventid\_till|string|Retornar apenas problemas com IDs menores ou iguais ao ID fornecido.| |time\_from|timestamp|Retornar apenas os problemas que foram criados após ou no momento determinado.| |time\_till|timestamp|Retornar apenas problemas que foram criados antes ou no momento determinado.| |selectAcknowledges|query|Retorna uma propriedade `acknowledges` com as atualizações do problema. As atualizações de problemas são classificadas em ordem cronológica inversa.<br><br>O objeto de atualização do problema tem as seguintes propriedades:<br>`acknowledgeid` - `(string)` ID da atualização;<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` - `(string)` texto da mensagem;<br>`action` - `(integer)`tipo de ação de atualização (veja [event.acknowledge](/manual/api/reference/event/acknowledge));<br>`old_severity` - `(integer)` gravidade do evento antes desta ação de atualização;<br>`new_severity` - `(integer)` gravidade do evento após esta ação de atualização;<br><br>Suporta `count`.| |selectTags|query|Retorne uma propriedade [tags](/manual/api/reference/problem/object#problem_tag) com as tags de problema. Formato de saída: `[{"tag": "<tag>", "value": "<value>"}, ...]`.| |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é que o problema seja suprimido.| |sortfield|string/array|Classifique o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `eventid`.| |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/commentário_referência#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|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |graphids|string/array|Return only graph items that belong to the given graphs.| |itemids|string/array|Return only graph items with the given item IDs.| |type|integer|Return only graph items with the given type.<br><br>Refer to the [graph item object page](object#graph_item) for a list of supported graph item types.| |selectGraphs|query|Return a [graphs](/manual/api/reference/graph/object) property with an array of graphs that the item belongs to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `gitemid`.| |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|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |sortorder|string/array|^|
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| |---------|----------------------------------- ------------|-----------| |graphids|string/array|Retorna apenas itens de gráfico que pertencem aos gráficos fornecidos.| |itemids|string/array|Retorna apenas itens de gráfico com os IDs de item fornecidos.| |type|integer|Retorna apenas itens de gráfico com o tipo fornecido.<br><br>Consulte a [página de objeto de item de gráfico](object#graph_item) para obter uma lista de tipos de item de gráfico suportados.| |selectGraphs|query|Retorne uma propriedade [graphs](/manual/api/reference/graph/object) com um array de gráficos ao qual o item pertence.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `gitemid`.| |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|^| |limite|inteiro|^| |saída|consulta|^| |preservekeys|boolean|^| |ordem de classificação|cadeia/matriz|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |graphids|string/array|Return only graphs with the given IDs.| |groupids|string/array|Return only graphs that belong to hosts in the given host groups.| |templateids|string/array|Return only graph that belong to the given templates.| |hostids|string/array|Return only graphs that belong to the given hosts.| |itemids|string/array|Return only graphs that contain the given items.| |templated|boolean|If set to `true` return only graphs that belong to templates.| |inherited|boolean|If set to `true` return only graphs inherited from a template.| |expandName|flag|Expand macros in the graph name.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with the host groups that the graph belongs to.| |selectTemplates|query|Return a [templates](/manual/api/reference/template/object) property with the templates that the graph belongs to.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts that the graph belongs to.| |selectItems|query|Return an [items](/manual/api/reference/item/object) property with the items used in the graph.| |selectGraphDiscovery|query|Return a `graphDiscovery` property with the graph discovery object. The graph discovery objects links the graph to a graph prototype from which it was created.<br><br>It has the following properties:<br>`graphid` - `(string)` ID of the graph;<br>`parent_graphid` - `(string)` ID of the graph prototype from which the graph has been created.| |selectGraphItems|query|Return a [gitems](/manual/api/reference/graphitem/object) property with the items used in the graph.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/drule/object) property with the low-level discovery rule that created the graph.| |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 belongs to;<br>`hostid` - ID of the host that the graph 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) page.| |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|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |graphids|string/array|Retorna apenas gráficos com os IDs fornecidos.| |groupids|string/array|Retorna apenas gráficos que pertencem a hosts nos grupos de hosts especificados.| |templateids|string/array|Retorna apenas o gráfico que pertence aos modelos fornecidos.| |hostids|string/array|Retorna apenas os gráficos que pertencem aos hosts fornecidos.| |itemids|string/array|Retorna apenas os gráficos que contêm os itens fornecidos.| |templated|boolean|Se definido como `true`, retornará apenas os gráficos que pertencem aos modelos.| |inherited|boolean|Se definido como `true`, retornará apenas os gráficos herdados de um modelo.| |expandName|flag|Expandir macros no nome do gráfico.| |selectGroups|query|Retorne uma propriedade [groups](/manual/api/reference/hostgroup/object) com os grupos de hosts aos quais o gráfico pertence.| |selectTemplates|query|Retorne uma propriedade [templates](/manual/api/reference/template/object) com os templates aos quais o gráfico pertence.| |selectHosts|query|Retorne uma propriedade [hosts](/manual/api/reference/host/object) com os hosts aos quais o gráfico pertence.| |selectItems|query|Retorne uma propriedade [items](/manual/api/reference/item/object) com os itens usados no gráfico.| |selectGraphDiscovery|query|Retorne uma propriedade `graphDiscovery` com o objeto de descoberta de gráfico. Os objetos de descoberta de gráfico vinculam o gráfico a um protótipo de gráfico a partir do qual ele foi criado.<br><br>Ele tem as seguintes propriedades:<br>`graphid` - `(string)` ID do gráfico;<br>` parent_graphid` - `(string)` ID do protótipo do gráfico a partir do qual o gráfico foi criado.| |selectGraphItems|query|Retorne uma propriedade [gitems](/manual/api/reference/graphitem/object) com os itens usados no gráfico.| |selectDiscoveryRule|query|Retorne uma propriedade [discoveryRule](/manual/api/reference/drule/object) com a regra de descoberta de baixo nível que criou o gráfico.| |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 gráfico pertence;<br>`hostid` - ID do host ao qual o 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 na página [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| |---------|---------------------------------------------------|-----------| |graphids|string/array|Return only host groups that contain hosts or templates with the given graphs.| |groupids|string/array|Return only host groups with the given host group IDs.| |hostids|string/array|Return only host groups that contain the given hosts.| |maintenanceids|string/array|Return only host groups that are affected by the given maintenances.| |monitored\_hosts|flag|Return only host groups that contain monitored hosts.| |real\_hosts|flag|Return only host groups that contain hosts.| |templated\_hosts|flag|Return only host groups that contain templates.| |templateids|string/array|Return only host groups that contain the given templates.| |triggerids|string/array|Return only host groups that contain hosts or templates with the given triggers.| |with\_graphs|flag|Return only host groups that contain hosts with graphs.| |with\_graph\_prototypes|flag|Return only host groups that contain hosts with graph prototypes.| |with\_hosts\_and\_templates|flag|Return only host groups that contain hosts *or* templates.| |with\_httptests|flag|Return only host groups that contain hosts with web checks.<br><br>Overrides the `with_monitored_httptests` parameter.| |with\_items|flag|Return only host groups that contain hosts or templates with items.<br><br>Overrides the `with_monitored_items` and`with_simple_graph_items` parameters.| |with\_item\_prototypes|flag|Return only host groups that contain hosts with item prototypes.<br><br>Overrides the `with_simple_graph_item_prototypes` parameter.| |with\_simple\_graph\_item\_prototypes|flag|Return only host groups that contain hosts with item prototypes, which are enabled for creation and have numeric type of information.| |with\_monitored\_httptests|flag|Return only host groups that contain hosts with enabled web checks.| |with\_monitored\_items|flag|Return only host groups that contain hosts or templates with enabled items.<br><br>Overrides the `with_simple_graph_items` parameter.| |with\_monitored\_triggers|flag|Return only host groups that contain hosts with enabled triggers. All of the items used in the trigger must also be enabled.| |with\_simple\_graph\_items|flag|Return only host groups that contain hosts with numeric items.| |with\_triggers|flag|Return only host groups that contain hosts with triggers.<br><br>Overrides the `with_monitored_triggers` parameter.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/drule/object) property with the LLD rule that created the host group.| |selectGroupDiscovery|query|Return a `groupDiscovery` property with the host group discovery object.<br><br>The host group discovery object links a discovered host group to a host group prototype and has the following properties:<br>`groupid` - `(string)` ID of the discovered host group;<br>`lastcheck` - `(timestamp)` time when the host group was last discovered;<br>`name` - `(string)` name of the host goup prototype;<br>`parent_group_prototypeid` - `(string)` ID of the host group prototype from which the host group has been created;<br>`ts_delete` - `(timestamp)` time when a host group that is no longer discovered will be deleted.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts that belong to the host group.<br><br>Supports `count`.| |selectTemplates|query|Return a [templates](/manual/api/reference/template/object) property with the templates that belong to the host group.<br><br>Supports `count`.| |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`;<br>`selectTemplates` - results will be sorted by `host`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `groupid`, `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) 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| |---------|----------------------------------- ------------|-----------| |graphids|string/array|Retorna apenas grupos de hosts que contêm hosts ou modelos com os gráficos fornecidos.| |groupids|string/array|Retorna apenas grupos de hosts com os IDs de grupos de hosts fornecidos.| |hostids|string/array|Retorna apenas grupos de hosts que contêm os hosts fornecidos.| |maintenanceids|string/array|Retorna apenas os grupos de hosts afetados pelas manutenções fornecidas.| |monitored\_hosts|flag|Retorna apenas grupos de hosts que contêm hosts monitorados.| |real\_hosts|flag|Retorna apenas grupos de hosts que contêm hosts.| |templated\_hosts|flag|Retorna apenas grupos de hosts que contêm templates.| |templateids|string/array|Retorna apenas grupos de hosts que contêm os modelos fornecidos.| |triggerids|string/array|Retorna apenas grupos de hosts que contêm hosts ou modelos com os gatilhos fornecidos.| |with\_graphs|flag|Retorna apenas grupos de hosts que contêm hosts com gráficos.| |with\_graph\_prototypes|flag|Retorna apenas grupos de hosts que contêm hosts com protótipos de gráficos.| |with\_hosts\_and\_templates|flag|Retorne apenas grupos de hosts que contenham hosts *ou* templates.| |with\_httptests|flag|Retorna apenas grupos de hosts que contêm hosts com verificações da web.<br><br>Substitui o parâmetro `with_monitored_httptests`.| |with\_items|flag|Retorna apenas grupos de hosts que contenham hosts ou templates com itens.<br><br>Substitui os parâmetros `with_monitored_items` e`with_simple_graph_items`.| |with\_item\_prototypes|flag|Retorna apenas grupos de hosts que contêm hosts com protótipos de itens.<br><br>Substitui o parâmetro `with_simple_graph_item_prototypes`.| |with\_simple\_graph\_item\_prototypes|flag|Retorna apenas grupos de hosts que contêm hosts com protótipos de itens, que são ativados para criação e possuem informações do tipo numérico.| |with\_monitored\_httptests|flag|Retorna apenas grupos de hosts que contenham hosts com verificações da web habilitadas.| |with\_monitored\_items|flag|Retorna apenas grupos de hosts que contenham hosts ou templates com itens habilitados.<br><br>Substitui o parâmetro `with_simple_graph_items`.| |with\_monitored\_triggers|flag|Retorna apenas grupos de hosts que contêm hosts com acionadores ativados. Todos os itens usados no gatilho também devem estar habilitados.| |with\_simple\_graph\_items|flag|Retorna apenas grupos de hosts que contenham hosts com itens numéricos.| |with\_triggers|flag|Retorna apenas grupos de hosts que contêm hosts com gatilhos.<br><br>Substitui o parâmetro `with_monitored_triggers`.| |selectDiscoveryRule|query|Retorne uma propriedade [discoveryRule](/manual/api/reference/drule/object) com a regra LLD que criou o grupo de hosts.| |selectGroupDiscovery|query|Retorne uma propriedade `groupDiscovery` com o objeto de descoberta do grupo de hosts.<br><br>O objeto de descoberta do grupo de hosts vincula um grupo de hosts descoberto a um protótipo de grupo de hosts e tem as seguintes propriedades:<br>`groupid ` - `(string)` ID do grupo de hosts descoberto;<br>`lastcheck` - `(timestamp)` hora em que o grupo de hosts foi descoberto pela última vez;<br>`name` - `(string)` nome do protótipo do grupo de hosts;<br>`parent_group_prototypeid` - `(string)` ID do protótipo do grupo de hosts a partir do qual o grupo de hosts foi criado;<br>`ts_delete` - `(timestamp)` hora em que um grupo de hosts que é não mais descoberto será excluído.| |selectHosts|query|Retorne uma propriedade [hosts](/manual/api/reference/host/object) com os hosts que pertencem ao grupo de hosts.<br><br>Suporta `count`.| |selectTemplates|query|Retorne uma propriedade [templates](/manual/api/reference/template/object) com os templates que pertencem ao grupo de hosts.<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` - os resultados serão classificados por `host`;<br>`selectTemplates` - resultados será ordenado por `host`.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `groupid`, `name`.| |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| |---------|---------------------------------------------------|-----------| |groupids|string/array|Return only hosts that belong to the given groups.| |dserviceids|string/array|Return only hosts that are related to the given discovered services.| |graphids|string/array|Return only hosts that have the given graphs.| |hostids|string/array|Return only hosts with the given host IDs.| |httptestids|string/array|Return only hosts that have the given web checks.| |interfaceids|string/array|Return only hosts that use the given interfaces.| |itemids|string/array|Return only hosts that have the given items.| |maintenanceids|string/array|Return only hosts that are affected by the given maintenances.| |monitored\_hosts|flag|Return only monitored hosts.| |proxy\_hosts|flag|Return only proxies.| |proxyids|string/array|Return only hosts that are monitored by the given proxies.| |templated\_hosts|flag|Return both hosts and templates.| |templateids|string/array|Return only hosts that are linked to the given templates.| |triggerids|string/array|Return only hosts that have the given triggers.| |with\_items|flag|Return only hosts that have items.<br><br>Overrides the `with_monitored_items` and `with_simple_graph_items` parameters.| |with\_item\_prototypes|flag|Return only hosts that have item prototypes.<br><br>Overrides the `with_simple_graph_item_prototypes` parameter.| |with\_simple\_graph\_item\_prototypes|flag|Return only hosts that have item prototypes, which are enabled for creation and have numeric type of information.| |with\_graphs|flag|Return only hosts that have graphs.| |with\_graph\_prototypes|flag|Return only hosts that have graph prototypes.| |with\_httptests|flag|Return only hosts that have web checks.<br><br>Overrides the `with_monitored_httptests` parameter.| |with\_monitored\_httptests|flag|Return only hosts that have enabled web checks.| |with\_monitored\_items|flag|Return only hosts that have enabled items.<br><br>Overrides the `with_simple_graph_items` parameter.| |with\_monitored\_triggers|flag|Return only hosts that have enabled triggers. All of the items used in the trigger must also be enabled.| |with\_simple\_graph\_items|flag|Return only hosts that have items with numeric type of information.| |with\_triggers|flag|Return only hosts that have triggers.<br><br>Overrides the `with_monitored_triggers` parameter.| |withProblemsSuppressed|boolean|Return hosts that have suppressed problems.<br><br>Possible values:<br>`null` - (default) all hosts;<br>`true` - only hosts with suppressed problems;<br>`false` - only hosts with unsuppressed problems.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |severities|integer/array|Return hosts that have only problems with given severities. Applies only if problem object is trigger.| |tags|array/object|Return only hosts with given tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all hosts.<br><br>Possible operator values:<br>0 - (default) Contains;<br>1 - Equals;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.| |inheritedTags|boolean|Return hosts that have given `tags` also in all of their linked templates. Default:<br><br>Possible values:<br>`true` - linked templates must also have given `tags`;<br>`false` - (default) linked template tags are ignored.| |selectDiscoveries|query|Return a [discoveries](/manual/api/reference/discoveryrule/object) property with host low-level discovery rules.<br><br>Supports `count`.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/discoveryrule/object) property with the low-level discovery rule that created the host (from host prototype in VMware monitoring).| |selectGraphs|query|Return a [graphs](/manual/api/reference/graph/object) property with host graphs.<br><br>Supports `count`.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with host groups data that the host belongs to.| |selectHostDiscovery|query|Return a `hostDiscovery` property with host discovery object data.<br><br>The host discovery object links a discovered host to a host prototype or a host prototypes to an LLD rule and has the following properties:<br>`host` - *(string)* host of the host prototype;<br>`hostid` - *(string)* ID of the discovered host or host prototype;<br>`parent_hostid` - *(string)* ID of the host prototype from which the host has been created;<br>`parent_itemid` - *(string)* ID of the LLD rule that created the discovered host;<br>`lastcheck` - *(timestamp)* time when the host was last discovered;<br>`ts_delete` - *(timestamp)* time when a host that is no longer discovered will be deleted.| |selectHttpTests|query|Return an [httpTests](/manual/api/reference/httptest/object) property with host web scenarios.<br><br>Supports `count`.| |selectInterfaces|query|Return an [interfaces](/manual/api/reference/hostinterface/object) property with host interfaces.<br><br>Supports `count`.| |selectInventory|query|Return an [inventory](/manual/api/reference/host/object#host_inventory) property with host inventory data.| |selectItems|query|Return an [items](/manual/api/reference/item/object) property with host items.<br><br>Supports `count`.| |selectMacros|query|Return a [macros](/manual/api/reference/usermacro/object) property with host macros.| |selectParentTemplates|query|Return a [parentTemplates](/manual/api/reference/template/object) property with templates that the host is linked to.<br><br>Supports `count`.| |selectDashboards|query|Return a [dashboards](/manual/api/reference/templatedashboard/object) property.<br><br>Supports `count`.| |selectTags|query|Return a [tags](/manual/api/reference/host/object#host_tag) property with host tags.| |selectInheritedTags|query|Return an [inheritedTags](/manual/api/reference/host/object#host_tag) property with tags that are on all templates which are linked to host.| |selectTriggers|query|Return a [triggers](/manual/api/reference/trigger/object) property with host triggers.<br><br>Supports `count`.| |selectValueMaps|query|Return a [valuemaps](/manual/api/reference/valuemap/object) property with host value maps.| |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>Allows filtering by interface properties.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectParentTemplates` - results will be sorted by `host`;<br>`selectInterfaces`;<br>`selectItems` - sorted by `name`;<br>`selectDiscoveries` - sorted by `name`;<br>`selectTriggers` - sorted by `description`;<br>`selectGraphs` - sorted by `name`;<br>`selectDashboards` - sorted by `name`.| |search|object|Return results that match the given wildcard search.<br><br>Accepts an array, where the keys are property names, and the values are strings to search for. If no additional options are given, this will perform a `LIKE "%…%"` search.<br><br>Allows searching by interface properties. Works only with text fields.| |searchInventory|object|Return only hosts that have inventory data matching the given wildcard search.<br><br>This parameter is affected by the same additional parameters as `search`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `hostid`, `host`, `name`, `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|^| |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| |---------|----------------------------------- ------------|-----------| |groupids|string/array|Retorna apenas hosts que pertencem aos grupos indicados.| |dserviceids|string/array|Retorna apenas hosts relacionados aos serviços descobertos fornecidos.| |graphids|string/array|Retorna apenas hosts que possuem os gráficos fornecidos.| |hostids|string/array|Retorna apenas hosts com os IDs de host fornecidos.| |httptestids|string/array|Retorna apenas hosts que possuem as verificações da web fornecidas.| |interfaceids|string/array|Retorna apenas hosts que usam as interfaces fornecidas.| |itemids|string/array|Retorna apenas hosts que possuem os itens fornecidos.| |maintenanceids|string/array|Retorna apenas os hosts afetados pelas manutenções fornecidas.| |monitored\_hosts|flag|Retorna apenas hosts monitorados.| |proxy\_hosts|flag|Retorna apenas proxies.| |proxyids|string/array|Retorna apenas os hosts monitorados pelos proxies fornecidos.| |templated\_hosts|flag|Retorne tanto hosts quanto templates.| |templateids|string/array|Retorna apenas hosts que estão vinculados aos modelos fornecidos.| |triggerids|string/array|Retorna apenas hosts que possuem os gatilhos fornecidos.| |with\_items|flag|Retorna apenas hosts que possuem itens.<br><br>Substitui os parâmetros `with_monitored_items` e `with_simple_graph_items`.| |with\_item\_prototypes|flag|Retorna apenas hosts que possuem protótipos de itens.<br><br>Substitui o parâmetro `with_simple_graph_item_prototypes`.| |with\_simple\_graph\_item\_prototypes|flag|Retorna apenas hosts que possuem protótipos de itens, que são habilitados para criação e possuem tipo numérico de informação.| |with\_graphs|flag|Retorna apenas hosts que possuem gráficos.| |with\_graph\_prototypes|flag|Retorna apenas hosts que possuem protótipos de grafos.| |with\_httptests|flag|Retorna apenas hosts que possuem verificações da web.<br><br>Substitui o parâmetro `with_monitored_httptests`.| |with\_monitored\_httptests|flag|Retorna apenas hosts que habilitaram verificações da web.| |with\_monitored\_items|flag|Retorna apenas hosts que tenham itens habilitados.<br><br>Substitui o parâmetro `with_simple_graph_items`.| |with\_monitored\_triggers|flag|Retorna apenas os hosts que possuem triggers habilitados. Todos os itens usados ​​no gatilho também devem estar habilitados.| |with\_simple\_graph\_items|flag|Retorna apenas hosts que possuem itens com tipo numérico de informação.| |with\_triggers|flag|Retorna apenas hosts que possuem triggers.<br><br>Substitui o parâmetro `with_monitored_triggers`.| |withProblemsSuppressed|boolean|Retorna hosts que suprimiram problemas.<br><br>Valores possíveis:<br>`null` - (padrão) todos os hosts;<br>`true` - somente hosts com problemas suprimidos;<br> `false` - somente hosts com problemas não suprimidos.| |evaltype|integer|Regras para pesquisa de tags.<br><br>Valores possíveis:<br>0 - (padrão) E/Ou;<br>2 - Ou.| |severities|integer/array|Anfitriões de retorno que têm apenas problemas com determinadas gravidades. Aplica-se apenas se o objeto do problema for acionador.| |tags|array/object|Retorna apenas hosts com as tags fornecidas. Correspondência exata por tag e pesquisa com distinção entre maiúsculas e minúsculas por valor de tag, dependendo do valor do operador.<br>Formato: `[{"tag": "<tag>", "value": "<value>", " operator": "<operator>"}, ...]`.<br>Um array vazio retorna todos os hosts.<br><br>Possíveis valores de operador:<br>0 - (padrão) Contém;<br>1 - Igual;<br>2 - Não gosto;<br>3 - Não igual<br>4 - Existe;<br>5 - Não existe.| |inheritedTags|boolean|Retorna hosts que deram `tags` também em todos os seus templates vinculados. Padrão:<br><br>Valores possíveis:<br>`true` - templates vinculados também devem ter dado `tags`;<br>`false` - (padrão) tags de templates vinculados são ignoradas.| |selectDiscoveries|query|Retorne uma propriedade [discoveries](/manual/api/reference/discoveryrule/object) com regras de descoberta de baixo nível do host.<br><br>Suporta `count`.| |selectDiscoveryRule|query|Retorne uma propriedade [discoveryRule](/manual/api/reference/discoveryrule/object) com a regra de descoberta de baixo nível que criou o host (do protótipo do host no monitoramento VMware).| |selectGraphs|query|Retorne uma propriedade [graphs](/manual/api/reference/graph/object) com gráficos de host.<br><br>Suporta `count`.| |selectGroups|query|Retorne uma propriedade [groups](/manual/api/reference/hostgroup/object) com dados de grupos de hosts aos quais o host pertence.| |selectHostDiscovery|query|Retorne uma propriedade `hostDiscovery` com dados do objeto de descoberta de host.<br><br>O objeto de descoberta de host vincula um host descoberto a um protótipo de host ou protótipos de host a uma regra LLD e tem as seguintes propriedades:< br>`host` - *(string)* host do protótipo do host;<br>`hostid` - *(string)* ID do host ou protótipo do host descoberto;<br>`parent_hostid` - *(string)* ID do protótipo do host a partir do qual o host foi criado;<br>`parent_itemid` - *(string)* ID da regra LLD que criou o host descoberto;<br>`lastcheck` - *(timestamp)* hora em que o host foi descoberto pela última vez;<br>`ts_delete` - *(timestamp)* hora em que um host que não é longer descoberto será excluído.| |selectHttpTests|query|Retorne uma propriedade [httpTests](/manual/api/reference/httptest/object) com cenários da web do host.<br><br>Suporta `count`.| |selectInterfaces|query|Retorna uma propriedade de [interfaces](/manual/api/reference/hostinterface/object) com interfaces de host.<br><br>Suporta `count`.| |selectInventory|query|Retorne uma propriedade de [inventário](/manual/api/reference/host/object#host_inventory) com dados de inventário do host.| |selectItems|query|Retorne uma propriedade [items](/manual/api/reference/item/object) com itens do host.<br><br>Suporta `count`.| |selectMacros|query|Retorne uma propriedade [macros](/manual/api/reference/usermacro/object) com macros do host.| |selectParentTemplates|query|Retorne uma propriedade [parentTemplates](/manual/api/reference/template/object) com modelos aos quais o host está vinculado.<br><br>Suporta `count`.| |selectDashboards|query|Retorna uma propriedade de [painéis](/manual/api/reference/templatedashboard/object).<br><br>Suporta `count`.| |selectTags|query|Retorne uma propriedade [tags](/manual/api/reference/host/object#host_tag) com tags de host.| |selectInheritedTags|query|Retorne uma propriedade [inheritedTags](/manual/api/reference/host/object#host_tag) com tags que estão em todos os templates que estão vinculados ao host.| |selectTriggers|query|Retorne uma propriedade [triggers](/manual/api/reference/trigger/object) com acionadores de host.<br><br>Suporta `count`.| |selectValueMaps|query|Retorne uma propriedade [valuemaps](/manual/api/reference/valuemap/object) com mapas de valor do host.| |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>Permite filtrar por propriedades da interface.| |limitSelects|integer|Limite o número de registros retornados por subseleções.<br><br>Aplica-se às seguintes subseleções:<br>`selectParentTemplates` - os resultados serão classificados por `host`;<br>`selectInterfaces`;< br>`selectItems` - ordenado por `name`;<br>`selectDiscoveries` - ordenado por `name`;<br>`selectTriggers` - ordenado por `description`;<br>`selectGraphs` - ordenado por `name` ;<br>`selectDashboards` - ordenado por `name`.| |pesquisa|objeto|Retorna resultados que correspondam à pesquisa de curinga fornecida.<br><br>Aceita uma matriz, em que as chaves são nomes de propriedades e os valores são strings a serem pesquisadas. Se nenhuma opção adicional for fornecida, isso fará uma pesquisa `LIKE "%…%"`.<br><br>Permite pesquisar pelas propriedades da interface. Funciona apenas com campos de texto.| |searchInventory|object|Retorna apenas hosts que tenham dados de inventário que correspondam à pesquisa de curinga fornecida.<br><br>Este parâmetro é afetado pelos mesmos parâmetros adicionais que `search`.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `hostid`, `host`, `name`, `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|^| |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| |--|--|------| |groupids|string/array|Return only maintenances that are assigned to the given host groups.| |hostids|string/array|Return only maintenances that are assigned to the given hosts.| |maintenanceids|string/array|Return only maintenances with the given IDs.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with host groups assigned to the maintenance.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with hosts assigned to the maintenance.| |selectTags|query|Return a [tags](/manual/api/reference/maintenance/object#problem_tag) property with problem tags of the maintenance.| |selectTimeperiods|query|Return a [timeperiods](/manual/api/reference/maintenance/object#Time_period) property with time periods of the maintenance.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `maintenanceid`, `name` and `maintenance_type`.| |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| |--|--|------| |groupids|string/array|Retornar apenas as manutenções atribuídas aos grupos de hosts fornecidos.| |hostids|string/array|Retornar apenas as manutenções atribuídas aos hosts fornecidos.| |maintenanceids|string/array|Devolva apenas manutenções com os IDs fornecidos.| |selectGroups|query|Retorne uma propriedade [groups](/manual/api/reference/hostgroup/object) com grupos de hosts atribuídos à manutenção.| |selectHosts|query|Retorne uma propriedade [hosts](/manual/api/reference/host/object) com hosts atribuídos à manutenção.| |selectTags|query|Retorna uma propriedade [tags](/manual/api/reference/maintenance/object#problem_tag) com tags de problema da manutenção.| |selectTimeperiods|query|Retorna uma propriedade [tags](/manual/api/reference/maintenance/object#problem_tag) com tags de problema da manutenção.| |sortfield|string/array|Classifique o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `maintenanceid`, `name` e `maintenance_type`.| |countOutput|boolean|Esses parâmetros sendo comuns para todos os métodos `get` são descritos em detalhes em [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| |--|--|------| |groupids|string/array|Return only scripts that can be run on the given host groups.| |hostids|string/array|Return only scripts that can be run on the given hosts.| |scriptids|string/array|Return only scripts with the given IDs.| |usrgrpids|string/array|Return only scripts that can be run by users in the given user groups.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with host groups that the script can be run on.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with hosts that the script can be run on.| |selectActions|query|Return a [actions](/manual/api/reference/action/object) property with actions that the script is associated with.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `scriptid` 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 parâmetros a seguir.      |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |groupids|string/array|Retorna apenas scripts que podem ser executados nos grupos de hosts fornecidos.| |hostids|string/array|Retorna apenas scripts que podem ser executados nos hosts fornecidos.| |scriptids|string/array|Retornar apenas scripts com os IDs fornecidos.| |usrgrpids|string/array|Retorna apenas scripts que podem ser executados por usuários em determinados grupos de usuários.| |selectGroups|query|Retorna uma propriedade [groups](/manual/api/reference/hostgroup/object) com grupos de hosts nos quais o script pode ser executado.| |selectHosts|query|Retorna uma propriedade [hosts](/manual/api/reference/host/object) com hosts nos quais o script pode ser executado.| |selectActions|query|Retorna uma propriedade [actions](/manual/api/reference/action/object) com ações às quais o script está associado.| |sortfield|string/array|Classifique o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `scriptid` 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).| |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| |--|--|------| |groupids|string/array|Return only web scenarios that belong to the given host groups.| |hostids|string/array|Return only web scenarios that belong to the given hosts.| |httptestids|string/array|Return only web scenarios with the given IDs.| |inherited|boolean|If set to `true` return only web scenarios inherited from a template.| |monitored|boolean|If set to `true` return only enabled web scenarios that belong to monitored hosts.| |templated|boolean|If set to `true` return only web scenarios that belong to templates.| |templateids|string/array|Return only web scenarios that belong to the given templates.| |expandName|flag|Expand macros in the name of the web scenario.| |expandStepName|flag|Expand macros in the names of scenario steps.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only web scenarios with given tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all web scenarios.<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.| |selectHosts|query|Return the hosts that the web scenario belongs to as an array in the [hosts](/manual/api/reference/host/object) property.| |selectSteps|query|Return web scenario steps in the [steps](/manual/api/reference/httptest/object#scenario_step) property.<br><br>Supports `count`.| |selectTags|query|Return the web scenario tags in [tags](/manual/api/reference/httptest/object#web_scenario_tag) property.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `httptestid` 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| |--|--|------| |groupids|string/array|Retornar apenas cenários Web que pertencem aos grupos de hosts fornecidos.| |hostids|string/array|Retornar apenas cenários Web que pertencem aos hosts fornecidos.| |httptestids|string/array|Retornar apenas cenários web com os IDs fornecidos.| |inherited|boolean|Se definido como `true`, retorna apenas cenários web herdados de um modelo.| |monitored|boolean|Se definido como `true`, retorna apenas cenários Web habilitados que pertencem a hosts monitorados.| |templated|boolean|Se definido como `true`, retornará apenas cenários da Web que pertencem a modelos.| |templateids|string/array|Retornar apenas cenários da Web que pertencem aos modelos fornecidos.| |expandName|flag|Expandir macros no nome do cenário web.| |expandStepName|flag|Expandir macros nos nomes das etapas do cenário.| |evaltype|integer|Regras para pesquisa de tags.<br><br>Valores possíveis:<br>0 - (padrão) And/Or;<br>2 - Or.| |tags|array de objetos|Retorne apenas cenários Web com as tags fornecidas. Correspondência exata por tag e pesquisa com distinção entre maiúsculas e minúsculas por valor de tag, dependendo do valor do operador.<br>Formato: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>Uma matriz vazia retorna todos os cenários web.<br><br>Tipos de operadores possíveis:<br>0 - (padrão) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.| |selectHosts|query|Retorne os hosts aos quais o cenário da web pertence como um array na propriedade [hosts](/manual/api/reference/host/object).| |selectSteps|query|Retorne as etapas do cenário da Web na propriedade [steps](/manual/api/reference/httptest/object#scenario_step).<br><br>Suporta `count`.| |selectTags|query|Retorne as tags do cenário web na propriedade [tags](/manual/api/reference/httptest/object#web_scenario_tag).| |sortfield|string/array|Classifique o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `httptestid` e `name`.| |countOutput|boolean|Esses parâmetros sendo comuns para todos os métodos `get` são descritos em detalhes no [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|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |ha\_nodeids|string/array|Return only nodes with the given node IDs.| |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>Allows filtering by the node properties: `name`, `address`, `status`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `name`, `lastaccess`, `status`.| |countOutput|flag|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |sortorder|string/array|^|
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| |---------|----------------------------------- ------------|-----------| |ha\_nodeids|string/array|Retorna apenas nós com os IDs de nó fornecidos.| |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>Permite filtrar pelas propriedades do nó: `name`, `address`, `status`.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `name`, `lastaccess`, `status`.| |countOutput|flag|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).| |limite|inteiro|^| |saída|consulta|^| |preservekeys|boolean|^| |ordem de classificação|cadeia/matriz|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |history|integer|History object types to return.<br><br>Possible values:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - numeric unsigned;<br>4 - text.<br><br>Default: 3.| |hostids|string/array|Return only history from the given hosts.| |itemids|string/array|Return only history from the given items.| |time\_from|timestamp|Return only values that have been received after or at the given time.| |time\_till|timestamp|Return only values that have been received before or at the given time.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `itemid` 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|^| |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| |---------|----------------------------------- ------------|-----------| |history|integer|Tipos de objeto de histórico a serem retornados.<br><br>Valores possíveis:<br>0 - numérico float;<br>1 - caractere;<br>2 - log;<br>3 - numérico unsigned; <br>4 - texto.<br><br>Padrão: 3.| |hostids|string/array|Retorna apenas o histórico dos hosts fornecidos.| |itemids|string/array|Retorna apenas o histórico dos itens fornecidos.| |time\_from|timestamp|Retorna apenas os valores que foram recebidos após ou no momento determinado.| |time\_till|timestamp|Retorna apenas os valores que foram recebidos antes ou no momento determinado.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `itemid` 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|^| |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| |---------|---------------------------------------------------|-----------| |hostids|string/array|Return only host interfaces used by the given hosts.| |interfaceids|string/array|Return only host interfaces with the given IDs.| |itemids|string/array|Return only host interfaces used by the given items.| |triggerids|string/array|Return only host interfaces used by items in the given triggers.| |selectItems|query|Return an [items](/manual/api/reference/host/object) property with the items that use the interface.<br><br>Supports `count`.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with an array of hosts that use the interface.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectItems`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `interfaceid`, `dns`, `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) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |nodeids|string/array|^| |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| |---------|----------------------------------- ------------|-----------| |hostids|string/array|Retorna apenas interfaces de host usadas pelos hosts fornecidos.| |interfaceids|string/array|Retorna apenas interfaces de host com os IDs fornecidos.| |itemids|string/array|Retorna apenas interfaces de host usadas pelos itens fornecidos.| |triggerids|string/array|Retorna apenas interfaces de host usadas por itens nos gatilhos fornecidos.| |selectItems|query|Retorne uma propriedade [items](/manual/api/reference/host/object) com os itens que usam a interface.<br><br>Suporta `count`.| |selectHosts|query|Retorne uma propriedade [hosts](/manual/api/reference/host/object) com uma matriz de hosts que usam a interface.| |limitSelects|integer|Limite o número de registros retornados por subseleções.<br><br>Aplica-se às seguintes subseleções:<br>`selectItems`.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `interfaceid`, `dns`, `ip`.| |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|^| |nodeids|string/array|^| |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| |---------|---------------------------------------------------|-----------| |hostids|string/array|Return only host prototypes with the given IDs.| |discoveryids|string/array|Return only host prototype that belong to the given LLD rules.| |inherited|boolean|If set to `true` return only items inherited from a template.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/discoveryrule/object#lld_rule) property with the LLD rule that the host prototype belongs to.| |selectInterfaces|query|Return an [interfaces](/manual/api/reference/hostprototype/object#custom_interface) property with host prototype custom interfaces.| |selectGroupLinks|query|Return a [groupLinks](/manual/api/reference/hostprototype/object#group_link) property with the group links of the host prototype.| |selectGroupPrototypes|query|Return a [groupPrototypes](/manual/api/reference/hostprototype/object#group_prototype) property with the group prototypes of the host prototype.| |selectMacros|query|Return a [macros](/manual/api/reference/usermacro/object) property with host prototype macros.| |selectParentHost|query|Return a [parentHost](/manual/api/reference/host/object) property with the host that the host prototype belongs to.| |selectTags|query|Return a [tags](/manual/api/reference/hostprototype/object#host_prototype_tag) property with host prototype tags.| |selectTemplates|query|Return a [templates](/manual/api/reference/template/object) property with the templates linked to the host prototype.<br><br>Supports `count`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `hostid`, `host`, `name` and `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail on the [Generic Zabbix API information](/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| |---------|----------------------------------- ------------|-----------| |hostids|string/array|Retorna apenas protótipos de host com os IDs fornecidos.| |discoveryids|string/array|Retorna apenas o protótipo do host que pertence às regras LLD fornecidas.| |inherited|boolean|Se definido como `true`, retornará apenas itens herdados de um modelo.| |selectDiscoveryRule|query|Retorne uma propriedade [discoveryRule](/manual/api/reference/discoveryrule/object#lld_rule) com a regra LLD à qual o protótipo do host pertence.| |selectInterfaces|query|Retorne uma propriedade [interfaces](/manual/api/reference/hostprototype/object#custom_interface) com interfaces customizadas de protótipo de host.| |selectGroupLinks|query|Retorne uma propriedade [groupLinks](/manual/api/reference/hostprototype/object#group_link) com os links de grupo do protótipo do host.| |selectGroupPrototypes|query|Retorne uma propriedade [groupPrototypes](/manual/api/reference/hostprototype/object#group_prototype) com os protótipos de grupo do protótipo do host.| |selectMacros|query|Retorne uma propriedade [macros](/manual/api/reference/usermacro/object) com macros de protótipo de host.| |selectParentHost|query|Retorne uma propriedade [parentHost](/manual/api/reference/host/object) com o host ao qual o protótipo do host pertence.| |selectTags|query|Retorne uma propriedade [tags](/manual/api/reference/hostprototype/object#host_prototype_tag) com tags de protótipo do host.| |selectTemplates|query|Retorne uma propriedade [templates](/manual/api/reference/template/object) com os modelos vinculados ao protótipo do host.<br><br>Suporta `count`.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `hostid`, `host`, `name` e `status`.| |countOutput|boolean|Estes parâmetros sendo comuns para todos os métodos `get` são descritos em detalhes na página [Informações genéricas da API Zabbix](/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| |---------|---------------------------------------------------|-----------| |iconmapids|string/array|Return only icon maps with the given IDs.| |sysmapids|string/array|Return only icon maps that are used in the given maps.| |selectMappings|query|Return a [mappings](/manual/api/reference/iconmap/object#icon_mapping) property with the icon mappings used.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `iconmapid` 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 parâmetros a seguir.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |iconmapids|string/array|Retorna apenas mapas de ícones com os IDs fornecidos.| |sysmapids|string/array|Retorna apenas mapas de ícones que são usados nos mapas fornecidos.| |selectMappings|query|Retorne uma propriedade [mappings](/manual/api/reference/iconmap/object#icon_mapping) com os mapeamentos de ícone usados.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `iconmapid` e `name`.| |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| |---------|---------------------------------------------------|-----------| |imageids|string/array|Return only images with the given IDs.| |sysmapids|string/array|Return images that are used on the given maps.| |select\_image|flag|Return an `image` property with the Base64 encoded image.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `imageid` 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| |---------|----------------------------------- ------------|-----------| |imageids|string/array|Retorna apenas imagens com os IDs fornecidos.| |sysmapids|string/array|Retorna imagens que são usadas nos mapas fornecidos.| |select\_image|flag|Retorne uma propriedade `image` com a imagem codificada em Base64.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `imageid` e `name`.| |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| |---------|---------------------------------------------------|-----------| |itemids|string/array|Return only items with the given IDs.| |groupids|string/array|Return only items that belong to the hosts from the given groups.| |templateids|string/array|Return only items that belong to the given templates.| |hostids|string/array|Return only items that belong to the given hosts.| |proxyids|string/array|Return only items that are monitored by the given proxies.| |interfaceids|string/array|Return only items that use the given host interfaces.| |graphids|string/array|Return only items that are used in the given graphs.| |triggerids|string/array|Return only items that are used in the given triggers.| |webitems|flag|Include web items in the result.| |inherited|boolean|If set to `true` return only items inherited from a template.| |templated|boolean|If set to `true` return only items that belong to templates.| |monitored|boolean|If set to `true` return only enabled items that belong to monitored hosts.| |group|string|Return only items that belong to a group with the given name.| |host|string|Return only items that belong to a host with the given name.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only items with given tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all items.<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.| |with\_triggers|boolean|If set to `true` return only items that are used in triggers.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with an array of hosts that the item belongs to.| |selectInterfaces|query|Return an [interfaces](/manual/api/reference/hostinterface/object) property with an array of host interfaces used by the item.| |selectTriggers|query|Return a [triggers](/manual/api/reference/trigger/object) property with the triggers that the item is used in.<br><br>Supports `count`.| |selectGraphs|query|Return a [graphs](/manual/api/reference/graph/object) property with the graphs that contain the item.<br><br>Supports `count`.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/drule/object) property with the LLD rule that created the item.| |selectItemDiscovery|query|Return an `itemDiscovery` property with the item discovery object. The item discovery object links the item to an item prototype from which it was created.<br><br>It has the following properties:<br>`itemdiscoveryid` - `(string)` ID of the item discovery;<br>`itemid` - `(string)` ID of the discovered item;<br>`parent_itemid` - `(string)` ID of the item prototype from which the item has been created;<br>`key_` - `(string)` key of the item prototype;<br>`lastcheck` - `(timestamp)` time when the item was last discovered;<br>`ts_delete` - `(timestamp)` time when an item that is no longer discovered will be deleted.| |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.| |selectTags|query|Return the item tags in [tags](/manual/api/reference/item/object#Item_tag) property.| |selectValueMap|query|Return a [valuemap](/manual/api/reference/valuemap/object) property with item 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 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`, `history`, `trends`, `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) page.| |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|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |itemids|string/array|Retorna apenas itens com os IDs fornecidos.| |groupids|string/array|Retorna apenas os itens que pertencem aos hosts dos grupos fornecidos.| |templateids|string/array|Retorna apenas os itens que pertencem aos modelos fornecidos.| |hostids|string/array|Retorna apenas os itens que pertencem aos hosts fornecidos.| |proxyids|string/array|Retorna apenas os itens que são monitorados pelos proxies fornecidos.| |interfaceids|string/array|Retorna apenas itens que usam as interfaces de host especificadas.| |graphids|string/array|Retorna apenas os itens que são usados nos gráficos fornecidos.| |triggerids|string/array|Retorna apenas os itens usados nos gatilhos fornecidos.| |webitems|flag|Incluir itens da web no resultado.| |inherited|boolean|Se definido como `true`, retornará apenas itens herdados de um modelo.| |templated|boolean|Se definido como `true`, retornará apenas os itens que pertencem aos modelos.| |monitored|boolean|Se definido como `true`, retornará apenas os itens habilitados que pertencem aos hosts monitorados.| |group|string|Retorna apenas os itens que pertencem a um grupo com o nome fornecido.| |host|string|Retorna apenas os itens que pertencem a um host com o nome fornecido.| |evaltype|integer|Regras para pesquisa de tags.<br><br>Valores possíveis:<br>0 - (padrão) E/Ou;<br>2 - Ou.| |tags|array of objects|Retorna apenas itens com as tags fornecidas. Correspondência exata por tag e pesquisa com distinção entre maiúsculas e minúsculas por valor de tag, dependendo do valor do operador.<br>Formato: `[{"tag": "<tag>", "value": "<value>", " operator": "<operator>"}, ...]`.<br>Um array vazio retorna todos os itens.<br><br>Possíveis tipos de operadores:<br>0 - (padrão) Like;<br>1 - Igual;<br>2 - Diferente;<br>3 - Não igual<br>4 - Existe;<br>5 - Não existe.| |with\_triggers|boolean|Se definido como `true`, retorne apenas os itens que são usados em gatilhos.| |selectHosts|query|Retorne uma propriedade [hosts](/manual/api/reference/host/object) com uma matriz de hosts aos quais o item pertence.| |selectInterfaces|query|Retorne uma propriedade de [interfaces](/manual/api/reference/hostinterface/object) com uma matriz de interfaces de host usadas pelo item.| |selectTriggers|query|Retorne uma propriedade [triggers](/manual/api/reference/trigger/object) com os gatilhos nos quais o item é usado.<br><br>Suporta `count`.| |selectGraphs|query|Retorne uma propriedade [graphs](/manual/api/reference/graph/object) com os gráficos que contêm o item.<br><br>Suporta `count`.| |selectDiscoveryRule|query|Retorne uma propriedade [discoveryRule](/manual/api/reference/drule/object) com a regra LLD que criou o item.| |selectItemDiscovery|query|Retorne uma propriedade `itemDiscovery` com o objeto de descoberta de item. O objeto de descoberta de item vincula o item a um protótipo de item a partir do qual ele foi criado.<br><br>Ele tem as seguintes propriedades:<br>`itemdiscoveryid` - `(string)` ID da descoberta de item;<br> `itemid` - `(string)` ID do item descoberto;<br>`parent_itemid` - `(string)` ID do protótipo do item a partir do qual o item foi criado;<br>`key_` - `(string )` chave do protótipo do item;<br>`lastcheck` - `(timestamp)` hora em que o item foi descoberto pela última vez;<br>`ts_delete` - `(timestamp)` hora em que um item que não é mais descoberto será ser excluído.| |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` - `(st ring)` 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.| |selectTags|query|Retorne as tags do item na propriedade [tags](/manual/api/reference/item/object#Item_tag).| |selectValueMap|query|Retorne uma propriedade [valuemap](/manual/api/reference/valuemap/object) com o mapa de valor 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 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|Classifique o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `itemid`, `name`, `key_`, `delay`, `history`, `trends`, ` type` e `status`.| |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|^| |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| |--|--|------| |itemids|string/array|Return only trends with the given item IDs.| |time\_from|timestamp|Return only values that have been collected after or at the given time.| |time\_till|timestamp|Return only values that have been collected before or at the given time.| |countOutput|boolean|Count the number of retrieved objects.| |limit|integer|Limit the amount of retrieved objects.| |output|query|Set fields to output.|
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| |--|--|------| |itemids|string/array|Retornar apenas tendências com os IDs de item fornecidos.| |time\_from|timestamp|Retorna apenas valores que foram coletados após ou no momento determinado.| |time\_till|timestamp|Retorna apenas valores que foram coletados antes ou no momento determinado.| |countOutput|boolean|Conte o número de objetos recuperados.|   |limit|integer|Limite a quantidade de objetos recuperados.| |output|query|Definir campos para saída.|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |mediaids|string/array|Return only users that use the given media.| |mediatypeids|string/array|Return only users that use the given media types.| |userids|string/array|Return only users with the given IDs.| |usrgrpids|string/array|Return only users that belong to the given user groups.| |getAccess|flag|Adds additional information about user permissions.<br><br>Adds the following properties for each user:<br>`gui_access` - *(integer)* user's frontend authentication method. Refer to the `gui_access` property of the [user group object](/manual/api/reference/usergroup/object#user_group) for a list of possible values.<br>`debug_mode` - *(integer)* indicates whether debug is enabled for the user. Possible values: 0 - debug disabled, 1 - debug enabled.<br>`users_status` - *(integer)* indicates whether the user is disabled. Possible values: 0 - user enabled, 1 - user disabled.| |selectMedias|query|Return media used by the user in the [medias](/manual/api/reference/user/object#media) property.| |selectMediatypes|query|Return media types used by the user in the [mediatypes](/manual/api/reference/mediatype/object) property.| |selectUsrgrps|query|Return user groups that the user belongs to in the [usrgrps](/manual/api/reference/usergroup/object) property.| |selectRole|query|Return user role in the [role](/manual/api/reference/role/object#role) property.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `userid` and `username`.| |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 parâmetros a seguir.    |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |mediaids|string/array|Retorna apenas usuários que usam a mídia fornecida.|   |mediatypeids|string/array|Retorna apenas usuários que usam os tipos de mídia fornecidos.|   |userids|string/array|Retorne apenas usuários com os IDs fornecidos.|| |usrgrpids|string/array|Retorna apenas usuários que pertencem aos grupos de usuários especificados.| |getAccess|flag|Adiciona informações adicionais sobre as permissões do usuário.<br><br>Adiciona as seguintes propriedades para cada usuário:<br>`gui_access` - *(integer)* método de autenticação de frontend do usuário. Consulte a propriedade `gui_access` do [objeto de grupo de usuários](/manual/api/reference/usergroup/object#user_group) para obter uma lista de valores possíveis.<br>`debug_mode` - *(integer)* indica se debug está habilitado para o usuário. Valores possíveis: 0 - depuração desabilitada, 1 - depuração habilitada.<br>`users_status` - *(integer)* indica se o usuário está desabilitado. Valores possíveis: 0 - usuário habilitado, 1 - usuário desabilitado.| |selectMedias|query|Retorna a mídia usada pelo usuário na propriedade [medias](/manual/api/reference/user/object#media).| |selectMediatypes|query|Retorna os tipos de mídia usados ​​pelo usuário na propriedade [mediatypes](/manual/api/reference/mediatype/object).| |selectUsrgrps|query|Retorna grupos de usuários aos quais o usuário pertence na propriedade [usrgrps](/manual/api/reference/usergroup/object).| |selectRole|query|Retorne a função do usuário na propriedade [role](/manual/api/reference/role/object#role).| |sortfield|string/array|Classifique o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `userid` e `username`.| |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|^| |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| |--|--|------| |mediatypeids|string/array|Return only media types with the given IDs.| |mediaids|string/array|Return only media types used by the given media.| |userids|string/array|Return only media types used by the given users.| |selectMessageTemplates|query|Return a [message\_templates](/manual/api/reference/mediatype/object#Message_template) property with an array of media type messages.| |selectUsers|query|Return a [users](//manual/api/reference/user/object) property with the users that use the media type.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `mediatypeid`.| |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| |--|--|------| |mediatypeids|string/array|Retorne apenas os tipos de mídia com os IDs fornecidos.| |mediaids|string/array|Retorna apenas os tipos de mídia usados ​​pela mídia fornecida.| |userids|string/array|Retornar apenas os tipos de mídia usados ​​por determinados usuários.| |selectMessageTemplates|query|Retorna uma propriedade [message\_templates](/manual/api/reference/mediatype/object#Message_template) com uma matriz de mensagens de tipo de mídia.| |selectUsers|query|Retornar uma propriedade [users](//manual/api/reference/user/object) com os usuários que usam o tipo de mídia.| |sortfield|string/array|Classifique o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `mediatypeid`.| |countOutput|boolean|Esses parâmetros sendo comuns para todos os métodos `get` são descritos em detalhes em [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| |--|--|------| |proxyids|string/array|Return only proxies with the given IDs.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts monitored by the proxy.| |selectInterface|query|Return an [interface](/manual/api/reference/proxy/object#proxy_interface) property with the proxy interface used by a passive proxy.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `hostid`, `host` 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|^| |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| |--|--|------| |proxyids|string/array|Retornar apenas proxies com os IDs fornecidos.| |selectHosts|query|Retorna uma propriedade [hosts](/manual/api/reference/host/object) com os hosts monitorados pelo proxy.| |selectInterface|query|Retornar uma propriedade [interface](/manual/api/reference/proxy/object#proxy_interface) com a interface de proxy usada por um proxy passivo.| |sortfield|string/array|Classifique o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `hostid`, `host` 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).| |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| |--|--|------| |reportids|string/array|Return only scheduled reports with the given report IDs.| |expired|boolean|If set to `true` returns only expired scheduled reports, if `false` - only active scheduled reports.| |selectUsers|query|Return a [users](/manual/api/reference/user/object) property the report is configured to be sent to.| |selectUserGroups|query|Return a [user\_groups](/manual/api/reference/user/object) property the report is configured to be sent to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `reportid`, `name`, `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) page.| |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| |--|--|------| |reportids|string/array|Retornar apenas relatórios programados com os IDs de relatório fornecidos.| |expired|boolean|Se definido como `true`, retorna apenas relatórios programados expirados, se `false` - somente relatórios programados ativos.| |selectUsers|query|Retorne uma propriedade [users](/manual/api/reference/user/object) para a qual o relatório está configurado para ser enviado.| |selectUserGroups|query|Retorne uma propriedade [user\_groups](/manual/api/reference/user/object) para a qual o relatório está configurado para ser enviado.| |sortfield|string/array|Classifique o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `reportid`, `name`, `status`.| |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).| |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| |--|--|------| |roleids|string/array|Return only roles with the given IDs.| |selectRules|query|Return role rules in the [rules](/manual/api/reference/role/object#role_rules) property.| |selectUsers|query|Select [users](/manual/api/reference/user/object) this role is assigned to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `roleid`, `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) 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| |--|--|------| |roleids|string/array|Retornar apenas papéis com os IDs fornecidos.| |selectRules|query|Retornar regras de função na propriedade [rules](/manual/api/reference/role/object#role_rules).| |selectUsers|query|Retornar regras de função na propriedade [rules](/manual/api/reference/role/object#role_rules).| |sortfield|string/array|Classifique o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `roleid`, `name`.| |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).| |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                                                                                                                                                               | |-------------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | slaids                  | string/array                                        | Return only SLAs with the given IDs.                                                                                                                                      | | serviceids              | string/array                                        | Return only SLAs matching the specific services.                                                                                                                          | |                         |                                                     |                                                                                                                                                                           | | selectSchedule          | query                                               | Return a `schedule` property with SLA schedules.<br><br>Supports `count`.                                                                                                 | | selectExcludedDowntimes | query                                               | Return an `excluded_downtimes` property with SLA excluded downtimes.<br><br>Supports `count`.                                                                             | | selectServiceTags       | query                                               | Return a `service_tags` property with SLA service tags.<br><br>Supports `count`.                                                                                          | |                         |                                                     |                                                                                                                                                                           | | sortfield               | string/array                                        | Sort the result by the given properties.<br><br>Possible values are: `slaid`, `name`, `period`, `slo`, `effective_date`, `timezone`, `status` and `description`.          | | 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 parâmetros a seguir.      | Parâmetro | [Tipo](/manual/api/reference_commentary#data_types) | Descrição                                                                                                                                                               | |-------------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | slaids                  | string/array                                        | Retornar apenas SLAs com os IDs fornecidos.                                                                                                                                      | | serviceids              | string/array                                        | Retornar apenas SLAs que correspondam aos serviços específicos.                                                                                                                          | |                         |                                                     |                                                                                                                                                                           | | selectSchedule          | query                                               | Retorne uma propriedade `schedule` com agendamentos de SLA.<br><br>Suporta `count`.                                                                                                 | | selectExcludedDowntimes | query                                               | Retorne uma propriedade `excluded_downtimes` com tempos de inatividade excluídos por SLA.<br><br>Suporta `count`.                                                                             | | selectServiceTags       | query                                               | Retorne uma propriedade `service_tags` com etiquetas de serviço SLA.<br><br>Suporta `count.                                                                                          | |                         |                                                     |                                                                                                                                                                           | | sortfield               | string/array                                        | Classifique o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `slaid`, `name`, `period`, `slo`, `effective_date`, `timezone`, `status` e `description`.          | | 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                                             | ^                                                                                                                                                                         | | 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| |--|--|------| |status|integer|Return only user groups with the given status.<br><br>Refer to the [user group page](object#user_group) for a list of supported statuses.| |userids|string/array|Return only user groups that contain the given users.| |usrgrpids|string/array|Return only user groups with the given IDs.| |selectTagFilters|query|Return user group tag based permissions in the [tag\_filters](/manual/api/reference/usergroup/object#tag_based_permission) property.<br><br>It has the following properties:<br>`groupid` - (string) ID of the host group;<br>`tag` - (string) tag name;<br>`value` - (string) tag value.| |selectUsers|query|Return the users from the user group in the [users](/manual/api/reference/user/object#user) property.| |selectRights|query|Return user group rights in the [rights](/manual/api/reference/usergroup/object#permission) property.<br><br>It has the following properties:<br>`permission` - (integer) access level to the host group;<br>`id` - (string) ID of the host group.<br><br>Refer to the [user group page](object#permission) for a list of access levels to host groups.| |limitSelects|integer|Limits the number of records returned by subselects.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `usrgrpid`, `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 parâmetros a seguir.    |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |status|integer|Retorne apenas grupos de usuários com o status fornecido.<br><br>Consulte a [página do grupo de usuários](object#user_group) para obter uma lista de status suportados.|   |userids|string/array|Retorna apenas grupos de usuários que contêm os usuários fornecidos.|   |usrgrpids|string/array|Retorna apenas grupos de usuários com os IDs fornecidos.| |selectTagFilters|query|Retorna permissões baseadas em etiquetas de grupo de usuários na propriedade [tag\_filters](/manual/api/reference/usergroup/object#tag_based_permission).<br><br>Tem as seguintes propriedades:<br>`groupid` - (string ) ID do grupo de hosts;<br>`tag` - (string) nome da etiqueta;<br>`value` - (string) valor da etiqueta.| |selectUsers|query|Retorne os usuários do grupo de usuários na propriedade [users](/manual/api/reference/user/object#user).|   |selectRights|query|Retorne direitos de grupo de usuários em propriedade [rights](/manual/api/reference/usergroup/object#permission).<br><br>Possui as seguintes propriedades:<br>`permission` - nível de acesso (inteiro) ao grupo de hosts;<br>`id` - (string) ID do grupo de hosts.<br><br>Consulte a [página do grupo de usuários](objeto#permissão) para obter uma lista de níveis de acesso aos grupos de hosts.|   |limitSelects|integer|Limite o número de registros retornados por subseleções.| |sortfield|string/array|Classifique o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `usrgrpid`, `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).| |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| |--|--|------| |sysmapids|string/array|Returns only maps with the given IDs.| |userids|string/array|Returns only maps that belong to the given user IDs.| |expandUrls|flag|Adds global map URLs to the corresponding map elements and expands macros in all map element URLs.| |selectIconMap|query|Returns an [iconmap](/manual/api/reference/iconmap/object) property with the icon map used on the map.| |selectLinks|query|Returns a [links](/manual/api/reference/map/object#Map_link) property with the map links between elements.| |selectSelements|query|Returns a [selements](/manual/api/reference/map/object#map_element) property with the map elements.| |selectUrls|query|Returns a [urls](/manual/api/reference/map/object#Map_URL) property with the map URLs.| |selectUsers|query|Returns a [users](/manual/api/reference/map/object#Map_user) property with users that the map is shared with.| |selectUserGroups|query|Returns a [userGroups](/manual/api/reference/map/object#Map_user_group) property with user groups that the map is shared with.| |selectShapes|query|Returns a [shapes](/manual/api/reference/map/object#Map_shapes) property with the map shapes.| |selectLines|query|Returns a [lines](/manual/api/reference/map/object#Map_lines) property with the map lines.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `name`, `width` and `height`.| |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| |--|--|------| |sysmapids|string/array|Retorna apenas mapas com os IDs fornecidos.| |userids|string/array|Retorna apenas mapas que pertencem aos IDs de usuário fornecidos.| |expandUrls|flag|Adiciona URLs de mapas globais aos elementos de mapa correspondentes e expande macros em todos os URLs de elementos de mapa.| |selectIconMap|query|Retorna uma propriedade [iconmap](/manual/api/reference/iconmap/object) com o mapa de ícones usado no mapa.| |selectLinks|query|Retorna uma propriedade [links](/manual/api/reference/map/object#Map_link) com os links do mapa entre os elementos.| |selectSelements|query|Retorna uma propriedade [selements](/manual/api/reference/map/object#map_element) com os elementos do mapa.| |selectUrls|query|Retorna uma propriedade [urls](/manual/api/reference/map/object#Map_URL) com os URLs do mapa.| |selectUsers|query|Retorna uma propriedade [users](/manual/api/reference/map/object#Map_user) com usuários com os quais o mapa é compartilhado.| |selectUserGroups|query|Retorna uma propriedade [userGroups](/manual/api/reference/map/object#Map_user_group) com grupos de usuários com os quais o mapa é compartilhado.| |selectShapes|query|Retorna uma propriedade [shapes](/manual/api/reference/map/object#Map_shapes) com as formas do mapa.| |selectLines|query|Retorna uma propriedade [linhas](/manual/api/reference/map/object#Map_lines) com as linhas do mapa.| |sortfield|string/array|Classifique o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `name`, `width` e `height`.| |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|^| |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| |--|--|------| |taskids|string/array|Return only tasks with the given IDs.| |output|query|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |preservekeys|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| |--|--|------| |taskids|string/array|Retornar apenas tarefas com os IDs fornecidos.| |output|query|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).| |preservekeys|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| |--|--|------| |tokenids|string/array|Return only tokens with the given IDs.| |userids|string/array|Return only tokens created for the given users.| |token|string|Return only tokens created for the given *Auth token*.| |valid\_at|timestamp|Return only tokens which are valid (not expired) at the given date and time.| |expired\_at|timestamp|Return only tokens which are expired (not valid) at the given date and time.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `tokenid`, `name`, `lastaccess`, `status`, `expires_at` and `created_at`.| |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).| |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|[Type](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |tokenids|string/array|Retorna apenas tokens com os IDs fornecidos.|   |userids|string/array|Retorna apenas os tokens criados para os usuários fornecidos.| |token|string|Retorna apenas os tokens criados para o *token de autenticação* fornecido.|   |valid\_at|timestamp|Retorna apenas tokens válidos (não expirados) na data e hora especificadas.| |expired\_at|timestamp|Retorna apenas os tokens que expiraram (não são válidos) na data e hora especificadas.|   |sortfield|string/array|Classifique o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `tokenid`, `name`, `lastaccess`, `status`, `expires_at` e `created_at`.| |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).| |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) |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | |------------------------|-----------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | serviceids             | string/array                                        | Return only services with the given IDs.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | | parentids              | string/array                                        | Return only services that are linked to the given parent services.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | | deep\_parentids        | flag                                                | Return all direct and indirect child services. Used together with `parentids`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | | childids               | string/array                                        | Return only services that are linked to the given child services.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | | evaltype               | integer                                             | Rules for tag searching.<br><br>Possible values:<br>0 - *(default)* And/Or;<br>2 - Or.                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | | tags                   | object/array of objects                             | Return only services with given tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all services.<br><br>Possible operator values:<br>0 - *(default)* Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.                                                                                                            | | problem\_tags          | object/array of objects                             | Return only services with given problem tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all services.<br><br>Possible operator values:<br>0 - *(default)* Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.                                                                                                    | | without\_problem\_tags | flag                                                | Return only services without problem tags.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | | slaids                 | string/array                                        | Return only services that are linked to the specific SLA(s).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | | selectChildren         | query                                               | Return a `children` property with the child services.<br><br>Supports `count`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | | selectParents          | query                                               | Return a `parents` property with the parent services.<br><br>Supports `count`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | | selectTags             | query                                               | Return a [tags](/manual/api/reference/service/object#service_tag) property with service tags.<br><br>Supports `count`.                                                                                                                                                                                                                                                                                                                                                                                                                                     | | selectProblemEvents    | query                                               | Return a `problem_events` property with an array of problem event objects.<br><br>The problem event object has the following properties:<br>`eventid` - *(string)* Event ID;<br>`severity` - *(string)* Current event severity;<br>`name` - *(string)* Resolved event name.<br><br>Supports `count`.                                                                                                                                                                                                                                                       | | selectProblemTags      | query                                               | Return a [problem\_tags](/manual/api/reference/service/object#problem_tag) property with problem tags.<br><br>Supports `count`.                                                                                                                                                                                                                                                                                                                                                                                                                            | | selectStatusRules      | query                                               | Return a [status\_rules](/manual/api/reference/service/object#status_rule) property with status rules.<br><br>Supports `count`.                                                                                                                                                                                                                                                                                                                                                                                                                            | | selectStatusTimeline   | object/array of objects                             | Return a `status_timeline` property containing service state changes for given periods.<br><br>Format `[{"period_from": "<period_from>", "period_to": "<period_to>"}, ...]` - `period_from` being a starting date (inclusive; integer timestamp) and `period_to` being an ending date (exclusive; integer timestamp) for the period you're interested in.<br><br>Returns an array of entries containing a `start_value` property and an [alarms](/manual/api/reference/service/object#service-alarm) array for the state changes within specified periods. |   |                        |              |                                                                                                                                                                           | |------------------------|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | sortfield              | string/array | Sort the result by the given properties.<br><br>Possible values are: `serviceid`, `name`, `status`, `sortorder` and 'created_at`.                                         | | 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) |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | |------------------------|-----------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | serviceids             | string/array                                        | Retornar apenas serviços com os IDs fornecidos.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | | parentids              | string/array                                        | Retornar apenas serviços vinculados aos serviços pai fornecidos.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | | deep\_parentids        | flag                                                | Retornar todos os serviços filhos diretos e indiretos. Usado junto com `parentids`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | | childids               | string/array                                        | Retornar apenas serviços vinculados aos serviços filho fornecidos.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | | evaltype               | integer                                             | Regras para pesquisa de etiquetas.<br><br>Valores possíveis:<br>0 - *(padrão)* E/Ou;<br>2 - Ou.                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | | tags                   | object/array of objects                             | Retornar apenas serviços com as etiquetas fornecidas. Correspondência exata por etiqueta e pesquisa com distinção entre maiúsculas e minúsculas por valor de etiqueta, dependendo do valor do operador.<br>Formato: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>Uma array vazia retorna todos os serviços.<br><br>Valores de operador possíveis:<br>0 - *(padrão)* Contém;<br>1 - Igual a;<br>2 - Não contém;<br>3 - Não é igual;<br>4 - Existe;<br>5 - Não existe.                                                                                                            | | problem\_tags          | object/array of objects                             | Retornar apenas serviços com as etiquetas de problema fornecidas. Correspondência exata por etiqueta e pesquisa com distinção entre maiúsculas e minúsculas por valor de etiqueta, dependendo do valor do operador.<br>Formato: `[{"tag": "<tag>", "value": "<value>", " operator": "<operator>"}, ...]`.<br>Um array vazio retorna todos os serviços.<br><br>Possíveis valores de operador:<br>0 - *(padrão)* Contém;<br >1 - É igual;<br>2 - Não contém;<br>3 - Não é igual;<br>4 - Existe;<br>5 - Não existe.                                                                                                    | | without\_problem\_tags | flag                                                | Retornar apenas serviços sem etiquetas de problema.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | | slaids                 | string/array                                        | Retornar apenas os serviços vinculados ao(s) SLA(s) específico(s).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | | selectChildren         | query                                               | Retornar uma propriedade `children` com os serviços filho.<br><br>Suporta `count`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | | selectParents          | query                                               | Retornar uma propriedade `parents` com os serviços pai.<br><br>Suporta `count`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | | selectTags             | query                                               | Retornar uma propriedade [etiquetas](/manual/api/reference/service/object#service_tag) com etiquetas de serviço.<br><br>Suporta `count`.                                                                                                                                                                                                                                                                                                                                                                                                                                     | | selectProblemEvents    | query                                               | Retornar uma propriedade `problem_events` com uma matriz de objetos de evento de problema.<br><br>O objeto de evento de problema tem as seguintes propriedades:<br>`eventid` - *(string)* ID do evento;<br>`severity` - *(string)* Gravidade do evento atual;<br>`name` - *(string)* Nome do evento resolvido.<br><br>Suporta `count`.                                                                                                                                                                                                                                                       | | selectProblemTags      | query                                               | Retornar uma propriedade [etiquetas de problema](/manual/api/reference/service/object#problem_tag) com etiquetas de problema.<br><br>Suporta `count`.                                                                                                                                                                                                                                                                                                                                                                                                                            | | selectStatusRules      | query                                               | Return a [status\_rules](/manual/api/reference/service/object#status_rule) property with status rules.<br><br>Supports `count`.                                                                                                                                                                                                                                                                                                                                                                                                                            | | selectStatusTimeline   | object/array of objects                             | Retorne uma propriedade `status_timeline` contendo alterações de estado do serviço para determinados períodos.<br><br>Formato `[{"period_from": "<period_from>", "period_to": "<period_to>"}, ...]` - `period_from` sendo uma data inicial (inclusive; timestamp inteiro) e `period_to` sendo uma data final (exclusiva; timestamp inteiro) para o período em que você está interessado.<br><br>Retorna um array de entradas contendo uma propriedade `start_value` e um array [alarmes](/manual/api/reference/service/object#service-alarm) para as mudanças de estado dentro de períodos especificados. |   |                        |              |                                                                                                                                                                           | |------------------------|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | sortfield              | string/array | Classifique o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `serviceid`, `name`, `status`, `sortorder` e 'created_at`.                                         | | 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      | ^                                                                                                                                                                         | | 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 LLD rules to copy and the target hosts.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |discoveryids|array|IDs of the LLD rules to be copied.| |hostids|array|IDs of the hosts to copy the LLD rules to.|
pt-br	### Parâmetros  `(object)` Parâmetros que definem as regras LLD a serem copiadas e os hosts de destino.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |discoveryids|array|IDs of the LLD rules to be copied.| |hostids|array|IDs of the hosts to copy the LLD rules to.|

en-us	### Parameters  `(object)` Parameters defining the objects to be exported and the format to use.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**format**<br>(required)|string|Format in which the data must be exported.<br><br>Possible values:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON;<br>`raw` - unprocessed PHP array.| |prettyprint|boolean|Make the output more human readable by adding indentation.<br><br>Possible values:<br>`true` - add indentation;<br>`false` - *(default)* do not add indentation.| |**options**<br>(required)|object|Objects to be exported.<br><br>The `options` object has the following parameters:<br>`groups` - `(array)` IDs of host groups to export;<br>`hosts` - `(array)` IDs of hosts to export;<br>`images` - `(array)` IDs of images to export;<br>`maps` - `(array)` IDs of maps to export;<br>`mediaTypes` - `(array)` IDs of media types to export;<br>`templates` - `(array)` IDs of templates to export.<br>|
pt-br	### Parâmetros  `(object)` Parâmetros que definem os objetos a serem exportados e o formato usar.  |Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |---------|----------------------------------- ------------|-----------| |**formato**<br>(obrigatório)|string|Formato no qual os dados devem ser exportados.<br><br>Valores possíveis:<br>`yaml` - YAML;<br>`xml` - XML ;<br>`json` - JSON;<br>`raw` - array PHP não processado.| |prettyprint|boolean|Torne a saída mais legível adicionando recuo.<br><br>Valores possíveis:<br>`true` - adiciona recuo;<br>`false` - *(padrão)* não adiciona recuo .| |**options**<br>(obrigatório)|object|Objetos a serem exportados.<br><br>O objeto `options` tem os seguintes parâmetros:<br>`groups` - `(array)` IDs de grupos de hosts para exportar;<br>`hosts` - `(array)` IDs de hosts para exportar;<br>`images` - `(array)` IDs de imagens para exportar;<br>`maps` - `( array)` IDs de mapas a serem exportados;<br>`mediaTypes` - `(array)` IDs de tipos de mídia a serem exportados;<br>`templates` - `(array)` IDs de modelos a serem exportados.<br>|

en-us	### Parameters  `(object)` Settings properties to be updated.
pt-br	### Parâmetros  `(object)` Propriedades de configurações a serem atualizadas.

en-us	#### Parameters  |Parameter|Description|Defaults|Example| |---------|-----------|--------|-------| |*endpoint*|Protocol and address of the endpoint, defined as `protocol://connection_string`<br><br>Possible protocol values: *rtu*, *ascii* (Agent 2 only), *tcp*<br><br>Connection string format:<br><br>with *tcp* - `address:port`<br>with serial line: *rtu*, *ascii* - `port_name:speed:params`<br>where<br>'speed' - 1200, 9600 etc<br>'params' - data bits (5,6,7 or 8), parity (n,e or o for none/even/odd), stop bits (1 or 2)|protocol: none<br><br>*rtu/ascii* protocol:<br>port\_name: none<br>speed: 115200<br>params: 8n1<br><br>*tcp* protocol:<br>address: none<br>port: 502|tcp://192.168.6.1:511<br>tcp://192.168.6.2<br>tcp://\[::1\]:511<br>tcp://::1<br>tcp://localhost:511<br>tcp://localhost<br>rtu://COM1:9600:8n<br>ascii://COM2:1200:7o2<br>rtu://ttyS0:9600<br>ascii://ttyS1| |*slave id*|Modbus address of the device it is intended for (1 to 247), see [MODBUS Messaging Implementation Guide](https://modbus.org/docs/Modbus_Messaging_Implementation_Guide_V1_0b.pdf) (page 23)<br><br>tcp device (not GW) will ignore the field|serial: 1<br><br>tcp: 255 (0xFF)|2| |*function*|Empty or value of a supported function:<br><br>1 - Read Coil,<br>2 - Read Discrete Input,<br>3 - Read Holding Registers,<br>4 - Read Input Registers|empty|3| |*address*|Address of the first registry, coil or input.<br><br>If 'function' is empty, then 'address' should be in range for:<br>Coil - 00001 - 09999<br>Discrete input - 10001 - 19999<br>Input register - 30001 - 39999<br>Holding register - 40001 - 49999<br><br>If 'function' is not empty, the 'address' field will be from 0 till 65535 and used without modification (PDU)|empty function: 00001<br><br>non-empty function: 0|9999| |*count*|Count of sequenced 'type' which will be read from device, where:<br><br>for Coil or Discrete input the 'type' = 1 bit<br>for other cases: (count\*type)/2 = real count of registers for reading<br>If 'offset' is not 0, the value will be added to 'real count'<br>Acceptable range for 'real count' is 1:65535|1|2| |*type*|Data type:<br><br>for Read Coil and Read Discrete Input - *bit*<br><br>for Read Holding Registers and Read Input Registers:<br>*int8* - 8bit<br>*uint8* - 8bit (unsigned)<br>*int16* - 16bit<br>*uint16* - 16bit (unsigned)<br>*int32* - 32bit<br>*uint32* - 32bit (unsigned)<br>*float* - 32bit<br>*uint64* - 64bit (unsigned)<br>*double* - 64bit|bit<br>uint16|uint64| |*endianness*|Endianness type:<br>*be* - Big Endian<br>*le* - Little Endian<br>*mbe* - Mid-Big Endian<br>*mle* - Mid-Little Endian<br><br>Limitations:<br>for 1 bit - be<br>for 8 bits - be,le<br>for 16 bits - be,le|be|le| |*offset*|Number of registers, starting from 'address', the result of which will be discarded.<br><br>The size of each register is 16bit (needed to support equipment that does not support random read access).|0|4|
pt-br	#### Parâmetros  |Parâmetro|Descrição|Padrões|Exemplo| |---------|-----------|--------|-------| |*endpoint*|Protocolo e endereço do endpoint, definido como `protocol://connection_string`<br><br>Possíveis valores de protocolo: *rtu*, *ascii* (somente Agente 2), *tcp*<br> <br>Formato da string de conexão:<br><br>com *tcp* - `address:port`<br>com linha serial: *rtu*, *ascii* - `port_name:speed:params`<br>onde< br>'speed' - 1200, 9600 etc<br>'params' - bits de dados (5,6,7 ou 8), paridade (n,e ou o para nenhum/par/ímpar), bits de parada (1 ou 2 )|protocolo: nenhum<br><br>*rtu/ascii* protocolo:<br>port\_name: nenhum<br>velocidade: 115200<br>parâmetros: 8n1<br><br>*tcp* protocolo:< br>endereço: nenhum<br>porta: 502|tcp://192.168.6.1:511<br>tcp://192.168.6.2<br>tcp://\[::1\]:511<br> tcp://::1<br>tcp://localhost:511<br>tcp://localhost<br>rtu://COM1:9600:8n<br>ascii://COM2:1200:7o2< br>rtu://ttyS0:9600<br>ascii://ttyS1| |*ID do escravo*|Endereço Modbus do dispositivo ao qual se destina (1 a 247), consulte [Guia de implementação de mensagens MODBUS](https://modbus.org/docs/Modbus_Messaging_Implementation_Guide_V1_0b.pdf) (página 23)<br> <br>dispositivo tcp (não GW) irá ignorar o campo|serial: 1<br><br>tcp: 255 (0xFF)|2| |*função*|Vazio ou valor de uma função suportada:<br><br>1 - Ler bobina,<br>2 - Ler entrada discreta,<br>3 - Ler registros de retenção,<br>4 - Ler registros de entrada |vazio|3| |*endereço*|Endereço do primeiro registro, bobina ou entrada.<br><br>Se 'função' estiver vazio, então 'endereço' deverá estar no intervalo de:<br>Coil - 00001 - 09999<br>Discreto entrada - 10001 - 19999<br>Registro de entrada - 30001 - 39999<br>Registro de retenção - 40001 - 49999<br><br>Se 'função' não estiver vazio, o campo 'endereço' será de 0 a 65535 e usado sem modificação (PDU)|função vazia: 00001<br><br>função não vazia: 0|9999| |*count*|Contagem de 'tipo' sequenciado que será lido do dispositivo, onde:<br><br>para Coil ou Discrete insira o 'type' = 1 bit<br>para outros casos: (count\*type )/2 = contagem real de registros para leitura<br>Se 'offset' não for 0, o valor será adicionado a 'contagem real'<br>O intervalo aceitável para 'contagem real' é 1:65535|1|2| |*type*|Tipo de dados:<br><br>para Read Coil e Read Discrete Input - *bit*<br><br>para Read Holding Registers e Read Input Registers:<br>*int8* - 8bit<br >*uint8* - 8 bits (sem sinal)<br>*int16* - 16 bits<br>*uint16* - 16 bits (sem sinal)<br>*int32* - 32 bits<br>*uint32* - 32 bits (sem sinal)<br> *float* - 32bit<br>*uint64* - 64bit (sem sinal)<br>*double* - 64bit|bit<br>uint16|uint64| |*endianness*|Tipo de Endianness:<br>*be* - Big Endian<br>*le* - Little Endian<br>*mbe* - Mid-Big Endian<br>*mle* - Mid-Little Endian<br> <br>Limitações:<br>para 1 bit - be<br>para 8 bits - be,le<br>para 16 bits - be,le|be|le| |*offset*|Número de registradores, a partir de 'endereço', cujo resultado será descartado.<br><br>O tamanho de cada registrador é de 16 bits (necessário para suportar equipamentos que não suportam acesso aleatório de leitura). |0|4|

en-us	#### Parameters  |Parameter|Mandatory|Range|Default|Description| |---------|---------|-----|-------|-----------| |AlertScriptsPath|no| |/usr/local/share/zabbix/alertscripts|Location of custom alert scripts (depends on compile-time installation variable *datadir*).| |AllowRoot|no| |0|Allow the server to run as 'root'. If disabled and the server is started by 'root', the server will try to switch to the 'zabbix' user instead. Has no effect if started under a regular user.<br>0 - do not allow<br>1 - allow| |AllowUnsupportedDBVersions|no| |0|Allow the server to work with unsupported database versions.<br>0 - do not allow<br>1 - allow| |CacheSize|no|128K-64G|8M|Size of configuration cache, in bytes.<br>Shared memory size for storing host, item and trigger data.| |CacheUpdateFrequency|no|1-3600|60|How often Zabbix will perform update of configuration cache, in seconds.<br>See also [runtime control](/manual/concepts/server#server_process) options.| |DBHost|no| |localhost|Database host name.<br>In case of MySQL localhost or empty string results in using a socket. In case of PostgreSQL<br>only empty string results in attempt to use socket.<br>In case of [Oracle](/manual/appendix/install/oracle#connection_set_up) empty string results in using the Net Service Name connection method; in this case consider using the TNS\_ADMIN environment variable to specify the directory of the tnsnames.ora file.| |DBName|yes| | |Database name.<br>In case of [Oracle](/manual/appendix/install/oracle#connection_set_up) if the Net Service Name connection method is used, specify the service name from tnsnames.ora or set to empty string; set the TWO\_TASK environment variable if DBName is set to empty string.| |DBPassword|no| | |Database password.<br>Comment this line if no password is used.| |DBPort|no|1024-65535| |Database port when not using local socket.<br>In case of [Oracle](/manual/appendix/install/oracle#connection_set_up) if the Net Service Name connection method is used this parameter will be ignored; the port number from the tnsnames.ora file will be used instead.| |DBSchema|no| | |Schema name. Used for PostgreSQL.| |DBSocket|no| | |Path to MySQL socket file.| |DBUser|no| | |Database user.| |DBTLSConnect|no| | |Setting this option enforces to use TLS connection to database:<br>*required* - connect using TLS<br>*verify\_ca* - connect using TLS and verify certificate<br>*verify\_full* - connect using TLS, verify certificate and verify that database identity specified by DBHost matches its certificate<br><br>On MySQL starting from 5.7.11 and PostgreSQL the following values are supported: "required", "verify\_ca", "verify\_full". On MariaDB starting from version 10.2.6 "required" and "verify\_full" values are supported.<br>By default not set to any option and the behavior depends on database configuration.<br><br>This parameter is supported since Zabbix 5.0.0.| |DBTLSCAFile|no<br>(yes, if DBTLSConnect set to one of: verify\_ca, verify\_full)| | |Full pathname of a file containing the top-level CA(s) certificates for database certificate verification.<br>This parameter is supported since Zabbix 5.0.0.| |DBTLSCertFile|no| | |Full pathname of file containing Zabbix server certificate for authenticating to database.<br>This parameter is supported since Zabbix 5.0.0.| |DBTLSKeyFile|no| | |Full pathname of file containing the private key for authenticating to database.<br>This parameter is supported since Zabbix 5.0.0.| |DBTLSCipher|no| | |The list of encryption ciphers that Zabbix server permits for TLS protocols up through TLSv1.2.<br>Supported only for MySQL.<br>This parameter is supported since Zabbix 5.0.0.| |DBTLSCipher13|no| | |The list of encryption ciphersuites that Zabbix server permits for TLSv1.3 protocol.<br>Supported only for MySQL, starting from version 8.0.16.<br>This parameter is supported since Zabbix 5.0.0.| |DebugLevel|no|0-5|3|Specifies debug level:<br>0 - basic information about starting and stopping of Zabbix processes<br>1 - critical information<br>2 - error information<br>3 - warnings<br>4 - for debugging (produces lots of information)<br>5 - extended debugging (produces even more information)<br>See also [runtime control](/manual/concepts/server#server_process) options.| |ExportDir|no| | |Directory for [real-time export](/manual/appendix/install/real_time_export) of events, history and trends in newline-delimited JSON format. If set, enables real-time export.<br>This parameter is supported since Zabbix 4.0.0.| |ExportFileSize|no|1M-1G|1G|Maximum size per export file in bytes. Only used for rotation if ExportDir is set.<br>This parameter is supported since Zabbix 4.0.0.| |ExportType|no| | |List of comma-delimited entity types (events, history, trends) for [real-time export](/manual/appendix/install/real_time_export) (all types by default). Valid only if ExportDir is set.<br>*Note* that if ExportType is specified, but ExportDir is not, then this is a configuration error and the server will not start.<br>e.g.:<br>ExportType=history,trends - export history and trends only<br>ExportType=events - export events only| |ExternalScripts|no| |/usr/local/share/zabbix/externalscripts|Location of external scripts (depends on compile-time installation variable *datadir*).| |Fping6Location|no| |/usr/sbin/fping6|Location of fping6.<br>Make sure that fping6 binary has root ownership and SUID flag set.<br>Make empty ("Fping6Location=") if your fping utility is capable to process IPv6 addresses.| |FpingLocation|no| |/usr/sbin/fping|Location of fping.<br>Make sure that fping binary has root ownership and SUID flag set!| |HANodeName|no| | |The high availability cluster node name.<br>When empty the server is working in standalone mode and a node with empty name is created.| |HistoryCacheSize|no|128K-2G|16M|Size of history cache, in bytes.<br>Shared memory size for storing history data.| |HistoryIndexCacheSize|no|128K-2G|4M|Size of history index cache, in bytes.<br>Shared memory size for indexing history data stored in history cache.<br>The index cache size needs roughly 100 bytes to cache one item.<br>This parameter is supported since Zabbix 3.0.0.| |HistoryStorageDateIndex|no| |0|Enable preprocessing of history values in history storage to store values in different indices based on date:<br>0 - disable<br>1 - enable| |HistoryStorageURL|no| | |History storage HTTP\[S\] URL.<br>This parameter is used for [Elasticsearch](/manual/appendix/install/elastic_search_setup) setup.| |HistoryStorageTypes|no| |uint,dbl,str,log,text|Comma separated list of value types to be sent to the history storage.<br>This parameter is used for [Elasticsearch](/manual/appendix/install/elastic_search_setup) setup.| |HousekeepingFrequency|no|0-24|1|How often Zabbix will perform housekeeping procedure (in hours).<br>Housekeeping is removing outdated information from the database.<br>*Note*: To prevent housekeeper from being overloaded (for example, when history and trend periods are greatly reduced), no more than 4 times HousekeepingFrequency hours of outdated information are deleted in one housekeeping cycle, for each item. Thus, if HousekeepingFrequency is 1, no more than 4 hours of outdated information (starting from the oldest entry) will be deleted per cycle.<br>*Note*: To lower load on server startup housekeeping is postponed for 30 minutes after server start. Thus, if HousekeepingFrequency is 1, the very first housekeeping procedure after server start will run after 30 minutes, and will repeat with one hour delay thereafter.<br>Since Zabbix 3.0.0 it is possible to disable automatic housekeeping by setting HousekeepingFrequency to 0. In this case the housekeeping procedure can only be started by *housekeeper\_execute* runtime control option and the period of outdated information deleted in one housekeeping cycle is 4 times the period since the last housekeeping cycle, but not less than 4 hours and not greater than 4 days.<br>See also [runtime control](/manual/concepts/server#server_process) options.| |Include|no| | |You may include individual files or all files in a directory in the configuration file.<br>To only include relevant files in the specified directory, the asterisk wildcard character is supported for pattern matching. For example: `/absolute/path/to/config/files/*.conf`.<br>See [special notes](special_notes_include) about limitations.| |JavaGateway|no| | |IP address (or hostname) of Zabbix Java gateway.<br>Only required if Java pollers are started.| |JavaGatewayPort|no|1024-32767|10052|Port that Zabbix Java gateway listens on.| |ListenBacklog|no|0 - INT\_MAX|SOMAXCONN|The maximum number of pending connections in the TCP queue.<br>Default value is a hard-coded constant, which depends on the system.<br>Maximum supported value depends on the system, too high values may be silently truncated to the 'implementation-specified maximum'.| |ListenIP|no| |0.0.0.0|List of comma delimited IP addresses that the trapper should listen on.<br>Trapper will listen on all network interfaces if this parameter is missing.| |ListenPort|no|1024-32767|10051|Listen port for trapper.| |LoadModule|no| | |Module to load at server startup. Modules are used to extend functionality of the server.<br>Formats:<br>LoadModule=<module.so><br>LoadModule=<path/module.so><br>LoadModule=</abs\_path/module.so><br>Either the module must be located in directory specified by LoadModulePath or the path must precede the module name. If the preceding path is absolute (starts with '/') then LoadModulePath is ignored.<br>It is allowed to include multiple LoadModule parameters.| |LoadModulePath|no| | |Full path to location of server modules.<br>Default depends on compilation options.| |LogFile|yes, if LogType is set to *file*, otherwise<br>no| | |Name of log file.| |LogFileSize|no|0-1024|1|Maximum size of log file in MB.<br>0 - disable automatic log rotation.<br>*Note*: If the log file size limit is reached and file rotation fails, for whatever reason, the existing log file is truncated and started anew.| |LogType|no| |file|Log output type:<br>*file* - write log to file specified by LogFile parameter,<br>*system* - write log to syslog,<br>*console* - write log to standard output.<br>This parameter is supported since Zabbix 3.0.0.| |LogSlowQueries|no|0-3600000|0|How long a database query may take before being logged (in milliseconds).<br>0 - don't log slow queries.<br>This option becomes enabled starting with DebugLevel=3.| |MaxHousekeeperDelete|no|0-1000000|5000|No more than 'MaxHousekeeperDelete' rows (corresponding to \[tablename\], \[field\], \[value\]) will be deleted per one task in one housekeeping cycle.<br>If set to 0 then no limit is used at all. In this case you must know what you are doing, so as not to [overload the database!](zabbix_server#footnotes) **^[2](zabbix_server#footnotes)^**<br>This parameter applies only to deleting history and trends of already deleted items.| |NodeAddress|no| | |IP or hostname with optional port to override how the frontend should connect to the server.<br>Format: <address>\[:port\]<br>The priority of addresses used by the frontend to specify the server address is: NodeAddress (1); ListenIP (if not 0.0.0.0 or ::) (2); localhost (default) (3)<br>See also: HANodeName parameter| |PidFile|no| |/tmp/zabbix\_server.pid|Name of PID file.| |ProxyConfigFrequency|no|1-604800|3600|How often Zabbix server sends configuration data to a Zabbix proxy in seconds. Used only for proxies in a passive mode.| |ProxyDataFrequency|no|1-3600|1|How often Zabbix server requests history data from a Zabbix proxy in seconds. Used only for proxies in a passive mode.| |SNMPTrapperFile|no| |/tmp/zabbix\_traps.tmp|Temporary file used for passing data from SNMP trap daemon to the server.<br>Must be the same as in zabbix\_trap\_receiver.pl or SNMPTT configuration file.| |SocketDir|no| |/tmp|Directory to store IPC sockets used by internal Zabbix services.<br>This parameter is supported since Zabbix 3.4.0.| |SourceIP|no| | |Source IP address for:<br>- outgoing connections to Zabbix proxy and Zabbix agent;<br>- agentless connections (VMware, SSH, JMX, SNMP, Telnet and simple checks);<br>- HTTP agent connections;<br>- script item JavaScript HTTP requests;<br>- preprocessing JavaScript HTTP requests;<br>- sending notification emails (connections to SMTP server);<br>- webhook notifications (JavaScript HTTP connections);<br>- connections to the Vault| |SSHKeyLocation|no| | |Location of public and private keys for SSH checks and actions| |SSLCertLocation|no| | |Location of SSL client certificate files for client authentication.<br>This parameter is used in web monitoring only.| |SSLKeyLocation|no| | |Location of SSL private key files for client authentication.<br>This parameter is used in web monitoring only.| |SSLCALocation|no| | |Override the location of certificate authority (CA) files for SSL server certificate verification. If not set, system-wide directory will be used.<br>Note that the value of this parameter will be set as libcurl option CURLOPT\_CAPATH. For libcurl versions before 7.42.0, this only has effect if libcurl was compiled to use OpenSSL. For more information see [cURL web page](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html).<br>This parameter is used in web monitoring since Zabbix 2.4.0 and in SMTP authentication since Zabbix 3.0.0.| |StartAlerters|no|1-100|3|Number of pre-forked instances of [alerters](/manual/concepts/server#server_process_types).<br>This parameter is supported since Zabbix 3.4.0.| |StartDBSyncers|no|1-100|4|Number of pre-forked instances of [history syncers](/manual/concepts/server#server_process_types).<br>*Note*: Be careful when changing this value, increasing it may do more harm than good. Roughly, the default value should be enough to handle up to 4000 NVPS.| |StartDiscoverers|no|0-250|1|Number of pre-forked instances of [discoverers](/manual/concepts/server#server_process_types).| |StartEscalators|no|1-100|1|Number of pre-forked instances of [escalators](/manual/concepts/server#server_process_types).<br>This parameter is supported since Zabbix 3.0.0.| |StartHistoryPollers|no|0-1000|5|Number of pre-forked instances of [history pollers](/manual/concepts/server#server_process_types).<br>This parameter is supported since Zabbix 5.4.0.| |StartHTTPPollers|no|0-1000|1|Number of pre-forked instances of [HTTP pollers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartIPMIPollers|no|0-1000|0|Number of pre-forked instances of [IPMI pollers](/manual/concepts/server#server_process_types).| |StartJavaPollers|no|0-1000|0|Number of pre-forked instances of [Java pollers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartLLDProcessors|no|1-100|2|Number of pre-forked instances of low-level discovery (LLD) [workers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.<br>The LLD manager process is automatically started when an LLD worker is started.<br>This parameter is supported since Zabbix 4.2.0.| |StartODBCPollers|no|0-1000|1|Number of pre-forked instances of [ODBC pollers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartPingers|no|0-1000|1|Number of pre-forked instances of [ICMP pingers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartPollersUnreachable|no|0-1000|1|Number of pre-forked instances of [pollers for unreachable hosts](/manual/concepts/server#server_process_types) (including IPMI and Java)**^[1](zabbix_server#footnotes)^**.<br>At least one poller for unreachable hosts must be running if regular, IPMI or Java pollers are started.| |StartPollers|no|0-1000|5|Number of pre-forked instances of [pollers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartPreprocessors|no|1-1000|3|Number of pre-forked instances of preprocessing [workers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.<br>The preprocessing manager process is automatically started when a preprocessor worker is started.<br>This parameter is supported since Zabbix 3.4.0.| |StartProxyPollers|no|0-250|1|Number of pre-forked instances of [pollers for passive proxies](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartReportWriters|no|0-100|0|Number of pre-forked instances of [report writers](/manual/concepts/server#server_process_types).<br>If set to 0, scheduled report generation is disabled.<br>The report manager process is automatically started when a report writer is started.<br>This parameter is supported since Zabbix 5.4.0.| |StartSNMPTrapper|no|0-1|0|If set to 1, [SNMP trapper](/manual/concepts/server#server_process_types) process will be started.| |StartTimers|no|1-1000|1|Number of pre-forked instances of [timers](/manual/concepts/server#server_process_types).<br>Timers process maintenance periods.| |StartTrappers|no|0-1000|5|Number of pre-forked instances of [trappers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.<br>Trappers accept incoming connections from Zabbix sender, active agents and active proxies.| |StartVMwareCollectors|no|0-250|0|Number of pre-forked [VMware collector](/manual/concepts/server#server_process_types) instances.| |StatsAllowedIP|no| | |List of comma delimited IP addresses, optionally in CIDR notation, or DNS names of external Zabbix instances. Stats request will be accepted only from the addresses listed here. If this parameter is not set no stats requests will be accepted.<br>If IPv6 support is enabled then '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' are treated equally and '::/0' will allow any IPv4 or IPv6 address. '0.0.0.0/0' can be used to allow any IPv4 address.<br>Example: StatsAllowedIP=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com<br>This parameter is supported since Zabbix 4.2.0.| |Timeout|no|1-30|3|Specifies how long we wait for agent, SNMP device or external check (in seconds).| |TLSCAFile|no| | |Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification, used for encrypted communications between Zabbix components.<br>This parameter is supported since Zabbix 3.0.0.| |TLSCertFile|no| | |Full pathname of a file containing the server certificate or certificate chain, used for encrypted communications between Zabbix components.<br>This parameter is supported since Zabbix 3.0.0.| |TLSCipherAll|no| | |GnuTLS priority string or OpenSSL (TLS 1.2) cipher string. Override the default ciphersuite selection criteria for certificate- and PSK-based encryption.<br>Example: TLS\_AES\_256\_GCM\_SHA384:TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256<br>This parameter is supported since Zabbix 4.4.7.| |TLSCipherAll13|no| | |Cipher string for OpenSSL 1.1.1 or newer in TLS 1.3. Override the default ciphersuite selection criteria for certificate- and PSK-based encryption.<br>Example for GnuTLS: NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL::+SIGN-ALL:+CTYPE-X.509<br>Example for OpenSSL: EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128<br>This parameter is supported since Zabbix 4.4.7.| |TLSCipherCert|no| | |GnuTLS priority string or OpenSSL (TLS 1.2) cipher string. Override the default ciphersuite selection criteria for certificate-based encryption.<br>Example for GnuTLS: NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509<br>Example for OpenSSL: EECDH+aRSA+AES128:RSA+aRSA+AES128<br>This parameter is supported since Zabbix 4.4.7.| |TLSCipherCert13|no| | |Cipher string for OpenSSL 1.1.1 or newer in TLS 1.3. Override the default ciphersuite selection criteria for certificate-based encryption.<br>This parameter is supported since Zabbix 4.4.7.| |TLSCipherPSK|no| | |GnuTLS priority string or OpenSSL (TLS 1.2) cipher string. Override the default ciphersuite selection criteria for PSK-based encryption.<br>Example for GnuTLS: NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL<br>Example for OpenSSL: kECDHEPSK+AES128:kPSK+AES128<br>This parameter is supported since Zabbix 4.4.7.| |TLSCipherPSK13|no| | |Cipher string for OpenSSL 1.1.1 or newer in TLS 1.3. Override the default ciphersuite selection criteria for PSK-based encryption.<br>Example: TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256<br>This parameter is supported since Zabbix 4.4.7.| |TLSCRLFile|no| | |Full pathname of a file containing revoked certificates. This parameter is used for encrypted communications between Zabbix components.<br>This parameter is supported since Zabbix 3.0.0.| |TLSKeyFile|no| | |Full pathname of a file containing the server private key, used for encrypted communications between Zabbix components.<br>This parameter is supported since Zabbix 3.0.0.| |TmpDir|no| |/tmp|Temporary directory.| |TrapperTimeout|no|1-300|300|Specifies how many seconds trapper may spend processing new data.| |TrendCacheSize|no|128K-2G|4M|Size of trend cache, in bytes.<br>Shared memory size for storing trends data.| |TrendFunctionCacheSize|no|128K-2G|4M|Size of trend function cache, in bytes.<br>Shared memory size for caching calculated trend function data.| |UnavailableDelay|no|1-3600|60|How often host is checked for availability during the [unavailability](/manual/appendix/items/unreachability#unavailable_host) period, in seconds.| |UnreachableDelay|no|1-3600|15|How often host is checked for availability during the [unreachability](/manual/appendix/items/unreachability#unreachable_host) period, in seconds.| |UnreachablePeriod|no|1-3600|45|After how many seconds of [unreachability](/manual/appendix/items/unreachability#unreachable_host) treat a host as unavailable.| |User|no| |zabbix|Drop privileges to a specific, existing user on the system.<br>Only has effect if run as 'root' and AllowRoot is disabled.| |ValueCacheSize|no|0,128K-64G|8M|Size of history value cache, in bytes.<br>Shared memory size for caching item history data requests.<br>Setting to 0 disables value cache (not recommended).<br>When value cache runs out of the shared memory a warning message is written to the server log every 5 minutes.| |VaultDBPath|no| | |Vault path from where credentials for database will be retrieved by keys 'password' and 'username'.<br>Example: secret/zabbix/database<br>This option can only be used if DBUser and DBPassword are not specified.<br>This parameter is supported since Zabbix 5.2.0.| |VaultToken|no| | |Vault authentication token that should have been generated exclusively for Zabbix server with read-only permission to the paths specified in [Vault macros](/manual/config/macros/user_macros#configuration) and read-only permission to the path specified in the optional VaultDBPath configuration parameter.<br>It is an error if VaultToken and VAULT\_TOKEN environment variable are defined at the same time.<br>This parameter is supported since Zabbix 5.2.0.| |VaultURL|no| |https://127.0.0.1:8200|Vault server HTTP\[S\] URL. System-wide CA certificates directory will be used if SSLCALocation is not specified.<br>This parameter is supported since Zabbix 5.2.0.| |VMwareCacheSize|no|256K-2G|8M|Shared memory size for storing VMware data.<br>A VMware internal check zabbix\[vmware,buffer,...\] can be used to monitor the VMware cache usage (see [Internal checks](/manual/config/items/itemtypes/internal)).<br>Note that shared memory is not allocated if there are no vmware collector instances configured to start.| |VMwareFrequency|no|10-86400|60|Delay in seconds between data gathering from a single VMware service.<br>This delay should be set to the least update interval of any VMware monitoring item.| |VMwarePerfFrequency|no|10-86400|60|Delay in seconds between performance counter statistics retrieval from a single VMware service.<br>This delay should be set to the least update interval of any VMware monitoring [item](/manual/config/items/itemtypes/simple_checks/vmware_keys#footnotes) that uses VMware performance counters.| |VMwareTimeout|no|1-300|10|The maximum number of seconds vmware collector will wait for a response from VMware service (vCenter or ESX hypervisor).| |WebServiceURL|no| | |HTTP\[S\] URL to Zabbix web service in the format `<host:port>/report`. For example: `http://localhost:10053/report`<br>This parameter is supported since Zabbix 5.4.0.|  
pt-br	#### Parâmetros  |Parâmetro|Obrigatório|Intervalo|Padrão|Descrição| |---------|---------|-----|-------|-----------| |AlertScriptsPath|não| |/usr/local/share/zabbix/alertscripts|Localização dos scripts de alerta customizados (depende da variável de tempo de compilação de instalação *datadir*).| |AllowRoot|não| |0|Permite que o Server seja executado como 'root'. Se desabilitado e o Server for iniciado pelo 'root', o Server tentará mudar para o usuário 'zabbix'. Não tem efeito se iniciado com um usuário regular.<br>0 - não permite<br>1 - permite| |AllowUnsupportedDBVersions|não| |0|Permite que o Server opere com versões de banco de dados não suportadas.<br>0 - não permite<br>1 - permite| |CacheSize|não|128K-64G|8M|Tamanho do cache de configuração, em bytes.<br>Tamanho da memória compartilhada para armazenamento de dados de host, item e gatilho.| |CacheUpdateFrequency|não|1-3600|60|Quão frequentemente o Zabbix executará atualização do cache de configuração, em segundos.<br>Veja também opções de [controle em tempo de execução](/manual/concepts/server#server_process).| |DBHost|não| |localhost|Nome do host de banco de dados.<br>No caso de localhost MySQL ou string vazia resulta no uso de um socket. No caso de PostgreSQL<br>apenas string vazia resulta na tentativa de usar socket.<br>No caso de [Oracle](/manual/appendix/install/oracle#connection_set_up) string vazia resulta na utilização do método de conexão Net Service Name; neste caso considere usar a variável de ambiente TNS\_ADMIN para especificar o diretório do arquivo tnsnames.ora.| |DBName|sim| | |Nome do banco de dados.<br>No caso de [Oracle](/manual/appendix/install/oracle#connection_set_up) se o método de conexão Net Service Name for usado, especifique o nome do serviço de tnsnames.ora ou configure para string vazia; configure a variável de ambiente TWO\_TASK se DBName estiver configurado como string vazia.| |DBPassword|não| | |Senha do banco de dados.<br>Comente esta linha se nenhuma senha for usada.| |DBPort|não|1024-65535| |Porta do banco de dados quando não utilizando socket local.<br>No caso de [Oracle](/manual/appendix/install/oracle#connection_set_up) se o método de conexão Net Service Name for usado este parâmetro será ignorado; o número de porta do arquivo tnsnames.ora será usado em vez disso.| |DBSchema|não| | |Nome do schema. Usado para PostgreSQL.| |DBSocket|não| | |Caminho para o arquivo de socket do MySQL.| |DBUser|não| | |Usuário do banco de dados.| |DBTLSConnect|não| | |A configuração desta opção impõe o uso de conexão TLS ao banco de dados:<br>*required* - (obrigatório) conecta utilizando TLS<br>*verify\_ca* - (verificação CA) conecta usando TLS e verifica certificado<br>*verify\_full* - (verificação completa) conecta usando TLS, verifica certificado e verifica se a identidade de banco de dados especificada por DBHost corresponde ao seu certificado<br><br>No MySQL a partir de 5.7.11 e PostgreSQL os seguintes valores são suportados: "required", "verify\_ca", "verify\_full". No MariaDB a partir da versão 10.2.6, os valores "required" e "verify\_full" são suportados.<br>Por padrão nenhuma opção é configurada e o comportamento depende da configuração do banco de dados.<br><br>Este parâmetro é suportado desde o Zabbix 5.0.0.| |DBTLSCAFile|no<br>(sim, se DBTLSConnect estiver configurado para um de: verify\_ca, verify\_full)| | |Caminho completo com nome do arquivo contendo certificados CA(s) de topo-de-nível para verificação do certificado do banco de dados.<br>Este parâmetro é suportado desde o Zabbix 5.0.0.| |DBTLSCertFile|não| | |Caminho completo com nome do arquivo contendo o certificado do Zabbix Server para autenticação ao banco de dados.<br>Este parâmetro é suportado desde o Zabbix 5.0.0.| |DBTLSKeyFile|não| | |Caminho completo com nome do arquivo contendo a chave privada para autenticação ao banco de dados.<br>Este parâmetro é suportado desde o Zabbix 5.0.0.| |DBTLSCipher|não| | |A lista de cifras de criptografia permitidas pelo Zabbix Server para protocolos TLS através do TLSv1.2.<br>Suportado apenas para MySQL.<br>Este parâmetro é suportado desde o Zabbix 5.0.0.| |DBTLSCipher13|não| | |A lista de suítes de cifra de criptografia permitidas pelo Zabbix Server para protocolo TLSv1.3.<br>Suportado apenas para MySQL, a partir da versão 8.0.16.<br>Este parâmetro é suportado desde o Zabbix 5.0.0.| |DebugLevel|não|0-5|3|Especifica o nível de depuração (debug):<br>0 - informação básica sobre início e parada do processos do Zabbix<br>1 - informações críticas<br>2 - informações de erro<br>3 - alertas<br>4 - para depuração (produz bastante informação)<br>5 - depuração estendida (produz ainda mais informação)<br>Veja também opções de [controle em tempo de execução](/manual/concepts/server#server_process) .| |ExportDir|não| | |Diretório para [exportação em tempo real](/manual/appendix/install/real_time_export) de eventos, histórico e tendências no formato JSON, delimitado por nova linha. Se configurado, habilita exportação em tempo real.<br>Este parâmetro é suportado desde o Zabbix 4.0.0.| |ExportFileSize|não|1M-1G|1G|Tamanho máximo por arquivo de exportação em bytes. Usado apenas para rotação se ExportDir for configurado.<br>Este parâmetro é suportado desde o Zabbix 4.0.0.| |ExportType|não| | |Lista de tipos de entidade separadas por vírgula (eventos, histórico, tendências) para [exportação em tempo real](/manual/appendix/install/real_time_export) (todos os tipos por padrão). Válido apenas se ExportDir estiver configurado.<br>*Note* que se ExportType estiver especificado, mas ExportDir não, então isso é um erro de configuração e o Server não irá iniciar.<br>p.e.:<br>ExportType=history,trends - exporta apenas histórico e tendências<br>ExportType=events - exporta apenas eventos| |ExternalScripts|não| |/usr/local/share/zabbix/externalscripts|Localização dos scripts externos (depende da variável de tempo de compilação de instalação *datadir*).| |Fping6Location|não| |/usr/sbin/fping6|Localização do fping6.<br>Certifique-se de que o binário do fping6 tem o root como proprietário e SUID configurado.<br>Deixe vazio ("Fping6Location=") se o seu utilitário fping for capaz de processar endereços IPv6.| |FpingLocation|não| |/usr/sbin/fping|Localização do fping.<br>Certifique-se de que o binário do fping6 tem o root como proprietário e SUID configurado!| |HANodeName|não| | |O nome do nó de cluster de alta disponibilidade.<br>Quando vazio o Server está trabalhando de modo isolado (standalone) e um nó com nome vazio é criado.| |HistoryCacheSize|não|128K-2G|16M|Tamanho do cache histórico, em bytes.<br>Tamanho da memória compartilhada para armazenamento de dado histórico.| |HistoryIndexCacheSize|não|128K-2G|4M|Tamanho do cache de índice histórico, em bytes.<br>Tamanho da memória compartilhada para indexação para dado histórico armazenado no cache histórico.<br>O tamanho do cache de índice precisa de aproximadamente 100 bytes para fazer cache de um item.<br>Este parâmetro é suportado desde o Zabbix 3.0.0.| |HistoryStorageDateIndex|não| |0|Habilita o pré-processamento de valores históricos no armazenamento histórico para armazenar valores em índices diferentes baseados na data:<br>0 - desabilita<br>1 - habilita| |HistoryStorageURL|não| | |URL HTTP\[S\] do armazenamento histórico.<br>Este parâmetro é usado para configuração do [Elasticsearch](/manual/appendix/install/elastic_search_setup).| |HistoryStorageTypes|não| |uint,dbl,str,log,text|Lista separada por vírgulas de tipos de valores a serem enviados para o armazenamento histórico.<br>Este parâmetro é usado para configuração do [Elasticsearch](/manual/appendix/install/elastic_search_setup).| |HousekeepingFrequency|não|0-24|1|Quão frequentemente o Zabbix executará o procedimento de limpeza (housekeeping) (em horas).<br>O processo de limpeza remove informação desatualizada do banco de dados.<br>*Nota*: Para prevenir sobrecarga do processo de limpeza (por exemplo, quando o histórico e períodos de tendência estão grandemente reduzidos), não mais do que 4 vezes HousekeepingFrequency horas de informação desatualizada é removida em um ciclo de limpeza, para cada item. Assim, se HousekeepingFrequency é 1, não mais do que 4 horas de informação desatualizada (a partir da entrada mais antiga) será eliminada por ciclo.<br>*Nota*: Para diminuir a carga na inicialização do Server, a limpeza é atrasada por 30 minutos após o Server iniciar. Desta forma se HousekeepingFrequency for 1, o primeiro procedimento de limpeza após a inicialização do Server será executada após 30 minutos, e se repetirá com um atraso de uma hora depois disso.<br>Desde o Zabbix 3.0.0 é possível desabilitar a limpeza automática pela configuração de HousekeepingFrequency para 0. Neste caso o procedimento de limpeza só pode ser iniciado pela opção de controle em tempo de execução *housekeeper\_execute* e o período de informação desatualizada eliminado em um ciclo de limpeza é 4 vezes o período decorrido desde o último ciclo de limpeza, mas não menor que 4 horas e não maior que 4 dias.<br>Veja também opções de [controle em tempo de execução](/manual/concepts/server#server_process) .| |Include|não| | |Você pode incluir arquivos individuais ou todos os arquivos em um diretório no arquivo de configuração.<br>Para incluir apenas arquivos relevantes no diretório especificado, O caracter coringa asterisco é suportado para padrão de correspondência. Por exemplo: `/absolute/path/to/config/files/*.conf`.<br>Consulte [notas especiais](special_notes_include) sobre limitações.| |JavaGateway|não| | |Endereço IP (ou nome do host) do Zabbix Java Gateway.<br>Necessário apenas se os pollers Java tiverem sido iniciados.| |JavaGatewayPort|não|1024-32767|10052|Porta na qual o Zabbix Java Gateway aguarda por comunicação.| |ListenBacklog|não|0 - INT\_MAX|SOMAXCONN|O número máximo de conexões pendentes na fila TCP.<br>O valor padrão é uma constante fixada em código, que depende do sistema.<br>O valor máximo suportado depende do sistema, valores muito altos podem ser silenciosamente truncados para o 'máximo especificado na implementação (implementation-specified maximum)'.| |ListenIP|não| |0.0.0.0|Lista delimitada por vírgula de endereços IP nos quais o trapper deve aguardar comunicação.<br>O trapper escutará em todas as interfaces de rede se este parâmetro estiver ausente.| |ListenPort|não|1024-32767|10051|Porta de comunicação para o trapper.| |LoadModule|não| | |Módulo a ser carregado na inicialização do Server. Módulos são usados para estender a funcionalidade do Server.<br>Formatos:<br>LoadModule=<module.so><br>LoadModule=<path/module.so><br>LoadModule=</abs\_path/module.so><br>Ou o módulo deve estar localizado no diretório especificado por LoadModulePath ou o caminho deve proceder o nome do módulo. Se o caminho precedente for absoluto (começar com '/') então LoadModulePath é ignorado.<br>É permitido incluir múltiplos parâmetros LoadModule.| |LoadModulePath|não| | |Caminho completo para a localização do módulos do Server.<br>O padrão depende das opções de compilação.| |LogFile|sim, se LogType for configurado como *file*, caso contrário<br>não| | |Nome do arquivo de log.| |LogFileSize|não|0-1024|1|Tamanho máximo do arquivo de log em MB.<br>0 - desabilita rotação de log automática.<br>*Nota*: Se o limite de tamanho do arquivo de log for alcançado e a rotação falha, por qualquer razão, o arquivo de log existente é truncado e iniciado novamente.| |LogType|não| |file (arquivo)|Tipo de saída de log:<br>*file* - grava o log em um arquivo especificado pelo parâmetro LogFile,<br>*system* - grava o log no syslog,<br>*console* - grava o log na saída padrão.<br>Este parâmetro é suportado desde o Zabbix 3.0.0.| |LogSlowQueries|não|0-3600000|0|Quanto tempo uma consulta de banco de dados pode levar antes de ser registrada em log (em milissegundos).<br>0 - não registra em log consultas lentas.<br>Esta opção se torna habilitada começando com DebugLevel=3.| |MaxHousekeeperDelete|não|0-1000000|5000|Não mais do que 'MaxHousekeeperDelete' linhas (correspondendo a \[tablename\], \[field\], \[value\]) serão eliminadas por uma tarefa em um ciclo de limpeza.<br>Se configurado como 0 então nenhum limite será usado. Neste caso você deve saber o que está fazendo, de modo a não [sobrecarregar o banco de dados!](zabbix_server#footnotes) **^[2](zabbix_server#footnotes)^**<br>Este parâmetro se aplica apenas para eliminação de histórico e tendências de itens já eliminados.| |NodeAddress|não| | |IP ou nome do host com porta opcional para sobrescrever como o Frontend deve conectar ao Server.<br>Formato: <endereço>\[:porta\]<br>A prioridade de endereços usados pelo Frontend para especificar o endereço do Server é: NodeAddress (1); ListenIP (se não 0.0.0.0 ou ::) (2); localhost (padrão) (3)<br>Veja também: parâmetro HANodeName| |PidFile|não| |/tmp/zabbix\_server.pid|Nome do arquivo PID.| |ProxyConfigFrequency|não|1-604800|3600|Com que frequência o Zabbix Server envia dados de configuração para um Zabbix Proxy em segundos. Usado apenas para proxies em um modo passivo.| |ProxyDataFrequency|não|1-3600|1|Com que frequência o Zabbix Server solicita dados históricos de um Zabbix Proxy em segundos. Usado apenas para Proxies em um modo passivo.| |SNMPTrapperFile|não| |/tmp/zabbix\_traps.tmp|Arquivo temporário usado para passagem de dados do daemon SNMP trap para o Server.<br>Deve ser o mesmo que o presente no zabbix\_trap\_receiver.pl ou arquivo de configuração SNMPTT.| |SocketDir|não| |/tmp|Diretório para armazenar sockets IPC usados pelos serviços internos do Zabbix.<br>Este parâmetro é suportado desde o Zabbix 3.4.0.| |SourceIP|não| | |Endereço IP de origem para:<br>- conexões de saída para Zabbix Proxy e Zabbix Agent;<br>- conexões sem agente (VMware, SSH, JMX, SNMP, Telnet e verificações simples);<br>- conexões de agente HTTP;<br>- requisições HTTP de item de script JavaScript;<br>- pré-processamento de requisições HTTP JavaScript;<br>- envio de e-mails de notificação (conexões ao servidor SMTP);<br>- notificações webhook (conexões HTTP JavaScript);<br>- conexões ao Vault| |SSHKeyLocation|não| | |Localização das chaves pública e privada para verificações e ações SSH| |SSLCertLocation|não| | |Localização dos arquivos de certificado de cliente SSL para autenticação do cliente.<br>Este parâmetro é utilizado apenas em monitoramento web.| |SSLKeyLocation|não| | |Localização dos arquivos de chave privada SSL para autenticação do cliente.<br>Este parâmetro é utilizado apenas em monitoramento web.| |SSLCALocation|não| | |Sobrescreve a localização dos arquivos de certificado de autoridade (CA) para verificação de certificado de servidor SSL. Se não configurado, diretório geral para todo o sistema será utilizado.<br>Note que o valores deste parâmetro será configurado como opção libcurl CURLOPT\_CAPATH. Para versões de libcurl anteriores de 7.42.0, isto só tem efeito se libcurl foi compilado para usar OpenSSL. Para mais informações consulte a [página web do cURL](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html).<br>Este parâmetro é usado em monitoramento web desde o Zabbix 2.4.0 e na autenticação SMTP desde o Zabbix 3.0.0.| |StartAlerters|não|1-100|3|Número de instâncias separadas (pre-forked) de [alertas](/manual/concepts/server#server_process_types).<br>Este parâmetro é suportado desde o Zabbix 3.4.0.| |StartDBSyncers|não|1-100|4|Número de instâncias separadas (pre-forked) de [sincronizadores de histórico](/manual/concepts/server#server_process_types).<br>*Nota*: Seja cuidadoso com a alteração deste valor, aumentá-lo pode causar mais mal do que bem. De forma aproximada, o valor padrão deve ser o suficiente para lidar com até 4000 NVPS.| |StartDiscoverers|não|0-250|1|Número de instâncias separadas (pre-forked) de [discobridores](/manual/concepts/server#server_process_types).| |StartEscalators|não|1-100|1|Número de instâncias separadas (pre-forked) de [escaladores](/manual/concepts/server#server_process_types).<br>Este parâmetro é suportado desde o Zabbix 3.0.0.| |StartHistoryPollers|não|0-1000|5|Número de instâncias separadas (pre-forked) de [pollers históricos](/manual/concepts/server#server_process_types).<br>Este parâmetro é suportado desde o Zabbix 5.4.0.| |StartHTTPPollers|não|0-1000|1|Número de instâncias separadas (pre-forked) de [pollers HTTP](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartIPMIPollers|não|0-1000|0|Número de instâncias separadas (pre-forked) de [pollers IPMI](/manual/concepts/server#server_process_types).| |StartJavaPollers|não|0-1000|0|Número de instâncias separadas (pre-forked) de [pollers Java](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartLLDProcessors|não|1-100|2|Número de instâncias separadas (pre-forked) de [operadores](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^** de descobertas de baixo-nível (LLD).<br>O processo gerenciador de LLD é automaticamente iniciado quando um operador LLD é iniciado.<br>Este parâmetro é suportado desde o Zabbix 4.2.0.| |StartODBCPollers|não|0-1000|1|Número de instâncias separadas (pre-forked) de [pollers ODBC](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartPingers|não|0-1000|1|Número de instâncias separadas (pre-forked) de [operadores de ping ICMP](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartPollersUnreachable|não|0-1000|1|Número de instâncias separadas (pre-forked) de [pollers para hosts inalcançáveis](/manual/concepts/server#server_process_types) (incluindo IPMI e Java)**^[1](zabbix_server#footnotes)^**.<br>Ao menos um poller para hosts inalcançáveis deve estar em execução se pollers regulares IPMI ou Java forem iniciados.| |StartPollers|não|0-1000|5|Número de instâncias separadas (pre-forked) de [pollers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartPreprocessors|não|1-1000|3|Número de instâncias separadas (pre-forked) de [operadores](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^** de pré-processamento.<br>O processo gerenciador de pré-processamento é automaticamente iniciado quando um operador pré-processador é iniciado.<br>Este parâmetro é suportado desde o Zabbix 3.4.0.| |StartProxyPollers|não|0-250|1|Número de instâncias separadas (pre-forked) de [pollers para Proxies passivos](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartReportWriters|não|0-100|0|Número de instâncias separadas (pre-forked) de [gravadores de relatório](/manual/concepts/server#server_process_types).<br>Se configurado para 0, a geração de relatórios agendados é desabilitada.<br>O processo gerenciador de relatórios é iniciado automaticamente quando um gravador de relatório é iniciado.<br>Este parâmetro é suportado desde o Zabbix 5.4.0.| |StartSNMPTrapper|não|0-1|0|Se configurado como 1, o processo de [trapper SNMP](/manual/concepts/server#server_process_types) será iniciado.| |StartTimers|não|1-1000|1|Número de instâncias separadas (pre-forked) de [temporizadores (timers)](/manual/concepts/server#server_process_types).<br>Temporizadores (timers) processam os períodos de manutenção.| |StartTrappers|não|0-1000|5|Número de instâncias separadas (pre-forked) de [trappers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.<br>Trappers aceitam conexões de entrada do Zabbix Sender, agentes ativos e Proxies ativos.| |StartVMwareCollectors|não|0-250|0|Número de instâncias separadas de [coletores VMware](/manual/concepts/server#server_process_types).| |StatsAllowedIP|não| | |Lista delimitada por vírgula de endereços IP, opcionalmente em notação CIDR, ou nomes DNS de instâncias externas do Zabbix. Requisições de estatísticas serão aceitas apenas a partir do endereços listados aqui. Se este parâmetro não for configurado nenhuma requisição de estatística será aceita.<br>Se o suporte a IPv6 estiver habilitado então '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' são tratados igualmente e '::/0' permitirá qualquer endereço IPv4 ou IPv6. '0.0.0.0/0' pode ser usado para permitir qualquer endereço IPv4.<br>Exemplo: StatsAllowedIP=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com<br>Este parâmetro é suportado desde o Zabbix 4.2.0.| |Timeout|não|1-30|3|Especifica por quanto tempo esperar por uma verificação de agente, dispositivo SNMP ou externa (em segundos).| |TLSCAFile|não| | |Caminho completo de um arquivo contendo os certificados CA(s) de topo-de-nível para verificação de pares de certificado, usado para criptografar comunicações entre componentes Zabbix.<br>Este parâmetro é suportado desde o Zabbix 3.0.0.| |TLSCertFile|não| | |Caminho completo de um arquivo contendo o certificado do servidor ou cadeia de certificado, usado para comunicações criptografadas entre componentes do Zabbix.<br>Este parâmetro é suportado desde o Zabbix 3.0.0.| |TLSCipherAll|não| | |String de prioridade GnuTLS ou string de cifra OpenSSL (TLS 1.2). Sobrescreve o critério de seleção padrão de suíte de cifra para criptografia baseada em certificado ou PSK.<br>Exemplo: TLS\_AES\_256\_GCM\_SHA384:TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256<br>Este parâmetro é suportado desde o Zabbix 4.4.7.| |TLSCipherAll13|não| | |String de cifra para OpenSSL 1.1.1 ou mais recente em TLS 1.3. Sobrescreve o critério de seleção padrão de suíte de cifra para criptografia baseada em certificado ou PSK.<br>Exemplo para GnuTLS: NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL::+SIGN-ALL:+CTYPE-X.509<br>Exemplo para OpenSSL: EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128<br>Este parâmetro é suportado desde o Zabbix 4.4.7.| |TLSCipherCert|não| | |String de prioridade GnuTLS ou string de cifra OpenSSL (TLS 1.2). Sobrescreve o critério de seleção padrão de suíte de cifra para criptografia baseada em certificado.<br>Exemplo para GnuTLS: NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509<br>Exemplo para OpenSSL: EECDH+aRSA+AES128:RSA+aRSA+AES128<br>Este parâmetro é suportado desde o Zabbix 4.4.7.| |TLSCipherCert13|não| | |String de cifra para OpenSSL 1.1.1 ou mais recente em TLS 1.3. Sobrescreve o critério de seleção padrão de suíte de cifra para criptografia baseada em certificado.<br>Este parâmetro é suportado desde o Zabbix 4.4.7.| |TLSCipherPSK|não| | |String de prioridade GnuTLS ou string de cifra OpenSSL (TLS 1.2). Sobrescreve o critério de seleção padrão de suíte de cifra para criptografia baseada em PSK.<br>Exemplo para GnuTLS: NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL<br>Exemplo para OpenSSL: kECDHEPSK+AES128:kPSK+AES128<br>Este parâmetro é suportado desde o Zabbix 4.4.7.| |TLSCipherPSK13|não| | |String de cifra para OpenSSL 1.1.1 ou mais recente em TLS 1.3. Sobrescreve o critério de seleção padrão de suíte de cifra para criptografia baseada em PSK.<br>Exemplo: TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256<br>Este parâmetro é suportado desde o Zabbix 4.4.7.| |TLSCRLFile|não| | |Caminho completo de um arquivo contendo certificados revogados. Este parâmetro é usado para comunicações criptografadas entre componentes do Zabbix.<br>Este parâmetro é suportado desde o Zabbix 3.0.0.| |TLSKeyFile|não| | |Caminho completo de um arquivo contendo a chave privada do Server, usado para comunicações criptografadas entre componentes do Zabbix.<br>Este parâmetro é suportado desde o Zabbix 3.0.0.| |TmpDir|não| |/tmp|Diretório temporário.| |TrapperTimeout|não|1-300|300|Especifica quantos segundos um trapper pode gastar processando novos dados.| |TrendCacheSize|não|128K-2G|4M|Tamanho do cache de tendência, em bytes.<br>Tamanho de memória compartilhada para armazenamento de dados de tendência.| |TrendFunctionCacheSize|não|128K-2G|4M|Tamanho do cache de função de tendência, em bytes.<br>Tamanho de memória compartilhada para cache de dados de função de tendência calculados.| |UnavailableDelay|não|1-3600|60|Com que frequência o host é verificado para disponibilidade durante o período de [indisponibilidade](/manual/appendix/items/unreachability#unavailable_host), em segundos.| |UnreachableDelay|não|1-3600|15|Com que frequência o host é verificado para disponibilidade durante o período de [inalcançabilidade](/manual/appendix/items/unreachability#unreachable_host), em segundos.| |UnreachablePeriod|não|1-3600|45|Após quantos segundos de [inalcançabilidade](/manual/appendix/items/unreachability#unreachable_host) tratar um host como indisponível.| |User|não| |zabbix|Retira os privilégios de um usuário específico, existente no sistema.<br>Só tem efeito se executado como 'root' e AllowRoot estiver desabilitado.| |ValueCacheSize|não|0,128K-64G|8M|Tamanho do cache de valor histórico, em bytes.<br>Tamanho de memória compartilhada para cache de requisições de dados históricos de item.<br>A configuração para 0 desabilita o cache de valor (não recomendado).<br>Quando o cache de valor fica sem memória compartilhada disponível uma mensagem de alerta é gravada no log do Server a cada 5 minutos.| |VaultDBPath|não| | |Caminho para o Vault de onde as credenciais para o banco de dados serão recuperadas pelas chaves 'password' e 'username'.<br>Exemplo: secret/zabbix/database<br>Esta opção pode ser usada apenas se DBUser e DBPassword não forem especificados.<br>Este parâmetro é suportado desde o Zabbix 5.2.0.| |VaultToken|não| | |Token de autenticação ao Vault que deve ter sido gerado exclusivamente para o Zabbix Server com permissão somente leitura ao caminhos definidos nas [macros Vault](/manual/config/macros/user_macros#configuration) e permissão somente leitura para o caminho definido no parâmetro de configuração opcional VaultDBPath.<br>É um erro se VaultToken e a variável de ambiente VAULT\_TOKEN estiverem definidas ao mesmo tempo.<br>Este parâmetro é suportado desde o Zabbix 5.2.0.| |VaultURL|não| |https://127.0.0.1:8200|URL HTTP\[S\] para o servidor Vault. O diretório de certificados geral do sistema será usado se SSLCALocation não for especificada.<br>Este parâmetro é suportado desde o Zabbix 5.2.0.| |VMwareCacheSize|não|256K-2G|8M|Tamanho de memória compartilhada para armazenamento de dados VMware.<br>Um verificação VMware interna zabbix\[vmware,buffer,...\] pode ser usada para monitorar a utilização de cache VMware (veja [Verificações internas](/manual/config/items/itemtypes/internal)).<br>Note que a memória compartilhada não é alocada se não houver instâncias de coletor vmware configuradas para iniciar.| |VMwareFrequency|não|10-86400|60|Atraso em segundos entre coleta de dados de um serviço VMware único.<br>Este atraso deve ser configurado para o menor intervalo de atualização de qualquer item de monitoramento VMware.| |VMwarePerfFrequency|não|10-86400|60|Atraso em segundos entre resgate de estatísticas de contador de performance de um serviço VMware único.<br>Este atraso deve ser configurado para o menor intervalo de atualização de qualquer [item](/manual/config/items/itemtypes/simple_checks/vmware_keys#footnotes) de monitoramento VMware que use contadores de performance VMware.| |VMwareTimeout|não|1-300|10|O número máximo de segundos que um coletor vmware aguardará por uma resposta do serviço VMware (vCenter ou ESX hypervisor).| |WebServiceURL|não| | |URL HTTP\[S\] para o serviço web do Zabbix no formato `<host:porta>/report`. Por exemplo: `http://localhost:10053/report`<br>Este parâmetro é suportado desde o Zabbix 5.4.0.|  

en-us	#### Parameters  |Parameter|<|Mandatory|Range|Default|Description| |-|----------|----------|----------|----------|--------------------------------------------------| |Alias|<|no| | |Sets an alias for an item key. It can be used to substitute long and complex item key with a smaller and simpler one.<br>Multiple *Alias* parameters may be present. Multiple parameters with the same *Alias* key are not allowed.<br>Different *Alias* keys may reference the same item key.<br>Aliases can be used in *HostMetadataItem* but not in *HostnameItem* parameters.<br><br>Examples:<br><br>1. Retrieving the ID of user 'zabbix'.<br>Alias=zabbix.userid:vfs.file.regexp\[/etc/passwd,"\^zabbix:.:(\[0-9\]+)",,,,\\1\]<br>Now shorthand key **zabbix.userid** may be used to retrieve data.<br><br>2. Getting CPU utilization with default and custom parameters.<br>Alias=cpu.util:system.cpu.util<br>Alias=cpu.util\[\*\]:system.cpu.util\[\*\]<br>This allows use **cpu.util** key to get CPU utilization percentage with default parameters as well as use **cpu.util\[all, idle, avg15\]** to get specific data about CPU utilization.<br><br>3. Running multiple [low-level discovery](/manual/discovery/low_level_discovery) rules processing the same discovery items.<br>Alias=vfs.fs.discovery\[\*\]:vfs.fs.discovery<br>Now it is possible to set up several discovery rules using **vfs.fs.discovery** with different parameters for each rule, e.g., **vfs.fs.discovery\[foo\]**, **vfs.fs.discovery\[bar\]**, etc.| |AllowKey|<|no| | |Allow execution of those item keys that match a pattern. Key pattern is a wildcard expression that supports "\*" character to match any number of any characters.<br>Multiple key matching rules may be defined in combination with DenyKey. The parameters are processed one by one according to their appearance order.<br>This parameter is supported since Zabbix 5.0.0.<br>See also: [Restricting agent checks](/manual/config/items/restrict_checks).| |BufferSend|<|no|1-3600|5|The time interval in seconds which determines how often values are sent from the buffer to Zabbix server.<br>Note that if the buffer is full, the data will be sent sooner.| |BufferSize|<|no|2-65535|100|Maximum number of values in a memory buffer. The agent will send all collected data to Zabbix server or proxy if the buffer is full.<br>This parameter should only be used if persistent buffer is disabled (*EnablePersistentBuffer=0*).| |ControlSocket| |no| |/tmp/agent.sock|The control socket, used to send runtime commands with '-R' option.| |DebugLevel|<|no|0-5|3|Specifies debug level:<br>0 - basic information about starting and stopping of Zabbix processes<br>1 - critical information<br>2 - error information<br>3 - warnings<br>4 - for debugging (produces lots of information)<br>5 - extended debugging (produces even more information)| |DenyKey|<|no| | |Deny execution of those item keys that match a pattern. Key pattern is a wildcard expression that supports "\*" character to match any number of any characters.<br>Multiple key matching rules may be defined in combination with AllowKey. The parameters are processed one by one according to their appearance order.<br>This parameter is supported since Zabbix 5.0.0.<br>See also: [Restricting agent checks](/manual/config/items/restrict_checks).| |EnablePersistentBuffer|<|no|0-1|0|Enable usage of local persistent storage for active items.<br>0 - disabled<br>1 - enabled<br>If persistent storage is disabled, the memory buffer will be used.| |ForceActiveChecksOnStart|<|no|0-1|0 |Perform active checks immediately after restart for the first received configuration.<br>0 - disabled<br>1 - enabled<br>Also available as per plugin configuration parameter, for example: `Plugins.Uptime.System.ForceActiveChecksOnStart=1` <br> Supported since Zabbix 6.0.2. | |HostInterface| |no|0-255 characters| |Optional parameter that defines host interface.<br>Host interface is used at host autoregistration process.<br>An agent will issue an error and not start if the value is over the limit of 255 characters.<br>If not defined, value will be acquired from HostInterfaceItem.<br>Supported since Zabbix 4.4.0.| |HostInterfaceItem|<|no| | |Optional parameter that defines an item used for getting host interface.<br>Host interface is used at host autoregistration process.<br>During an autoregistration request an agent will log a warning message if the value returned by specified item is over limit of 255 characters.<br>The [*system.run[]*](/manual/config/items/itemtypes/zabbix_agent#system-data) item is supported regardless of AllowKey/DenyKey values.<br>This option is only used when HostInterface is not defined.<br>Supported since Zabbix 4.4.0.| |HostMetadata|<|no|0-255 characters| |Optional parameter that defines host metadata. Host metadata is used at host autoregistration process.<br>An agent will issue an error and not start if the specified value is over the limit or a non-UTF-8 string.<br>If not defined, the value will be acquired from HostMetadataItem.| |HostMetadataItem|<|no| | |Optional parameter that defines an item used for getting host metadata. Host metadata item value is retrieved on each autoregistration attempt for host autoregistration process.<br>During an autoregistration request an agent will log a warning message if the value returned by the specified item is over the limit of 255 characters.<br>This option is only used when HostMetadata is not defined.<br>Supports UserParameters and aliases. Supports [*system.run[]*](/manual/config/items/itemtypes/zabbix_agent#system-data) regardless of AllowKey/DenyKey values.<br>The value returned by the item must be a UTF-8 string otherwise it will be ignored.| |Hostname|<|no| |Set by HostnameItem|List of comma-delimited unique, case-sensitive hostnames.<br>Required for active checks and must match hostnames as configured on the server. Value is acquired from HostnameItem if undefined.<br>Allowed characters: alphanumeric, '.', ' ', '\_' and '-'.<br>Maximum length: 128 characters per hostname, 2048 characters for the entire line.| |HostnameItem|<|no| |system.hostname|Item used for generating Hostname if it is not defined. Ignored if Hostname is defined.<br>Does not support UserParameters or aliases, but does support [*system.run[]*](/manual/config/items/itemtypes/zabbix_agent#system-data) regardless of AllowKey/DenyKey values.| |Include| |no| | |You may include individual files or all files in a directory in the configuration file.<br>During the installation Zabbix will create the include directory in /usr/local/etc, unless modified during the compile time.<br>To only include relevant files in the specified directory, the asterisk wildcard character is supported for pattern matching. For example: `/absolute/path/to/config/files/*.conf`.<br>Since Zabbix 6.0.0 a path can be relative to *zabbix\_agent2.conf* file location.<br>See [special notes](special_notes_include) about limitations.| |ListenIP|<|no| |0.0.0.0|List of comma-delimited IP addresses that the agent should listen on.<br>The first IP address is sent to Zabbix server, if connecting to it, to retrieve the list of active checks.| |ListenPort|<|no|1024-32767|10050|Agent will listen on this port for connections from the server.| |LogFile|<|yes, if LogType is set to *file*, otherwise<br>no| |/tmp/zabbix\_agent2.log|Log file name if LogType is 'file'.| |LogFileSize|<|no|0-1024|1|Maximum size of log file in MB.<br>0 - disable automatic log rotation.<br>*Note*: If the log file size limit is reached and file rotation fails, for whatever reason, the existing log file is truncated and started anew.| |LogType|<|no| |file|Specifies where log messages are written to:<br>*system* - syslog,<br>*file* - file specified by LogFile parameter,<br>*console* - standard output.| |PersistentBufferFile|<|no| | |The file, where Zabbix Agent2 should keep SQLite database.<br>Must be a full filename.<br>This parameter is only used if persistent buffer is enabled (*EnablePersistentBuffer=1*).| |PersistentBufferPeriod| |no|1m-365d|1h|The time period for which data should be stored, when there is no connection to the server or proxy. Older data will be lost. Log data will be preserved.<br>This parameter is only used if persistent buffer is enabled (*EnablePersistentBuffer=1*).| |PidFile|<|no| |/tmp/zabbix\_agent2.pid|Name of PID file.| |Plugin|<|no| | |Since Zabbix 6.0.0 most of the plugins have their own [configuration files](/manual/appendix/config/zabbix_agent2_plugins). The agent configuration file contains plugin parameters listed below.| | |Plugins.Log.MaxLinesPerSecond|no|1-1000|20|Maximum number of new lines the agent will send per second to Zabbix server or proxy when processing 'log' and 'eventlog' active checks.<br>The provided value will be overridden by the parameter 'maxlines',<br>provided in 'log' or 'eventlog' item key.<br>*Note*: Zabbix will process 10 times more new lines than set in *MaxLinesPerSecond* to seek the required string in log items.<br>This parameter is supported since 4.4.2 and replaces MaxLinesPerSecond.| |^|Plugins.SystemRun.LogRemoteCommands|no| |0|Enable logging of executed shell commands as warnings.<br>0 - disabled<br>1 - enabled<br>Commands will be logged only if executed remotely. Log entries will not be created if system.run\[\] is launched locally by HostMetadataItem, HostInterfaceItem or HostnameItem parameters.<br>This parameter is supported since 4.4.2 and replaces LogRemoteCommands.| |PluginSocket|<|no| |/tmp/agent.plugin.sock |Path to Unix socket for loadable plugin communications.| |PluginTimeout|<|no|1-30 |Global timeout |Timeout for connections with loadable plugins.| |RefreshActiveChecks|<|no|60-3600|120|How often the list of active checks is refreshed, in seconds.<br>Note that after failing to refresh active checks the next refresh will be attempted after 60 seconds.| |Server|<|yes| | |List of comma-delimited IP addresses, optionally in CIDR notation, or DNS names of Zabbix servers and Zabbix proxies.<br>Incoming connections will be accepted only from the hosts listed here.<br>If IPv6 support is enabled then '127.0.0.1', '::ffff:127.0.0.1' are treated equally and '::/0' will allow any IPv4 or IPv6 address.<br>'0.0.0.0/0' can be used to allow any IPv4 address.<br>Example: Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com<br>Spaces are allowed.| |ServerActive|<|no| | |Zabbix server/proxy address or cluster configuration to get active checks from.<br>Server/proxy address is IP address or DNS name and optional port separated by colon.<br>Cluster configuration is one or more server addresses separated by semicolon.<br>Multiple Zabbix servers/clusters and Zabbix proxies can be specified, separated by comma.<br>More than one Zabbix proxy should not be specified from each Zabbix server/cluster.<br>If Zabbix proxy is specified then Zabbix server/cluster for that proxy should not be specified.<br>Multiple comma-delimited addresses can be provided to use several independent Zabbix servers in parallel. Spaces are allowed.<br>If port is not specified, default port is used.<br>IPv6 addresses must be enclosed in square brackets if port for that host is specified.<br>If port is not specified, square brackets for IPv6 addresses are optional.<br>If this parameter is not specified, active checks are disabled.<br>Example for Zabbix proxy:<br>ServerActive=127.0.0.1:10051<br>Example for multiple servers:<br>ServerActive=127.0.0.1:20051,zabbix.domain,\[::1\]:30051,::1,\[12fc::1\]<br>Example for high availability:<br>ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3<br>Example for high availability with two clusters and one server:<br>ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain| |SourceIP|<|no| | |Source IP address for:<br>- outgoing connections to Zabbix server or Zabbix proxy;<br>- making connections while executing some items (web.page.get, net.tcp.port, etc.)| |StatusPort|<|no|1024-32767| |If set, agent will listen on this port for HTTP status requests (http://localhost:<port>/status).| |Timeout|<|no|1-30|3|Spend no more than Timeout seconds on processing.| |TLSAccept|<|yes, if TLS certificate or PSK parameters are defined (even for *unencrypted* connection), otherwise no| | |What incoming connections to accept. Used for a passive checks. Multiple values can be specified, separated by comma:<br>*unencrypted* - accept connections without encryption (default)<br>*psk* - accept connections with TLS and a pre-shared key (PSK)<br>*cert* - accept connections with TLS and a certificate| |TLSCAFile|<|no| | |Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification, used for encrypted communications between Zabbix components.| |TLSCertFile|<|no| | |Full pathname of a file containing the agent certificate or certificate chain, used for encrypted communications with Zabbix components.| |TLSConnect|<|yes, if TLS certificate or PSK parameters are defined (even for *unencrypted* connection), otherwise no| | |How the agent should connect to Zabbix server or proxy. Used for active checks. Only one value can be specified:<br>*unencrypted* - connect without encryption (default)<br>*psk* - connect using TLS and a pre-shared key (PSK)<br>*cert* - connect using TLS and a certificate| |TLSCRLFile|<|no| | |Full pathname of a file containing revoked certificates. This parameter is used for encrypted communications with Zabbix components.| |TLSKeyFile|<|no| | |Full pathname of a file containing the agent private key used for encrypted communications with Zabbix components.| |TLSPSKFile|<|no| | |Full pathname of a file containing the agent pre-shared key used for encrypted communications with Zabbix components.| |TLSPSKIdentity|<|no| | |Pre-shared key identity string, used for encrypted communications with Zabbix server.| |TLSServerCertIssuer|<|no| | |Allowed server (proxy) certificate issuer.| |TLSServerCertSubject|<|no| | |Allowed server (proxy) certificate subject.| |UnsafeUserParameters|<|no|0,1|0|Allow all characters to be passed in arguments to user-defined parameters.<br>The following characters are not allowed:<br>\\ ' " \` \* ? \[ \] { } \~ $ ! & ; ( ) < > \| \# @<br>Additionally, newline characters are not allowed.| |UserParameter|<|no| | |User-defined parameter to monitor. There can be several user-defined parameters.<br>Format: UserParameter=<key>,<shell command><br>Note that shell command must not return empty string or EOL only.<br>Shell commands may have relative paths, if UserParameterDir parameter is specified.<br>Examples:<br>UserParameter=system.test,who\|wc -l<br>UserParameter=check\_cpu,./custom\_script.sh| |UserParameterDir|<|no| | |Default search path for UserParameter commands. If used, the agent will change its working directory to the one specified here before executing a command. Thereby, UserParameter commands can have a relative `./` prefix instead of a full path.<br>Only one entry is allowed.<br>Example: UserParameterDir=/opt/myscripts|
pt-br	#### Parâmetros  |Parâmetro| |Obrigatório|Intervalo|Padrão|Descrição| |---------|-|---------|-----|-------|-----------| |Alias| |não| | |Configura um apelido para uma chave de item. Ele pode ser usado para substituir uma chave de item longa e complexa por uma menor e mais simples.<br>Múltiplos parâmetros *Alias* podem estar presentes. Múltiplos parâmetros com a mesma chave *Alias* são permitidos.<br>Diferentes chaves *Alias* podem referenciar a mesma chave de item.<br>Apelidos podem ser usados nos parâmetros *HostMetadataItem* mas não nos *HostnameItem*.<br><br>Exemplos:<br><br>1. Recuperando o ID do usuário 'zabbix'.<br>Alias=zabbix.userid:vfs.file.regexp\[/etc/passwd,"\^zabbix:.:(\[0-9\]+)",,,,\\1\]<br>Agora a chave abreviada **zabbix.userid** pode ser usada para recuperação deste dado.<br><br>2. Obtendo utilização de CPU com parâmetros padrão e customizados.<br>Alias=cpu.util:system.cpu.util<br>Alias=cpu.util\[\*\]:system.cpu.util\[\*\]<br>Isto permite usar a chave **cpu.util** para obter a porcentagem de utilização de CPU com parâmetros padrão assim como usar **cpu.util\[all, idle, avg15\]** para obter dados específicos sobre utilização de CPU.<br><br>3. Execução de múltiplas regras de [descoberta de baixo-nível](/manual/discovery/low_level_discovery) processando os mesmos itens descobertos.<br>Alias=vfs.fs.discovery\[\*\]:vfs.fs.discovery<br>Agora é possível configurar várias regras de descoberta usando **vfs.fs.discovery** com parâmetros diferentes para cada regra, p.e., **vfs.fs.discovery\[foo\]**, **vfs.fs.discovery\[bar\]**, etc.| |AllowKey| |não| | |Permite execução das chaves de item que correspondem ao padrão. Padrão de chave é uma expressão curinga que suporta o caracter "\*" para corresponder a qualquer número de quaisquer caracteres.<br>Múltiplas regras de correspondência de chave podem ser definidas em combinação com DenyKey. Os parâmetros são processados um por um de acordo com sua ordem de aparição.<br>Este parâmetro é suportado desde o Zabbix 5.0.0.<br>Veja também: [Restringindo verificações do agente](/manual/config/items/restrict_checks).| |BufferSend| |não|1-3600|5|O intervalo de tempo em segundos que determina com que frequência os valores são enviados do buffer para o Zabbix Server.<br>Note que se o buffer estiver cheio, os dados serão enviados mais cedo.| |BufferSize| |não|2-65535|100|Número máximo de valores em um buffer de memória. O agente enviará todos os dados coletados para o Zabbix Server ou Proxy se o buffer estiver cheio.<br>Este parâmetro deve ser usado apenas se o buffer persistente estiver desabilitado (*EnablePersistentBuffer=0*).| |ControlSocket| |não| |/tmp/agent.sock|O socket de controle, usado para enviar comandos de tempo de execução com a opção '-R'.| |DebugLevel| |não|0-5|3|Especifica nível de depuração (debug):<br>0 - informações básicas sobre início e parada dos processos do Zabbix<br>1 - informações críticas<br>2 - informações de erro<br>3 - alertas<br>4 - para depuração (produz bastante informação)<br>5 - depuração estendida (produz ainda mais informações)| |DenyKey| |não| | |Nega a execução das chaves de item que correspondem ao padrão. Padrão de chave é uma expressão curinga que suporta o caracter "\*" para corresponder a qualquer número de quaisquer caracteres.<br>Múltiplas regras de correspondência de chave podem ser definidas em combinação com DenyKey. Os parâmetros são processados um por um de acordo com sua ordem de aparição.<br>Este parâmetro é suportado desde o Zabbix 5.0.0.<br>Veja também: [Restringindo verificações do agente](/manual/config/items/restrict_checks).| |EnablePersistentBuffer| |não|0-1|0|Habilita o uso de armazenamento local persistente para itens ativos.<br>0 - desabilitado<br>1 - habilitado<br>Se o armazenamento persistente estiver desabilitado, o buffer de memória será usado.| |HostInterface| |não|0-255 caracteres| |Parâmetro opcional que define interface do host.<br>A interface do host é usada no processo de autoregistro de host.<br>Um agente emitirá um erro e não iniciará se o valor estiver acima do limite de 255 caracteres.<br>Se não definido, o valor será adquirido de HostInterfaceItem.<br>Suportado desde o Zabbix 4.4.0.| |HostInterfaceItem| |não| | |Parâmetro opcional que define um item usado para obtenção da interface do host.<br>A interface do host é usada no processo de autoregistro de host.<br>Durante uma requisição de autoregistro um agente registrará em log uma mensagem de alerta se o valor retornado pelo item especificado estiver acima do limite de 255 caracteres.<br>Esta opção é usada apenas quando HostInterface não é definido.<br>Suportado desde o Zabbix 4.4.0.| |HostMetadata| |não|0-255 caracteres| |Parâmetro opcional que define os metadados do host. Os metadados de host são usados no processo de autoregistro.<br>Um agente emitirá um erro e não iniciará se o valor especificado estiver acima do limite ou for uma string não-UTF-8.<br>Se não definido, o valor será adquirido de HostMetadataItem.| |HostMetadataItem| |não| | |Parâmetro opcional que define um item usado para obtenção de metadados de host. O item de metadados de host é recuperado em cada tentativa de autoregistro para o processo de autoregistro de host.<br>Durante uma requisição de autoregistro um agente registrará em log uma mensagem de alerta se o valor retornado pelo item especificado estiver acima do limite de 255 caracteres.<br>Esta opção é usada apenas quando HostMetadata não é definido.<br>Suporta UserParameters e apelidos (aliases). Suporta *system.run\[\]* independentemente dos valores de AllowKey/DenyKey.<br>O valor retornado pelo item deve ser uma string UTF-8 caso contrário ele será ignorado.| |Hostname| |não| |Configurado por HostnameItem|Lista separada por vírgula de nomes de host únicos, sensíveis a maiúsculas e minúsculas.<br>Necessário para verificações ativas e deve corresponder aos nomes de host conforme configurado no Server. O valor é adquirido de HostnameItem se não definido.<br>Caracteres permitidos: alfanuméricos, '.', ' ', '\_' e '-'.<br>Comprimento máximo: 128 caracteres por nome de host, 2048 caracteres para a linha inteira.| |HostnameItem| |não| |system.hostname|Item usado para geração do Hostname se ele não estiver definido. Ignorado se Hostname estiver definido.<br>Não suporta UserParameters ou apelidos, mas suporta *system.run\[\]* independentemente dos valores de AllowKey/DenyKey.<br>O comprimento de saída é limitado em 512KB.| |Include| |não| | |Você pode incluir arquivos individuais ou todos os arquivos de um diretório no arquivo de configuração.<br>Durante a instalação o Zabbix criará o diretório de include em /usr/local/etc, a menos que modificado durante o tempo de compilação.<br>Para incluir apenas arquivos relevantes no diretório especificado, o caracter curinga asterisco é suportado para correspondência de padrão. Por exemplo: `/absolute/path/to/config/files/*.conf`.<br>Desde o Zabbix 6.0.0 um caminho pode ser relativo à localização do arquivo *zabbix\_agent2.conf*.<br>Consulte [notas especiais](special_notes_include) sobre limitações.| |ListenIP| |não| |0.0.0.0|Lista separada por vírgula de endereços IP que o agente deve ouvir.<br>O primeiro endereço IP é enviado para o Zabbix Server, se conectando a ele, para recuperar a lista de verificações ativas.| |ListenPort| |não|1024-32767|10050|O agente ouvirá nesta porta por conexões vindas do Server.| |LogFile| |sim, se LogType estiver configurado como *file*, caso contrário<br>não| |/tmp/zabbix\_agent2.log|Nome do arquivo de log se LogType for 'file'.| |LogFileSize| |não|0-1024|1|Tamanho máximo do arquivo de log em MB.<br>0 - desabilita rotação de log automática.<br>*Nota*: Se o limite de tamanho de arquivo de log for alcançado e a rotação do arquivo falhar, por qualquer razão, o arquivo de log existente é truncado e iniciado outra vez.| |LogType| |não| |file|Especifica onde as mensagens de log são gravadas:<br>*system* - syslog,<br>*file* - arquivo especificado pelo parâmetro LogFile,<br>*console* - saída padrão.| |PersistentBufferFile| |não| | |O arquivo, onde o Zabbix Agent2 deve manter o banco de dados SQLite.<br>Deve ser um nome de arquivo completo.<br>Este parâmetro é usado apenas se o buffer persistente estiver habilitado (*EnablePersistentBuffer=1*).| |PersistentBufferPeriod| |não|1m-365d|1h|O período de tempo pelo qual o dado deve ser armazenado, quando não há conexão com o Server ou Proxy. Dados mais antigos serão perdidos. Dados de log serão preservados.<br>Este parâmetro é usado somente se o buffer persistente estiver habilitado (*EnablePersistentBuffer=1*).| |PidFile| |não| |/tmp/zabbix\_agent2.pid|Nome do arquivo PID.| |Plugins| |não| | |Desde o Zabbix 6.0.0 a maioria dos plugins tem seus próprios [arquivos de configuração](/manual/appendix/config/zabbix_agent2_plugins). O arquivo de configuração contém os parâmetros de plugin listados abaixo.| | |Plugins.Log.MaxLinesPerSecond|não|1-1000|20|Número máximo de novas linhas que o agente enviará por segundo para o Zabbix Server ou Proxy quando processando verificações ativas de 'log' e 'eventlog'.<br>O valor fornecido será sobrescrito pelo parâmetro 'maxlines',<br>provido na chave de item 'log' ou 'eventlog'.<br>*Nota*: O Zabbix processará 10 vezes mais novas linhas que o configurado em *MaxLinesPerSecond* para procurar a string requerida em itens de log.<br>Este parâmetro é suportado desde o 4.4.2 e substitui MaxLinesPerSecond.| |^|Plugins.SystemRun.LogRemoteCommands|não| |0|Habilita registro de log de comandos shell executados como alertas.<br>0 - desabilitado<br>1 - habilitado<br>Comandos serão registrados em log apenas se executados remotamente. Entradas de log não serão criadas se system.run\[\] for lançado localmente pelos parâmetros HostMetadataItem, HostInterfaceItem ou HostnameItem.<br>Este parâmetro é suportado desde o 4.4.2 e substitui LogRemoteCommands.| |RefreshActiveChecks| |não|60-3600|120|Com que frequência a lista de verificações ativas é atualizada, em segundos.<br>Note que após uma falha em atualizar as verificações ativas a próxima atualização será tentada após 60 segundos.| |Server| |sim| | |Lista separada por vírgula de endereços IP, opcionalmente em notação CIDR, ou nomes DNS de Zabbix Servers e Zabbix Proxies.<br>Conexões de entrada serão aceitas apenas a partir dos hosts listados aqui.<br>Se o suporte a IPv6 estiver habilitado então '127.0.0.1', '::ffff:127.0.0.1' são tratados igualmente e '::/0' permitirão qualquer endereço IPv4 ou IPv6.<br>'0.0.0.0/0' pode ser usado para permitir quaisquer endereços IPv4.<br>Exemplo: Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com<br>Espaços são permitidos.| |ServerActive| |não| | |Lista separada por vírgula de pares de endereços IP ou nome DNS (endereço:porta) ou clusters (endereço:porta;endereço2:porta) de Zabbix Servers e Zabbix Proxies para verificações ativas.<br>Nós de cluster devem ser separados por um ponto-e-vírgula.<br>Múltiplos endereços separados por vírgula podem ser fornecidos para usar vários Zabbix Servers independentes em paralelo. Espaços são permitidos.<br>Se porta não for especificada, a porta padrão é usada.<br>Endereços IPv6 devem ser envoltos por colchetes se a porta para o host for especificado.<br>Se a porta não for especificada, os colchetes para endereços IPv6 são opcionais.<br>Se este parâmetro não for especificado, verificações ativas são desabilitadas.<br>Exemplo para múltiplos Servers:<br>ServerActive=127.0.0.1:20051,zabbix.domain,\[::1\]:30051,::1,\[12fc::1\]<br>Exemplo para alta disponibilidade:<br>ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3<br>Exemplo para alta disponibilidade com dois clusters e um Server:<br>ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain| |SourceIP| |não| | |Endereços IP de origem para:<br>- conexões de saída para o Zabbix Server ou Zabbix Proxy;<br>- criação de conexões quando executando alguns itens (web.page.get, net.tcp.port, etc.)| |StatusPort| |não|1024-32767| |Se configurado, o agente ouvirá nesta porta por requisições de estado HTTP (http://localhost:<porta>/status).| |Timeout| |não|1-30|3|Gastar não mais do que Timeout segundos no processamento.| |TLSAccept| |sim, se certificado TLS ou parâmetros PSK são definidos (mesmo para conexão *não criptografada*), caso contrário não| | |Quais conexões de entrada aceitar. Usado para verificações passivas. Múltiplos valores podem ser especificados, separados por vírgula:<br>*unencrypted* - aceita conexões sem criptografia (padrão)<br>*psk* - aceita conexões com TLS e uma chave pré-compartilhada (PSK)<br>*cert* - aceita conexões com TLS e um certificado| |TLSCAFile| |não| | |Caminho completo de um arquivo contendo certificados CA(s) de topo-de-nível para verificação de pares de certificado, usado para comunicações criptografadas entre componentes Zabbix.| |TLSCertFile| |não| | |Caminho completo de um arquivo contendo os certificados de agente ou cadeia de certificado, usado para comunicações criptografadas com componentes Zabbix.| |TLSConnect| |sim, se certificado TLS ou parâmetros PSK estão definidos (mesmo para conexões *não criptografadas*), caso contrário não| | |Como o agente deve se conectar ao Zabbix Server ou Proxy. Usado para verificações ativas. Apenas um valor pode ser especificado:<br>*unencrypted* - conecta sem criptografia (padrão)<br>*psk* - conecta usando TLS e uma chave pré-compartilhada (PSK)<br>*cert* - conecta usando TLS e um certificado| |TLSCRLFile| |não| | |Caminho completo de um arquivo contendo certificados revogados. Este parâmetro é usado para comunicações criptografadas com componentes Zabbix.| |TLSKeyFile| |não| | |Caminho completo de um arquivo contendo a chave privada do agente usada para comunicações criptografadas com componentes Zabbix.| |TLSPSKFile| |não| | |Caminho completo de um arquivo contendo a chave pré-compartilhada do agente usada para comunicações criptografadas com componentes Zabbix.| |TLSPSKIdentity| |não| | |String de identidade de chave pré-compartilhada, usada para comunicações criptografadas com o Zabbix Server.| |TLSServerCertIssuer| |não| | |Emissor de certificado de Server (Proxy) permitido.| |TLSServerCertSubject| |não| | |Cliente de certificado de Server (Proxy) permitido.| |UnsafeUserParameters| |não|0,1|0|Permite que todos os caracteres sejam passados em argumentos para parâmetros definidos por usuário.<br>Os seguintes caracteres não são permitidos:<br>\\ ' " \` \* ? \[ \] { } \~ $ ! & ; ( ) < > \| \# @<br>Adicionalmente, caracteres de nova linha não são permitidos.| |UserParameter| |não| | |Parâmetro definido por usuário para monitoramento. Podem existir vários parâmetros definidos por usuário.<br>Formato: UserParameter=<chave>,<comando shell><br>Note que o comando shell não deve retornar uma string vazia ou apenas EOL.<br>Comandos shell podem ter caminhos relativos, se o parâmetro UserParameterDir for especificado.<br>Exemplos:<br>UserParameter=system.test,who\|wc -l<br>UserParameter=check\_cpu,./custom\_script.sh| |UserParameterDir| |não| | |Caminho de busca padrão para comandos UserParameter. Se usado, o agente alterará seu diretório de operação para o especificado aqui antes da execução de um comando. Deste modo, comandos UserParameter podem ter um prefixo relativo `./` em vez de um caminho completo.<br>Apenas uma entrada é permitida.<br>Exemplo: UserParameterDir=/opt/myscripts