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

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

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

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

Property Type Description
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 Универсальный уникальный идентификатор, используемый для связывания импортированных прототипов узлов сети с уже существующими. Если не указан, генерируется автоматически.

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

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

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

Property Type Description
groupid ID ID группы узлов сети.

Поведение свойства:
- required

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

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

Property Type Description
group_prototypeid ID ID прототипа группы.

Property behavior:
- read-only
name string Имя прототипа группы.

Property behavior:
- required for create operations

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

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

Property Type Description
tag string Имя тега прототипа узла сети.

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

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

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

Property Type Description
type integer Тип интерфейса.

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

Поведение свойства:
- required
useip integer Следует ли выполнять подключение через IP.

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

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

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

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

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

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

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

Поведение свойства:
- required if type is set to "SNMP"

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

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

Property Type Description
version integer Версия интерфейса SNMP.

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

Поведение свойства:
- required
bulk integer Использовать ли массовые запросы SNMP.

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

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

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

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

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

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

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

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

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

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

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

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

Поведение свойства:
- supported если version установлено в "SNMPv3"