[comment]: # aside: 1

[comment]: # ({7bc64dbb-7b0425dd})
# Объект proxy

Следующие объекты напрямую связаны с API `proxy`.

[comment]: # ({/7bc64dbb-7b0425dd})

[comment]: # ({2cce40bc-52ccb0be})
### Прокси

Объект прокси имеет следующие свойства.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|proxyid|ID|ID прокси.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations|
|name|string|Имя прокси.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations|
|proxy_groupid|ID|ID группы прокси.<br><br>0 - прокси не назначен ни одной группе прокси.|
|local_address|string|Адрес для активных агентов. IP-адрес или DNS-имя для подключения.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `proxy_groupid` is not `0`|
|local_port|string|Номер локального порта прокси для подключения.<br><br>Поддерживаются пользовательские макросы.<br><br>По умолчанию: 10051.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `proxy_groupid` is not `0`|
|operating_mode|integer|Тип прокси.<br><br>Возможные значения:<br>0 - активный прокси;<br>1 - пассивный прокси.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations|
|description|text|Описание прокси.|
|lastaccess|timestamp|Время, когда прокси в последний раз подключался к серверу.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|address|string|IP-адрес или DNS-имя для подключения.<br><br>Поддерживаются пользовательские макросы.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if the Zabbix proxy operating mode is passive|
|port|string|Номер порта для подключения.<br><br>Поддерживаются пользовательские макросы.<br><br>По умолчанию: 10051.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if the Zabbix proxy operating mode is passive|
|allowed_addresses|string|IP-адреса или DNS-имена активного прокси Zabbix, разделенные запятыми.|
|tls\_connect|integer|Подключения к прокси.<br><br>Возможные значения:<br>1 - *(default)* Без шифрования;<br>2 - PSK;<br>4 - сертификат.|
|tls\_accept|integer|Подключения от прокси.<br><br>Возможные значения битовой маски:<br>1 - *(default)* Без шифрования;<br>2 - PSK;<br>4 - сертификат.<br><br>Это поле является битовой маской; допустима любая сумма возможных значений битовой маски (например, 6 для PSK и сертификата).|
|tls\_issuer|string|Издатель сертификата.|
|tls\_subject|string|Тема сертификата.|
|tls\_psk\_identity|string|Идентификатор PSK; должен быть связан только с одним PSK (среди [авторегистрации](/manual/api/reference/autoregistration/object), [узлов сети](/manual/api/reference/host/object) и [прокси](/manual/api/reference/proxy/object)).<br><br>Не включайте конфиденциальную информацию в идентификатор PSK, так как он передается по сети без шифрования, чтобы получатель знал, какой PSK использовать.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only*<br>- *required* if `tls_connect` is set to "PSK", or `tls_accept` contains the "PSK" bit|
|tls\_psk|string|Предварительно общий ключ (PSK); должен содержать не менее 32 шестнадцатеричных цифр.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only*<br>- *required* if `tls_connect` is set to "PSK", or `tls_accept` contains the "PSK" bit|
|custom\_timeouts|integer|Следует ли переопределять глобальные тайм-ауты элементов данных на уровне прокси.<br><br>Возможные значения:<br>0 - *(default)* использовать глобальные настройки;<br>1 - переопределить тайм-ауты.|
|timeout\_zabbix\_agent|string|Тратить на обработку не более `timeout_*` секунд.<br>Принимает секунды или единицу времени с суффиксом (например, 30s, 1m). Также принимает пользовательские макросы.<br><br>Диапазон возможных значений: 1-600s.<br><br>По умолчанию: "".<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `custom_timeouts` is set to `1`.|
|timeout\_simple\_check|^|^|
|timeout\_snmp\_agent|^|^|
|timeout\_external\_check|^|^|
|timeout\_db\_monitor|^|^|
|timeout\_http\_agent|^|^|
|timeout\_ssh\_agent|^|^|
|timeout\_telnet\_agent|^|^|
|timeout\_script|^|^|
|timeout\_browser|^|^|
|version|integer|Версия прокси.<br><br>Трехкомпонентный номер версии Zabbix, где для каждой части используются две десятичные цифры, например 60401 для версии 6.4.1, 70002 для версии 7.0.2 и т. д.<br>0 - неизвестная версия прокси.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|compatibility|integer|Версия прокси по сравнению с версией сервера Zabbix.<br><br>Возможные значения:<br>0 - не определено;<br>1 - текущая версия (у прокси и сервера совпадает основная версия);<br>2 - устаревшая версия (версия прокси старше версии сервера, но частично поддерживается);<br>3 - неподдерживаемая версия (версия прокси старше версии предыдущего LTS-релиза сервера или основная версия сервера старше основной версии прокси).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|state|integer|Состояние прокси.<br><br>Возможные значения:<br>0 - неизвестно;<br>1 - не в сети;<br>2 - в сети.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|

[comment]: # ({/2cce40bc-52ccb0be})