Documentation
Table of Contents
Объект узла сети
Следующие объекты напрямую связаны с API host.
Хозяин
Хост-объект имеет следующие свойства.
| Свойство | Тип | Описание |
|---|---|---|
| hostid | string | (только для чтения) ID хоста. |
| хост (обязательно) | строка | Техническое имя хоста. |
| описание | text | Описание хоста. |
| flags | integer | (только для чтения) Происхождение хоста. Возможные значения: 0 - обычный хост; 4 - обнаруженный хост. |
| inventory_mode | integer | Режим заполнения инвентаря хоста. Возможные значения: -1 — (по умолчанию) отключено; 0 — вручную; 1 — автоматически. |
| ipmi_authtype | integer | Алгоритм аутентификации IPMI. Возможные значения: -1 - (по умолчанию) по умолчанию; 0 - нет; 1 - MD2;<br >2 - MD5 4 - прямой; 5 - OEM; 6 - RMCP+. |
| ipmi_password | string | Пароль IPMI. |
| ipmi_привилегия | integer | Уровень привилегий IPMI. Возможные значения: 1 – обратный вызов; 2 – (по умолчанию) пользователь; 3 – оператор; 4 - админ; 5 - ОЕМ. |
| ipmi_username | string | Имя пользователя IPMI. |
| maintenance_from | timestamp | (только для чтения) Время начала эффективного обслуживания. |
| maintenance_status | integer | (только для чтения) Текущий статус обслуживания. Возможные значения: 0 - (по умолчанию) без обслуживания; 1 - техническое обслуживание в силе. |
| maintenance_type | integer | (только для чтения) Действующий тип обслуживания. Возможные значения: 0 - (по умолчанию) обслуживание со сбором данных; 1 - обслуживание без сбора данных . |
| maintenanceid | string | (только для чтения) Идентификатор технического обслуживания, которое в данный момент действует на хосте. |
| name | string | Отображаемое имя хоста. По умолчанию: значение свойства host. |
| proxy_hostid | string | Идентификатор прокси-сервера, который используется для мониторинга хоста. |
| status | integer | Статус и функция хоста. Возможные значения: 0 - (по умолчанию) контролируемый хост; 1 - неконтролируемый хост. |
| tls_connect | integer | Соединения с хостом. Возможные значения: 1 - (по умолчанию) Без шифрования; 2 - PSK; 4 - сертификат. |
| tls_accept | integer | Соединения с хоста. Возможные значения растрового изображения: 1 - (по умолчанию) Без шифрования; 2 - PSK; 4 - сертификат. |
| tls_issuer | string | Эмитент сертификата. |
| tls_subject | string | Тема сертификата. |
| tls_psk_identity | string | (только для записи) Идентификатор PSK. Требуется, если в tls_connect или tls_accept включен PSK.Не добавляйте конфиденциальную информацию в идентификатор PSK, она передается по сети в незашифрованном виде, чтобы сообщить получателю, какой PSK использовать. |
| tls_psk | string | (только для записи) Общий ключ, не менее 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 | строка | Значение тега узла сети. |
| automatic | целое число | Тип тега узла сети. Возможные значения: 0 - (по умолчанию) вручную (тег создается пользователем); 1 - автоматически (тег создается при низкоуровневом обнаружении) |