> Obiekt Host prototype

Poniższe obiekty są bezpośrednio związane z interfejsem API hostprototype.

Host prototype

Obiekt Host prototype ma następujące właściwości.

Właściwość Typ Opis
hostid string (tylko do odczytu) ID prototypu hosta.
host
(wymagane)
string Nazwa techniczna prototypu hosta.
name string Widoczna nazwa prototypu hosta.

Domyślnie: wartość właściwości host.
status integer Status prototypu hosta.

Możliwe wartości:
0 - (domyślne) monitorowany host;
1 - nemonitorowany host.
inventory_mode integer Tryb uzupełniania inwentarza hosta.

Możliwe wartości:
-1 - (domyślne) wyłączony;
0 - ręczny;
1 - automatyczny.
templateid string (tylko do odczytu) ID nadrzędnego szablonu prototypu hosta.
discover integer Status wykrywania prototypu hosta.

Możliwe wartości:
0 - (domyślne) nowe hosty zostaną wykryte;
1 - nowe hosty nie zostaną wykryte, a istniejące zostaną oznaczone jako utracone.
custom_interfaces integer Źródło interfejsów dla hostów utworzonych przez prototyp hosta.

Możliwe wartości:
0 - (domyślne) dziedzicz interfejsy od hosta nadrzędnego;
1 - użyj indywidualnych interfejsów prototypów hostów.
uuid string Uniwersalny identyfikator, używany do łączenia importowanych prototypów hostów z już istniejącymi. Używany tylko dla prototypów hostów na szablonach. Automatycznie generowany, jeśli nie jest podany.

Należy zauważyć, że dla niektórych metod (aktualizacja, usuwanie) kombinacja wymaganych/opcjonalnych parametrów jest inna.

Obiekt Group link łączy prototyp hosta z grupą hostów i ma następujące właściwości.

Właściwość Typ Opis
groupid
(wymagane)
string ID grupy hostów.

Group prototype

Obiekt Group prototype definiuje grupę, która zostanie utworzona dla wykrytego hosta i ma następujące właściwości.

Właściwość Typ Opis
name
(wymagane)
string Nazwa prototypu grupy.

Host prototype tag

Obiekt Host prototype tag ma następujące właściwości.

Właściwość Typ Opis
tag
(wymagane)
string Nazwa znacznika prototypu hosta.
value string Wartość znacznika prototypu hosta.

Custom interface

Obiekt Custom interface posiada następujące właściwości.

Właściwość Typ Opis
dns string Nazwa DNS używana przez interfejs.

Wymagane, jeśli połączenie jest realizowane za pośrednictwem DNS. Może zawierać makra.
ip string Adres IP używany przez interfejs.

Wymagane, jeśli połączenie jest realizowane za pośrednictwem IP. Może zawierać makra.
main
(wymagane)
integer Czy interfejs jest używany jako domyślny na hoście. Tylko jeden interfejs danego typu może być ustawiony jako domyślny na hoście.

Możliwe wartości:
0 - nie domyślny;
1 - domyślny.
port
(wymagane)
string Numer portu używany przez interfejs. Może zawierać makra użytkownika i makra LLD.
type
(wymagane)
integer Typ interfejsu.

Możliwe wartości:
1 - agent;
2 - SNMP;
3 - IPMI;
4 - JMX.
useip
(wymagane)
integer Czy połączenie powinno być realizowane za pośrednictwem IP.

Możliwe wartości:
0 - połącz za pomocą nazwy DNS hosta;
1 - połącz za pomocą adresu IP hosta dla tego interfejsu hosta.
details array Dodatkowy obiekt dla interfejsu. Wymagane, jeśli typ interfejsu to SNMP.

Custom interface details

Obiekt szczegółów posiada następujące właściwości.

Właściwość Typ Opis
version
(wymagane)
integer Wersja interfejsu SNMP.

Możliwe wartości to:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3
bulk integer Czy używać łączonych żądań SNMP.

Możliwe wartości to:
0 - nie używaj żądań łączonych;
1 - (domyślnie) - użyj żądań łączonych.
community string Hasło SNMP (wymagane). Używane tylko przez interfejsy SNMPv1 i SNMPv2.
securityname string Nazwa ochrony SNMPv3. Używane tylko przez interfejsy SNMPv3.
securitylevel integer Poziom zabezpieczeń SNMPv3. Używane tylko przez interfejsy SNMPv3.

Możliwe wartości to:
0 - (domyślnie) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.
authpassphrase string Hasło uwierzytelniania SNMPv3. Używane tylko przez interfejsy SNMPv3.
privpassphrase string Hasło prywatności SNMPv3. Używane tylko przez interfejsy SNMPv3.
authprotocol integer Protokół uwierzytelniania SNMPv3. Używane tylko przez interfejsy SNMPv3.

Możliwe wartości to:
0 - (domyślnie) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.
privprotocol integer Protokół prywatności SNMPv3. Używane tylko przez interfejsy SNMPv3.

Możliwe wartości to:
0 - (domyślnie) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.
contextname string Nazwa kontekstu SNMPv3. Używane tylko przez interfejsy SNMPv3.