[comment]: # aside: 1

[comment]: # ({70b8d6b4-b7ea8d04})
# Объект узла сети

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

[comment]: # ({/70b8d6b4-b7ea8d04})

[comment]: # ({7d75bf76-2f6c5c76})
### Узел сети

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

|Свойство|[Type](/manual/api/reference_commentary#data-types)|Описание|
|--|--|------|
|hostid|ID|ID узла сети.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*<br>- *обязательно* для операций обновления|
|host|string|Техническое имя узла сети.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно* для операций создания|
|description|text|Описание узла сети.|
|flags|integer|[Происхождение](/manual/api/reference_commentary#entity-origin-flags) узла сети.<br><br>Возможные значения:<br>0 - обычный узел сети;<br>4 - узел сети, преобразованный из прототипа.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|inventory\_mode|integer|Режим заполнения инвентарных данных узла сети.<br><br>Возможные значения:<br>-1 - *(по умолчанию)* отключено;<br>0 - вручную;<br>1 - автоматически.|
|ipmi\_authtype|integer|Алгоритм аутентификации IPMI.<br><br>Возможные значения:<br>-1 - *(по умолчанию)* по умолчанию;<br>0 - отсутствует;<br>1 - MD2;<br>2 - MD5<br>4 - straight;<br>5 - OEM;<br>6 - RMCP+.|
|ipmi\_password|string|Пароль IPMI.|
|ipmi\_privilege|integer|Уровень привилегий IPMI.<br><br>Возможные значения:<br>1 - callback;<br>2 - *(по умолчанию)* пользователь;<br>3 - оператор;<br>4 - администратор;<br>5 - OEM.|
|ipmi\_username|string|Имя пользователя IPMI.|
|maintenance\_from|timestamp|Время начала действующего обслуживания.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|maintenance\_status|integer|Статус действующего обслуживания.<br><br>Возможные значения:<br>0 - *(по умолчанию)* обслуживание отсутствует;<br>1 - обслуживание активно.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|maintenance\_type|integer|Тип действующего обслуживания.<br><br>Возможные значения:<br>0 - *(по умолчанию)* обслуживание со сбором данных;<br>1 - обслуживание без сбора данных.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|maintenanceid|ID|ID обслуживания, которое в данный момент действует для узла сети.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|name|string|Отображаемое имя узла сети.<br><br>По умолчанию: значение свойства `host`.|
|monitored_by|integer|Источник, используемый для мониторинга узла сети.<br><br>Возможные значения:<br>0 - *(по умолчанию)* сервер Zabbix;<br>1 - Прокси;<br>2 - Группа прокси.|
|proxyid|ID|ID прокси, который используется для мониторинга узла сети.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно*, если `monitored_by` установлено в "Proxy"|
|proxy_groupid|ID|ID группы прокси, которая используется для мониторинга узла сети.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно*, если `monitored_by` установлено в "Proxy group"|
|status|integer|Статус и функция узла сети.<br><br>Возможные значения:<br>0 - *(по умолчанию)* включен;<br>1 - отключен.|
|tls\_connect|integer|Подключения к узлу сети.<br><br>Возможные значения:<br>1 - *(по умолчанию)* Без шифрования;<br>2 - PSK;<br>4 - сертификат.|
|tls\_accept|integer|Подключения от узла сети.<br><br>Возможные значения битовой маски:<br>1 - *(по умолчанию)* Без шифрования;<br>2 - PSK;<br>4 - сертификат.<br><br>Это поле битовой маски; допустима любая сумма возможных значений битовой маски (например, 6 для PSK и сертификата).|
|tls\_issuer|string|Издатель сертификата.|
|tls\_subject|string|Субъект сертификата.|
|tls\_psk\_identity|string|Идентификатор PSK; должен быть связан только с одним PSK (среди [autoregistration](/manual/api/reference/autoregistration/object), [hosts](/manual/api/reference/host/object) и [proxies](/manual/api/reference/proxy/object)).<br><br>Не включайте конфиденциальную информацию в идентификатор PSK, так как он передается по сети в незашифрованном виде, чтобы сообщить получателю, какой PSK использовать.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для записи*<br>- *обязательно*, если `tls_connect` установлено в "PSK" или `tls_accept` содержит бит "PSK"|
|tls\_psk|string|Предварительно общий ключ (PSK); должен содержать не менее 32 шестнадцатеричных цифр.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для записи*<br>- *обязательно*, если `tls_connect` установлено в "PSK" или `tls_accept` содержит бит "PSK"|
|active_available|integer|Статус доступности активного интерфейса узла сети.<br><br>Возможные значения:<br>0 - статус интерфейса неизвестен;<br>1 - интерфейс доступен;<br>2 - интерфейс недоступен.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|assigned_proxyid|ID|ID прокси, назначенного сервером Zabbix, если узел сети мониторится группой прокси.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|

[comment]: # ({/7d75bf76-2f6c5c76})

[comment]: # ({53fce8b7-859da78d})
### Инвентарные данные узла сети

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

::: notetip
Каждое свойство имеет собственный уникальный идентификационный номер, который используется для связывания полей инвентарных данных узла сети с элементами данных.
:::

|ID|Свойство|[Type](/manual/api/reference_commentary#data-types)|Описание|Максимальная длина|
|-|--|-|-----|-----|
|4|alias|string|Псевдоним.|128 символов|
|11|asset\_tag|string|Инвентарный номер.|64 символа|
|28|chassis|string|Шасси.|64 символа|
|23|contact|string|Контактное лицо.|65535 символов для SQL-баз данных|
|32|contract\_number|string|Номер контракта.|64 символа|
|47|date\_hw\_decomm|string|Дата вывода оборудования из эксплуатации.|64 символа|
|46|date\_hw\_expiry|string|Дата окончания обслуживания оборудования.|64 символа|
|45|date\_hw\_install|string|Дата установки оборудования.|64 символа|
|44|date\_hw\_purchase|string|Дата покупки оборудования.|64 символа|
|34|deployment\_status|string|Статус развертывания.|64 символа|
|14|hardware|string|Оборудование.|255 символов|
|15|hardware\_full|string|Подробные сведения об оборудовании.|65535 символов для SQL-баз данных|
|39|host\_netmask|string|Маска подсети узла сети.|39 символов|
|38|host\_networks|string|Сети узла сети.|65535 символов для SQL-баз данных|
|40|host\_router|string|Маршрутизатор узла сети.|39 символов|
|30|hw\_arch|string|Архитектура оборудования.|32 символа|
|33|installer\_name|string|Имя установщика.|64 символа|
|24|location|string|Местоположение.|65535 символов для SQL-баз данных|
|25|location\_lat|string|Широта местоположения.|16 символов|
|26|location\_lon|string|Долгота местоположения.|16 символов|
|12|macaddress\_a|string|MAC-адрес A.|64 символа|
|13|macaddress\_b|string|MAC-адрес B.|64 символа|
|29|model|string|Модель.|64 символа|
|3|name|string|Имя.|128 символов|
|27|notes|string|Примечания.|65535 символов для SQL-баз данных|
|41|oob\_ip|string|IP-адрес OOB.|39 символов|
|42|oob\_netmask|string|Маска подсети OOB узла сети.|39 символов|
|43|oob\_router|string|Маршрутизатор OOB.|39 символов|
|5|os|string|Имя ОС.|128 символов|
|6|os\_full|string|Полное имя ОС.|255 символов|
|7|os\_short|string|Краткое имя ОС.|128 символов|
|61|poc\_1\_cell|string|Мобильный номер основного контактного лица.|64 символа|
|58|poc\_1\_email|string|Основной email.|128 символов|
|57|poc\_1\_name|string|Имя основного контактного лица.|128 символов|
|63|poc\_1\_notes|string|Примечания по основному контактному лицу.|65535 символов для SQL-баз данных|
|59|poc\_1\_phone\_a|string|Телефон A основного контактного лица.|64 символа|
|60|poc\_1\_phone\_b|string|Телефон B основного контактного лица.|64 символа|
|62|poc\_1\_screen|string|Экранное имя основного контактного лица.|64 символа|
|68|poc\_2\_cell|string|Мобильный номер дополнительного контактного лица.|64 символа|
|65|poc\_2\_email|string|Дополнительный email.|128 символов|
|64|poc\_2\_name|string|Имя дополнительного контактного лица.|128 символов|
|70|poc\_2\_notes|string|Примечания по дополнительному контактному лицу.|65535 символов для SQL-баз данных|
|66|poc\_2\_phone\_a|string|Телефон A дополнительного контактного лица.|64 символа|
|67|poc\_2\_phone\_b|string|Телефон B дополнительного контактного лица.|64 символа|
|69|poc\_2\_screen|string|Экранное имя дополнительного контактного лица.|64 символа|
|8|serialno\_a|string|Серийный номер A.|64 символа|
|9|serialno\_b|string|Серийный номер B.|64 символа|
|48|site\_address\_a|string|Адрес площадки A.|128 символов|
|49|site\_address\_b|string|Адрес площадки B.|128 символов|
|50|site\_address\_c|string|Адрес площадки C.|128 символов|
|51|site\_city|string|Город площадки.|128 символов|
|53|site\_country|string|Страна площадки.|64 символа|
|56|site\_notes|string|Примечания по площадке.|65535 символов для SQL-баз данных|
|55|site\_rack|string|Расположение стойки на площадке.|128 символов|
|52|site\_state|string|Регион/область площадки.|64 символа|
|54|site\_zip|string|ZIP/почтовый индекс площадки.|64 символа|
|16|software|string|Программное обеспечение.|255 символов|
|18|software\_app\_a|string|Программное приложение A.|64 символа|
|19|software\_app\_b|string|Программное приложение B.|64 символа|
|20|software\_app\_c|string|Программное приложение C.|64 символа|
|21|software\_app\_d|string|Программное приложение D.|64 символа|
|22|software\_app\_e|string|Программное приложение E.|64 символа|
|17|software\_full|string|Сведения о программном обеспечении.|65535 символов для SQL-баз данных|
|10|tag|string|Тег.|64 символа|
|1|type|string|Тип.|64 символа|
|2|type\_full|string|Сведения о типе.|64 символа|
|35|url\_a|string|URL A.|2048 символов|
|36|url\_b|string|URL B.|2048 символов|
|37|url\_c|string|URL C.|2048 символов|
|31|vendor|string|Поставщик.|64 символа|

[comment]: # ({/53fce8b7-859da78d})

[comment]: # ({c531ae6d-0ae1807e})
### Тег узла сети

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

|Свойство|[Type](/manual/api/reference_commentary#data-types)|Описание|
|--|--|------|
|tag|string|Имя тега узла сети.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно*|
|value|string|Значение тега узла сети.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*.|
|automatic|integer|Тип тега узла сети.<br><br>Возможные значения:<br>0 - *(по умолчанию)* вручную (тег создан пользователем);<br>1 - автоматически (тег создан обнаружением низкого уровня)<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|object|integer|Тип объекта, от которого был унаследован тег.<br><br>Возможные значения:<br>0 - шаблон. <br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*.|
|objectid|ID|ID объекта, от которого был унаследован тег.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*.|

[comment]: # ({/c531ae6d-0ae1807e})