[comment]: # aside: 1

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

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

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

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

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

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|hostid|ID|ID узла сети.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*<br>- *обязательно* для операций обновления|
|host|string|Техническое имя узла сети.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *обязательно* для операций создания|
|description|text|Описание узла сети.|
|flags|integer|[Origin](/manual/api/reference_commentary#entity-origin-flags) узла сети.<br><br>Possible values:<br>0 - a plain host;<br>4 - a host converted from prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|inventory\_mode|integer|Режим заполнения инвентаря узла сети.<br><br>Possible values:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.|
|ipmi\_authtype|integer|Алгоритм аутентификации IPMI.<br><br>Possible values:<br>-1 - *(default)* default;<br>0 - none;<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>Possible values:<br>1 - callback;<br>2 - *(default)* user;<br>3 - operator;<br>4 - admin;<br>5 - OEM.|
|ipmi\_username|string|Имя пользователя IPMI.|
|maintenance\_from|timestamp|Время начала текущего обслуживания.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|maintenance\_status|integer|Текущий статус обслуживания.<br><br>Possible values:<br>0 - *(default)* no maintenance;<br>1 - maintenance in effect.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|maintenance\_type|integer|Текущий тип обслуживания.<br><br>Possible values:<br>0 - *(default)* maintenance with data collection;<br>1 - maintenance without data collection.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|maintenanceid|ID|ID обслуживания, которое в данный момент действует для узла сети.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|name|string|Отображаемое имя узла сети.<br><br>Default: `host` property value.|
|monitored_by|integer|Источник, который используется для мониторинга узла сети.<br><br>Possible values:<br>0 - *(default)* Zabbix server;<br>1 - Proxy;<br>2 - Proxy group.|
|proxyid|ID|ID прокси, который используется для мониторинга узла сети.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *обязательно* если `monitored_by` set to "Proxy"|
|proxy_groupid|ID|ID группы прокси, которая используется для мониторинга узла сети.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *обязательно* если `monitored_by` set to "Proxy group"|
|status|integer|Статус и функция узла сети.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.|
|tls\_connect|integer|Подключения к узлу сети.<br><br>Possible values:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.|
|tls\_accept|integer|Подключения от узла сети.<br><br>Possible bitmap values:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.<br><br>This is a bitmask field; any sum of possible bitmap values is acceptable (for example, 6 for PSK and certificate).|
|tls\_issuer|string|Издатель сертификата.|
|tls\_subject|string|Тема сертификата.|
|tls\_psk\_identity|string|Идентификатор PSK; должен быть связан только с одним PSK (в [autoregistration](/manual/api/reference/autoregistration/object), [hosts](/manual/api/reference/host/object), and [proxies](/manual/api/reference/proxy/object)).<br><br>Не включайте конфиденциальную информацию в идентификатор PSK, так как он передается по сети без шифрования, чтобы получатель знал, какой PSK использовать.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *только для записи*<br>- *обязательно* если `tls_connect` 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>- *только для записи*<br>- *обязательно* если `tls_connect` set to "PSK", or `tls_accept` contains the "PSK" bit|
|active_available|integer|Статус доступности активного интерфейса узла сети.<br><br>Possible values:<br>0 - interface status is unknown;<br>1 - interface is available;<br>2 - interface is not available.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|assigned_proxyid|ID|ID прокси, назначенного сервером Zabbix, если узел сети мониторится группой прокси.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|

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

[comment]: # ({c7de69b4-859da78d})
### Инвентаризация узла сети

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

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

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

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

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

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

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

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