Documentation
Table of Contents
> Объект узла сети
Следующие объекты напрямую связаны с host API.
Узел сети
Объект узла сети имеет следующие свойства.
| Свойство | Тип | Описание |
|---|---|---|
| hostid | строка | (только для чтения) ID узла сети. |
| host (требуется) |
строка | Техническое имя узла сети. |
| description | текст | Описание узла сети. |
| flags | целое число | (только для чтения) Происхождение узла сети. Возможные значения: 0 - обычный узел сети; 4 - обнаруженный узел сети. |
| inventory_mode | целое число | Режим заполнения инвентарных данных узла сети. Возможные значения: -1 - (по умолчанию) отключено; 0 - вручную; 1 - автоматически. |
| ipmi_authtype | целое число | Алгоритм аутентификации IPMI. Возможные значения: -1 - (по умолчанию) по умолчанию; 0 - нет; 1 - MD2;<br >2 - MD5 4 - прямой; 5 - OEM; 6 - RMCP+. |
| ipmi_password | строка | Пароль IPMI. |
| ipmi_privilege | целое число | Уровень привилегий IPMI. Возможные значения: 1 – обратный вызов; 2 – (по умолчанию) пользователь; 3 – оператор; 4 - админ; 5 - ОЕМ. |
| ipmi_username | строка | Имя пользователя IPMI. |
| maintenance_from | метка времени | (только для чтения) Время начала эффективного обслуживания. |
| maintenance_status | целое число | (только для чтения) Текущий статус обслуживания. Возможные значения: 0 - (по умолчанию) без обслуживания; 1 - техническое обслуживание в силе. |
| maintenance_type | целое число | (только для чтения) Действующий тип обслуживания. Возможные значения: 0 - (по умолчанию) обслуживание со сбором данных; 1 - обслуживание без сбора данных . |
| maintenanceid | строка | (только для чтения) Идентификатор технического обслуживания, которое в данный момент действует на узле сети. |
| name | строка | Видимое имя узла сети. По умолчанию: значение свойства host. |
| proxy_hostid | строка | Идентификатор прокси-сервера, который используется для мониторинга узла сети. |
| status | целое число | Статус и функция узла сети. Возможные значения: 0 - (по умолчанию) узел сети, мониторинг которого ведется; 1 - узел сети, мониторинг которого не ведется. |
| tls_connect | целое число | Соединения с узлом сети. Возможные значения: 1 - (по умолчанию) Без шифрования; 2 - PSK; 4 - сертификат. |
| tls_accept | целое число | Соединения от узла сети. Возможные значения растрового изображения: 1 - (по умолчанию) Без шифрования; 2 - PSK; 4 - сертификат. |
| tls_issuer | строка | Эмитент сертификата. |
| tls_subject | строка | Тема сертификата. |
| tls_psk_identity | строка | (только для записи) Идентификатор PSK. Требуется, если в tls_connect или tls_accept включен PSK.Не добавляйте конфиденциальную информацию в идентификатор PSK, она передается по сети в незашифрованном виде, чтобы сообщить получателю, какой PSK использовать. |
| tls_psk | строка | (только для записи) Общий ключ, не менее 32 шестнадцатеричных цифр. Требуется, если для tls_connect или tls_accept включен PSK. |
Обратите внимание, что для некоторых методов (обновление, удаление) комбинация обязательных и необязательных параметров отличается.
Инвентаризация хоста
Объект инвентаризации хоста имеет следующие свойства.
Каждое свойство имеет свой уникальный идентификационный номер, который используется для связывания полей инвентаризации хоста с предметами.
| ID | Свойство | Тип | Описание |
|---|---|---|---|
| 4 | alias | string | Псевдоним. |
| 11 | asset_tag | string | Тег актива. |
| 28 | chassis | string | Шасси. |
| 23 | contact | string | Контактное лицо. |
| 32 | contract_number | string | Номер контракта. |
| 47 | date_hw_decomm | string | Дата вывода оборудования из эксплуатации. |
| 46 | date_hw_expiry | string | Дата окончания обслуживания оборудования. |
| 45 | date_hw_install | string | дата установки оборудования. |
| 44 | date_hw_purchase | string | дата покупки аппаратного обеспечения. |
| 34 | deployment_status | string | Статус развертывания. |
| 14 | hardware | string | Оборудование. |
| 15 | hardware_full | string | Подробное оборудование. |
| 39 | host_netmask | string | Маска подсети хоста. |
| 38 | host_networks | string | Хост-сети. |
| 40 | host_router | string | Главный маршрутизатор. |
| 30 | hw_arch | string | аппаратная архитектура. |
| 33 | installer_name | string | Имя установщика. |
| 24 | location | string | Местоположение. |
| 25 | location_lat | string | Широта местоположения. |
| 26 | location_lon | string | Долгота местоположения. |
| 12 | macaddress_a | string | MAC-адрес A. |
| 13 | macaddress_b | string | MAC-адрес B. |
| 29 | model | string | Модель. |
| 3 | name | string | Имя. |
| 27 | notes | string | Примечания. |
| 41 | oob_ip | string | IP-адрес OOB. |
| 42 | oob_netmask | string | Маска подсети хоста OOB. |
| 43 | oob_router | string | маршрутизатор OOB. |
| 5 | os | string | Имя ОС. |
| 6 | os_full | string | Подробное имя ОС. |
| 7 | os_short | string | Краткое имя ОС. |
| 61 | poc_1_cell | string | Основной номер мобильного телефона POC. |
| 58 | poc_1_email | string | Основной адрес электронной почты. |
| 57 | poc_1_name | string | Имя основного POC. |
| 63 | poc_1_notes | string | Основные примечания POC. |
| 59 | poc_1_phone_a | string | Основной телефон POC A. |
| 60 | poc_1_phone_b | string | Основной телефон POC B. |
| 62 | poc_1_screen | string | Первичное отображаемое имя POC. |
| 68 | poc_2_cell | string | Дополнительный номер мобильного телефона POC. |
| 65 | poc_2_email | string | Дополнительный электронный адрес POC. |
| 64 | poc_2_name | string | Дополнительное имя POC. |
| 70 | poc_2_notes | string | Вторичные примечания POC. |
| 66 | poc_2_phone_a | string | Дополнительный телефон POC A. |
| 67 | poc_2_phone_b | string | Дополнительный телефон POC B. |
| 69 | poc_2_screen | string | Дополнительное экранное имя POC. |
| 8 | serialno_a | string | Серийный номер A. |
| 9 | serialno_b | string | Серийный номер B. |
| 48 | site_address_a | string | Адрес сайта A. |
| 49 | site_address_b | string | Адрес сайта B. |
| 50 | site_address_c | string | Адрес сайта C. |
| 51 | site_city | string | Город сайта. |
| 53 | site_country | string | Страна сайта. |
| 56 | site_notes | string | Заметки сайта. |
| 55 | site_rack | string | Расположение стойки сайта. |
| 52 | site_state | string | Состояние сайта. |
| 54 | site_zip | string | ZIP/почтовый индекс сайта. |
| 16 | software | string | Программное обеспечение. |
| 18 | software_app_a | string | Программное приложение A. |
| 19 | software_app_b | string | Программное приложение B. |
| 20 | software_app_c | string | Программное приложение C. |
| 21 | software_app_d | string | Программное приложение D. |
| 22 | software_app_e | string | Программное приложение E. |
| 17 | software_full | string | Сведения о программном обеспечении. |
| 10 | tag | string | тег. |
| 1 | type | string | Тип. |
| 2 | type_full | string | Сведения о типе. |
| 35 | url_a | string | URL A. |
| 36 | url_b | string | URL B. |
| 37 | url_c | string | URL C. |
| 31 | vendor | string | Поставщик. |
Тег узла сети
Объект тега узла сети имеет следующие свойства.
| Свойство | Тип | Описание |
|---|---|---|
| tag (обязательно) |
строка | Имя тега узла сети. |
| value | строка | Значение тега узла сети. |