host_get
Read-onlyIdempotent
Retrieve monitored hosts from Zabbix with filters for IDs, groups, templates, proxies, or search criteria to find specific hosts in your monitoring system.
Instructions
Get hosts from Zabbix with optional filtering.
Retrieves a list of monitored hosts from Zabbix. You can filter by host IDs, groups, templates, proxies, or use search criteria. This is useful for discovering which hosts are available in your monitoring system.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Page size - maximum number of results to return. Default is 100. | |
| offset | No | Number of matching hosts to skip. Use with 'limit' to page through results; check 'has_more' and 'total' in the response. | |
| output | No | Output format: 'extend' or specific fields. | extend |
| search | No | Search criteria (e.g., {'host': 'web'} to perform a 'LIKE' search). | |
| status | No | Shortcut to filter by status (0=enabled, 1=disabled) (constructs filter={'status': status}). | |
| hostids | No | List of host IDs to retrieve. | |
| groupids | No | List of host group IDs to filter by. | |
| proxyids | No | List of proxy IDs to filter by. | |
| sortfield | No | Field to sort by - 'hostid', 'host', 'name' or 'status'. A deterministic sort is required for paging to be consistent. | hostid |
| sortorder | No | Sort direction - 'ASC' or 'DESC'. | ASC |
| select_tags | No | If true, include the tags for each host in the response (selectTags=extend). | |
| templateids | No | List of template IDs to filter by. | |
| count_output | No | If true, returns only the count of matched objects as an integer. | |
| filter_params | No | Filter criteria (e.g., {'status': 0}). | |
| select_groups | No | If true, include the host groups each host belongs to in the response (selectHostGroups=extend). | |
| select_templates | No | If true, include the templates linked to each host in the response (selectTemplates=extend). | |
| hostname_contains | No | Shortcut to search for hosts by name (constructs search={'host': hostname_contains}). | |
| select_interfaces | No | If true, include the interfaces for each host in the response (selectInterfaces=extend). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||