zabbix_host_get
Retrieve Zabbix hosts by ID, name, or IP, with filters for groups, templates, and custom criteria. Optionally include related data such as interfaces, triggers, macros, and inventory.
Instructions
Retrieves Zabbix host information. Can filter by various criteria including direct IDs or by resolving host identifiers (names, IPs).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of hosts to return. | |
| filter | No | Filter criteria (e.g., { status: 0, host: 'webserver01' }). | |
| output | No | Properties to return. Defaults to 'extend'. Common options: ['hostid', 'host', 'name', 'status', 'error', 'available']. | extend |
| search | No | Wildcard search criteria (e.g., { host: 'web*' }). Will search in 'host' (technical name) and 'name' (visible name) fields primarily. | |
| hostids | No | Array of direct Zabbix Host IDs to retrieve. | |
| groupids | No | Array of group IDs to filter hosts by. | |
| sortfield | No | Field(s) to sort by (e.g., 'name', ['status', 'host']). | |
| sortorder | No | Sort order ('ASC' or 'DESC'). | |
| selectItems | No | Include items from the host. | |
| templateids | No | Array of template IDs to filter hosts by. | |
| selectGroups | No | Include host group information. Use 'extend' for all group fields or specify an array like ['groupid', 'name']. | extend |
| selectMacros | No | Include host macros. Use 'extend' for all macro fields or specify an array like ['macro', 'value']. | |
| selectTriggers | No | Include triggers from the host. | |
| hostIdentifiers | No | Array of host technical names, visible names, or IP addresses to resolve to IDs for filtering. Use this OR direct filter options like 'hostids' or 'filter'. | |
| selectInventory | No | Include host inventory data. Use 'extend' for all inventory fields or specify an array of inventory property names (e.g. ['os', 'type']). | |
| selectInterfaces | No | Include host interface information. Use 'extend' for all interface fields or specify an array like ['interfaceid', 'ip', 'port', 'type']. | extend |
| selectParentTemplates | No | Include linked parent template information. Use 'extend' for all template fields or specify an array like ['templateid', 'name']. | extend |