Table of Contents


Available since version: 1.8
This function allows you to retrieve proxy details based on filtering options. All parameters are optional. If parameter is set in query this option counted as ON, except if parameter is equal to NULL.


nodeidsarrayNode IDs
proxyidsarrayProxy IDs
editableintegeronly with read-write permission. Ignored for SuperAdmins
filterarrayOptional filter by proxy fields
searcharrayReturn proxies by any given proxy object field pattern
startSearchintegerSearch proxies field pattern only in start of the field
excludeSearchintegerExclude from result, proxies by given field pattern
searchWildcardsEnabledintegerSearch pattern in whole field using wildcards 1 - enable, 0 - disable
outputstringOutput options Values: shorten, refer, extend
select_hostsstringSelect hosts Values: shorten, refer, extend
countOutputintegerCount proxies, return the number of proxies found
preservekeysintegerReturn hash instead of array Keys of hash are object IDs
sortfieldstringSort by proxy field Values: hostid,host,status
sortorderstringSort order Values: ASC, DESC
limitintmax number of proxy objects to return


resultOperation successful. Result will contain array of Proxy objects.
errorIn case of any errors


Get proxys details by proxy name pattern “proxy”:

Retrieved proxy details:

	"host":"Linux Proxy",
	"host":"ZABBIX Proxy",
	"status": 6