Obiekt prototypu hosta

Następujące obiekty są bezpośrednio powiązane z API hostprototype.

Prototyp hosta

Obiekt prototypu hosta ma następujące właściwości.

Właściwość Type Opis
hostid ID ID prototypu hosta.

Zachowanie właściwości:
- tylko do odczytu
- wymagane dla operacji aktualizacji
host string Nazwa techniczna prototypu hosta.

Zachowanie właściwości:
- wymagane dla operacji tworzenia
- tylko do odczytu dla obiektów dziedziczonych
name string Widoczna nazwa prototypu hosta.

Domyślnie: wartość właściwości host.

Zachowanie właściwości:
- tylko do odczytu dla obiektów dziedziczonych
status integer Status prototypu hosta.

Możliwe wartości:
0 - (domyślnie) monitorowany host;
1 - niemonitorowany host.
flags integer Pochodzenie prototypu hosta.

Możliwe wartości:
2 - prototyp hosta;
6 - wykryty prototyp hosta

Zachowanie właściwości:
- tylko do odczytu
inventory_mode integer Tryb uzupełniania inwentarza hosta.

Możliwe wartości:
-1 - (domyślnie) wyłączony;
0 - ręczny;
1 - automatyczny.
templateid ID ID nadrzędnego szablonu prototypu hosta.

Zachowanie właściwości:
- tylko do odczytu
discover integer Status wykrywania prototypu hosta.

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

Możliwe wartości:
0 - (domyślnie) dziedziczenie interfejsów z nadrzędnego hosta;
1 - użycie niestandardowych interfejsów prototypów hostów.

Zachowanie właściwości:
- tylko do odczytu dla obiektów dziedziczonych
uuid string Uniwersalny unikatowy identyfikator używany do łączenia importowanych prototypów hostów z już istniejącymi. Generowany automatycznie, jeśli nie został podany.

Zachowanie właściwości:
- obsługiwane jeśli prototyp hosta należy do szablonu

Łącze grupy

Obiekt łącza grupy łączy prototyp hosta z grupą hostów. Ma następujące właściwości.

Właściwość Type Opis
groupid ID ID grupy hostów.

Zachowanie właściwości:
- wymagane

Prototyp grupy

Obiekt prototypu grupy definiuje grupę, która zostanie utworzona dla wykrytego hosta. Ma następujące właściwości.

Właściwość Type Opis
group_prototypeid ID ID prototypu grupy.

Zachowanie właściwości:
- tylko do odczytu
name string Nazwa prototypu grupy.

Zachowanie właściwości:
- wymagane dla operacji tworzenia

Tag prototypu hosta

Obiekt tagu prototypu hosta ma następujące właściwości.

Właściwość Typ Opis
tag string Nazwa tagu prototypu hosta.

Zachowanie właściwości:
- wymagane
value string Wartość tagu prototypu hosta.

Zachowanie właściwości:
- tylko do odczytu.
object integer Typ obiektu, z którego tag został odziedziczony.

Możliwe wartości:
0 - szablon.

Zachowanie właściwości:
- tylko do odczytu.
objectid ID ID obiektu, z którego tag został odziedziczony.

Zachowanie właściwości:
- tylko do odczytu.

Interfejs niestandardowy

Interfejsy niestandardowe są obsługiwane, jeśli custom_interfaces obiektu Host prototype object jest ustawione na „użyj niestandardowych interfejsów prototypów hostów”. Obiekt interfejsu niestandardowego ma następujące właściwości.

Właściwość Typ Opis
type integer Typ interfejsu.

Możliwe wartości:
1 - Agent;
2 - SNMP;
3 - IPMI;
4 - JMX.

Zachowanie właściwości:
- wymagane
useip integer Czy połączenie powinno być nawiązywane przez IP.

Możliwe wartości:
0 - połącz przy użyciu nazwy DNS hosta;
1 - połącz przy użyciu adresu IP hosta.

Zachowanie właściwości:
- wymagane
ip string Adres IP używany przez interfejs.
Może zawierać makra.

Zachowanie właściwości:
- wymagane, jeśli useip jest ustawione na „połącz przy użyciu adresu IP hosta”
dns string Nazwa DNS używana przez interfejs.
Może zawierać makra.

Zachowanie właściwości:
- wymagane, jeśli useip jest ustawione na „połącz przy użyciu nazwy DNS hosta”
port string Numer portu używany przez interfejs.
Może zawierać makra użytkownika i LLD.

Zachowanie właściwości:
- wymagane
main 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 jest domyślny;
1 - domyślny.

Zachowanie właściwości:
- wymagane
details object Dodatkowy obiekt dla szczegółów interfejsu niestandardowego.

Zachowanie właściwości:
- wymagane, jeśli type jest ustawione na „SNMP”

Szczegóły niestandardowego interfejsu

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

Property Type Description
version integer Wersja interfejsu SNMP.

Możliwe wartości:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3.

Zachowanie właściwości:
- wymagana
bulk integer Czy używać zbiorczych żądań SNMP.

Możliwe wartości:
0 - nie używaj zbiorczych żądań;
1 - (domyślnie) - używaj zbiorczych żądań.
community string Społeczność SNMP.

Zachowanie właściwości:
- wymagana, jeśli version ma wartość „SNMPv1” lub „SNMPv2c”
max_repetitions string Maksymalna wartość powtórzeń dla natywnych zbiorczych żądań SNMP (GetBulkRequest-PDU).
Używana tylko dla pozycji walk[] w SNMPv2 i SNMPv3.
Obsługiwane są makra LLD i makra użytkownika.

Możliwe wartości: 1–2147483647 (INT32_MAX).
Wartość domyślna: 10.
retries string Maksymalna liczba ponowień, jeśli upłynie limit czasu żądania.
Używana dla pozycji walk[] i get[]. W przypadku walk[] ponowienia są współdzielone w ramach całego przejścia.
Obsługiwane są makra LLD i makra użytkownika.

Możliwe wartości: 0–100 (0 - wyłącza ponowienia).
Wartość domyślna: 5.
securityname string Nazwa zabezpieczeń SNMPv3.

Zachowanie właściwości:
- obsługiwana, jeśli version ma wartość „SNMPv3”
securitylevel integer Poziom zabezpieczeń SNMPv3.

Możliwe wartości:
0 - (domyślnie) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.

Zachowanie właściwości:
- obsługiwana, jeśli version ma wartość „SNMPv3”
authpassphrase string Hasło uwierzytelniania SNMPv3.

Zachowanie właściwości:
- obsługiwana, jeśli version ma wartość „SNMPv3”, a securitylevel ma wartość „authNoPriv” lub „authPriv”
privpassphrase string Hasło prywatności SNMPv3.

Zachowanie właściwości:
- obsługiwana, jeśli version ma wartość „SNMPv3”, a securitylevel ma wartość „authPriv”
authprotocol integer Protokół uwierzytelniania SNMPv3.

Możliwe wartości:
0 - (domyślnie) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.

Zachowanie właściwości:
- obsługiwana, jeśli version ma wartość „SNMPv3”, a securitylevel ma wartość „authNoPriv” lub „authPriv”
privprotocol integer Protokół prywatności SNMPv3. Używany tylko przez interfejsy SNMPv3.

Możliwe wartości:
0 - (domyślnie) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.

Zachowanie właściwości:
- obsługiwana, jeśli version ma wartość „SNMPv3”, a securitylevel ma wartość „authPriv”
contextname string Nazwa kontekstu SNMPv3.

Zachowanie właściwości:
- obsługiwana, jeśli version ma wartość „SNMPv3”