Obiekt interfejsu hosta

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

Interfejs hosta

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

Należy pamiętać, że zarówno właściwości ip, jak i dns są wymagane dla operacji tworzenia. Jeśli nie chcesz używać DNS, ustaw go jako pusty ciąg znaków.

Właściwość Type Opis
interfaceid ID ID interfejsu.

Zachowanie właściwości:
- tylko do odczytu
- wymagane dla operacji aktualizacji
available integer Dostępność interfejsu hosta.

Możliwe wartości:
0 - (domyślnie) nieznana;
1 - dostępny;
2 - niedostępny.

Zachowanie właściwości:
- tylko do odczytu
hostid ID ID hosta, do którego należy interfejs.

Zachowanie właściwości:
- stała
- wymagane dla operacji tworzenia
type integer Typ interfejsu.

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

Zachowanie właściwości:
- wymagane dla operacji tworzenia
ip string Adres IP używany przez interfejs.

Może być pusty, jeśli połączenie jest nawiązywane przez DNS.

Zachowanie właściwości:
- wymagane dla operacji tworzenia
dns string Nazwa DNS używana przez interfejs.

Może być pusta, jeśli połączenie jest nawiązywane przez IP.

Zachowanie właściwości:
- wymagane dla operacji tworzenia
port string Numer portu używany przez interfejs.
Może zawierać makra użytkownika.

Zachowanie właściwości:
- wymagane dla operacji tworzenia
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 dla operacji tworzenia
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 dla operacji tworzenia
details object Dodatkowy obiekt details dla interfejsu.

Zachowanie właściwości:
- wymagane, jeśli type jest ustawione na "SNMP"
disable_until timestamp Czas następnego odpytywania niedostępnego interfejsu hosta.

Zachowanie właściwości:
- tylko do odczytu
error string Tekst błędu, jeśli interfejs hosta jest niedostępny.

Zachowanie właściwości:
- tylko do odczytu
errors_from timestamp Czas, kiedy interfejs hosta stał się niedostępny.

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

Szczegóły

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

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

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

Zachowanie właściwości:
- wymagane
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. Używana tylko przez interfejsy SNMPv1 i SNMPv2.

Zachowanie właściwości:
- wymagane jeśli version jest ustawione na "SNMPv1" lub "SNMPv2c"
max_repetitions integer Maksymalna wartość powtórzeń dla natywnych zbiorczych żądań SNMP (GetBulkRequest-PDUs).
Używane tylko dla pozycji discovery[] i walk[] w SNMPv2 i v3.

Domyślnie: 10.
securityname string Nazwa bezpieczeństwa SNMPv3. Używana tylko przez interfejsy SNMPv3.
securitylevel integer Poziom bezpieczeństwa SNMPv3. Używany tylko przez interfejsy SNMPv3.

Możliwe wartości:
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żywany tylko przez interfejsy SNMPv3.

Możliwe wartości:
0 - (domyślnie) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.
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.
contextname string Nazwa kontekstu SNMPv3. Używana tylko przez interfejsy SNMPv3.