Table of Contents
> Proxy object
The following objects are directly related to the proxy API.
Proxy
The proxy object has the following properties.
| Property | Type | Description |
|---|---|---|
| proxyid | string | (readonly) ID of the proxy. |
| host (required) |
string | Name of the proxy. |
| status (required) |
integer | Type of proxy. Possible values: 5 - active proxy; 6 - passive proxy. |
| description | text | Description of the proxy. |
| lastaccess | timestamp | (readonly) Time when the proxy last connected to the server. |
| tls_connect | integer | Connections to host. Possible values are: 1 - (default) No encryption; 2 - PSK; 4 - certificate. |
| tls_accept | integer | Connections from host. Possible bitmap values are: 1 - (default) No encryption; 2 - PSK; 4 - certificate. This is a bitmask field; any sum of possible bitmap values is acceptable (for example, 6 for PSK and certificate). |
| tls_issuer | string | Certificate issuer. |
| tls_subject | string | Certificate subject. |
| tls_psk_identity | string | (write-only) PSK identity; must be paired with only one PSK (across autoregistration, hosts, and proxies). Required if either tls_connect or tls_accept has PSK enabled.Do not include sensitive information in the PSK identity, as it is sent unencrypted over the network to inform the receiver which PSK to use. |
| tls_psk | string | (write-only) Pre-shared key (PSK); must be at least 32 hex digits. Required if either tls_connect or tls_accept has PSK enabled. |
| proxy_address | string | Comma-delimited IP addresses or DNS names of active Zabbix proxy. |
| auto_compress | integer | (readonly) Indicates if communication between Zabbix server and proxy is compressed. Possible values are: 0 - No compression; 1 - Compression enabled; |
Note that for some methods (update, delete) the required/optional parameter combination is different.
Proxy interface
The proxy interface object defines the interface used to connect to a passive proxy. It has the following properties.
| Property | Type | Description |
|---|---|---|
| dns (required) |
string | DNS name to connect to. Can be empty if connections are made via IP address. |
| ip (required) |
string | IP address to connect to. Can be empty if connections are made via DNS names. |
| port (required) |
string | Port number to connect to. |
| useip (required) |
integer | Whether the connection should be made via IP address. Possible values are: 0 - connect using DNS name; 1 - connect using IP address. |