Documentation
Table of Contents
> 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.
Group link
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. |