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

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

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

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

Property Type Description
hostid ID ID прототипа узла сети.

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

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

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

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

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

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

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

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

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

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

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

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

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

Связь группы

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

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

Property behavior:
- 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 Имя тега прототипа узла сети.

Property behavior:
- required
value string Значение тега прототипа узла сети.

Property behavior:
- read-only.
object integer Тип объекта, от которого был унаследован тег.

Possible values:
0 - шаблон.

Property behavior:
- read-only.
objectid ID ID объекта, от которого был унаследован тег.

Property behavior:
- read-only.

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

Пользовательские интерфейсы поддерживаются, если 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"

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

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

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

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

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

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

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

Возможные значения: 1–2147483647 (INT32_MAX).
Значение по умолчанию: 10.
retries string Максимальное количество повторных попыток, если время ожидания запроса истекло.
Используется для элементов данных walk[] и get[]. Для walk[] повторные попытки распространяются на весь обход.
Поддерживаются макросы LLD и пользовательские макросы.

Возможные значения: 0–100 (0 - отключить повторные попытки).
Значение по умолчанию: 5.
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"