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.

Property Type Description
interfaceid ID Identyfikator interfejsu.

Zachowanie właściwości:
- tylko do odczytu
- wymagane w przypadku 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 Identyfikator hosta, do którego należy interfejs.

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

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

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

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

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

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

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

Zachowanie właściwości:
- wymagane w przypadku operacji tworzenia
useip integer Określa, czy połączenie powinno być nawiązywane za pośrednictwem adresu IP.

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

Zachowanie właściwości:
- wymagane w przypadku operacji tworzenia
main integer Określa, 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 - niedomyślny;
1 - domyślny.

Zachowanie właściwości:
- wymagane w przypadku operacji tworzenia
details object Dodatkowy obiekt details interfejsu.

Zachowanie właściwości:
- wymagane, jeśli type ma wartość „SNMP”
disable_until timestamp Następny czas 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, w którym 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:
- wymagana
bulk integer Określa, 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:
- wymagana, jeśli version ma wartość „SNMPv1” lub „SNMPv2c”
max_repetitions string Maksymalna wartość powtórzeń dla natywnych zbiorczych żądań SNMP (PDU GetBulkRequest).
Używana tylko dla pozycji walk[] w SNMPv2 i SNMPv3.
Obsługiwane są makra użytkownika.

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

Możliwe wartości: 0–100 (0 - wyłącza ponowienia).
Wartość domyślna: 5.
securityname string Nazwa zabezpieczeń SNMPv3. Używana tylko przez interfejsy SNMPv3.
securitylevel integer Poziom zabezpieczeń 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.