Объект прототипа узла сети

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

Прототип узла сети

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

Свойство Тип Описание
hostid ID ID прототипа узла сети.

Поведение свойства:
- только для чтения
- обязательно для операций обновления
host string Техническое имя прототипа узла сети.

Поведение свойства:
- обязательно для операций создания
- только для чтения для унаследованных объектов
name string Видимое имя прототипа узла сети.

По умолчанию: значение свойства host.

Поведение свойства:
- только для чтения для унаследованных объектов
status integer Состояние прототипа узла сети.

Возможные значения:
0 - (по умолчанию) отслеживаемый узел сети;
1 - неотслеживаемый узел сети.
flags integer Происхождение прототипа узла сети.

Возможные значения:
2 - прототип узла сети;
6 - обнаруженный прототип узла сети

Поведение свойства:
- только для чтения
inventory_mode integer Режим заполнения инвентарных данных узла сети.

Возможные значения:
-1 - (по умолчанию) отключено;
0 - вручную;
1 - автоматически.
templateid ID ID родительского прототипа узла сети шаблона.

Поведение свойства:
- только для чтения
discover integer Состояние обнаружения прототипа узла сети.

Возможные значения:
0 - (по умолчанию) новые узлы сети будут обнаруживаться;
1 - новые узлы сети не будут обнаруживаться, а существующие узлы сети будут помечены как потерянные.
custom_interfaces integer Источник пользовательских интерфейсов для узлов сети, созданных прототипом узла сети.

Возможные значения:
0 - (по умолчанию) наследовать интерфейсы от родительского узла сети;
1 - использовать пользовательские интерфейсы прототипов узлов сети.

Поведение свойства:
- только для чтения для унаследованных объектов
uuid string Универсальный уникальный идентификатор, используемый для связывания импортированных прототипов узлов сети с уже существующими. Генерируется автоматически, если не указан.

Поведение свойства:
- поддерживается, если прототип узла сети принадлежит шаблону

Связь с группой

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

Свойство Тип Описание
groupid ID ID группы узлов сети.

Поведение свойства:
- обязательно

Прототип группы

Объект прототипа группы определяет группу, которая будет создана для обнаруженного узла сети. Он имеет следующие свойства.

Свойство Type Описание
group_prototypeid ID ID прототипа группы.

Property behavior:
- только для чтения
name string Имя прототипа группы.

Property behavior:
- обязательно для операций создания

Тег прототипа узла сети

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

Свойство Type Описание
tag string Имя тега прототипа узла сети.

Поведение свойства:
- обязательно
value string Значение тега прототипа узла сети.

Поведение свойства:
- только для чтения.
object integer Тип объекта, от которого был унаследован тег.

Возможные значения:
0 - шаблон.

Поведение свойства:
- только для чтения.
objectid ID ID объекта, от которого был унаследован тег.

Поведение свойства:
- только для чтения.

Пользовательский интерфейс

Пользовательские интерфейсы поддерживаются, если custom_interfaces объекта Host prototype object установлено в значение "use host prototypes custom interfaces". Объект пользовательского интерфейса имеет следующие свойства.

Свойство Type Описание
type integer Тип интерфейса.

Возможные значения:
1 - Агент;
2 - SNMP;
3 - IPMI;
4 - JMX.

Property behavior:
- required
useip integer Следует ли выполнять подключение по IP.

Возможные значения:
0 - подключаться, используя DNS-имя узла сети;
1 - подключаться, используя IP-адрес узла сети.

Property behavior:
- required
ip string IP-адрес, используемый интерфейсом.
Может содержать макросы.

Property behavior:
- required если useip установлено в значение "connect using host IP address"
dns string DNS-имя, используемое интерфейсом.
Может содержать макросы.

Property behavior:
- required если useip установлено в значение "connect using host DNS name"
port string Номер порта, используемый интерфейсом.
Может содержать пользовательские макросы и макросы LLD.

Property behavior:
- required
main integer Используется ли интерфейс как интерфейс по умолчанию на узле сети.
Только один интерфейс определенного типа может быть установлен как интерфейс по умолчанию на узле сети.

Возможные значения:
0 - не по умолчанию;
1 - по умолчанию.

Property behavior:
- required
details object Дополнительный объект для сведений о пользовательском интерфейсе.

Property behavior:
- required если type установлено в значение "SNMP"

Сведения о пользовательском интерфейсе

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

Свойство Тип Описание
version integer Версия интерфейса SNMP.

Возможные значения:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3.

Поведение свойства:
- обязательно
bulk integer Следует ли использовать bulk-запросы SNMP.

Возможные значения:
0 - не использовать bulk-запросы;
1 - (по умолчанию) - использовать bulk-запросы.
community string Сообщество SNMP.

Поведение свойства:
- обязательно, если version установлено в "SNMPv1" или "SNMPv2c"
max_repetitions integer Максимальное значение повторений для собственных SNMP bulk-запросов (GetBulkRequest-PDUs).
Используется только для элементов данных discovery[] и walk[] в SNMPv2 и v3.

По умолчанию: 10.
securityname string Имя безопасности SNMPv3.

Поведение свойства:
- поддерживается, если version установлено в "SNMPv3"
securitylevel integer Уровень безопасности SNMPv3.

Возможные значения:
0 - (по умолчанию) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.

Поведение свойства:
- поддерживается, если version установлено в "SNMPv3"
authpassphrase string Парольная фраза аутентификации SNMPv3.

Поведение свойства:
- поддерживается, если version установлено в "SNMPv3" и securitylevel установлено в "authNoPriv" или "authPriv"
privpassphrase string Парольная фраза приватности SNMPv3.

Поведение свойства:
- поддерживается, если version установлено в "SNMPv3" и securitylevel установлено в "authPriv"
authprotocol integer Протокол аутентификации SNMPv3.

Возможные значения:
0 - (по умолчанию) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.

Поведение свойства:
- поддерживается, если version установлено в "SNMPv3" и securitylevel установлено в "authNoPriv" или "authPriv"
privprotocol integer Протокол приватности SNMPv3. Используется только интерфейсами SNMPv3.

Возможные значения:
0 - (по умолчанию) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.

Поведение свойства:
- поддерживается, если version установлено в "SNMPv3" и securitylevel установлено в "authPriv"
contextname string Имя контекста SNMPv3.

Поведение свойства:
- поддерживается, если version установлено в "SNMPv3"