Documentation
Table of Contents
> Obiekt Host
Następujące obiekty są bezpośrednio powiązane z interfejsem API host.
Host
Obiekt hosta posiada następujące właściwości.
| Właściwość | Typ | Opis |
|---|---|---|
| hostid | string | (tylko do odczytu) ID hosta. |
| host (wymagane) |
string | Nazwa techniczna hosta. |
| description | tekst | Opis hosta. |
| flags | liczba całkowita | (tylko do odczytu) Pochodzenie hosta. Możliwe wartości: 0 - zwykły host; 4 - host wykryty. |
| inventory_mode | liczba całkowita | Tryb wypełniania inwentarza hosta. Możliwe wartości to: -1 - (domyślnie) wyłączony; 0 - ręczny; 1 - automatyczny. |
| ipmi_authtype | liczba całkowita | Algorytm uwierzytelniania IPMI. Możliwe wartości to: -1 - (domyślnie) domyślny; 0 - brak; 1 - MD2; 2 - MD5 4 - prosty; 5 - OEM; 6 - RMCP+. |
| ipmi_password | string | Hasło IPMI. |
| ipmi_privilege | liczba całkowita | Poziom uprawnień IPMI. Możliwe wartości to: 1 - callback; 2 - (domyślnie) użytkownik; 3 - operator; 4 - admin; 5 - OEM. |
| ipmi_username | string | Nazwa użytkownika IPMI. |
| maintenance_from | znacznik czasu | (tylko do odczytu) Czas rozpoczęcia efektywnego utrzymania. |
| maintenance_status | liczba całkowita | (tylko do odczytu) Efektywny status utrzymania. Możliwe wartości to: 0 - (domyślnie) brak utrzymania; 1 - utrzymanie w trakcie. |
| maintenance_type | liczba całkowita | (tylko do odczytu) Typ efektywnego utrzymania. Możliwe wartości to: 0 - (domyślnie) utrzymanie ze zbieraniem danych; 1 - utrzymanie bez zbierania danych. |
| maintenanceid | string | (tylko do odczytu) ID utrzymania obecnie obowiązującego na hoście. |
| name | string | Widoczna nazwa hosta. Domyślnie: wartość właściwości host. |
| proxy_hostid | string | ID proxy, który jest używany do monitorowania hosta. |
| status | liczba całkowita | Status i funkcja hosta. Możliwe wartości to: 0 - (domyślnie) monitorowany host; 1 - host niemonitorowany. |
| tls_connect | liczba całkowita | Połączenia do hosta. Możliwe wartości to: 1 - (domyślnie) brak szyfrowania; 2 - PSK; 4 - certyfikat. |
| tls_accept | liczba całkowita | Połączenia od hosta. Możliwe wartości to: 1 - (domyślnie) brak szyfrowania; 2 - PSK; 4 - certyfikat. |
| tls_issuer | string | Wydawca certyfikatu. |
| tls_subject | string | Temat certyfikatu. |
| tls_psk_identity | string | (tylko do zapisu) Identyfikator PSK. Wymagane, jeśli tls_connect lub tls_accept mają włączony PSK.Nie umieszczaj poufnych informacji w identyfikatorze PSK, jest on przesyłany w sieci w formie niezaszyfrowanej, aby poinformować odbiorcę, który PSK należy użyć. |
| tls_psk | string | (tylko do zapisu) Klucz współdzielony, co najmniej 32 cyfry szesnastkowe. Wymagane, jeśli tls_connect lub tls_accept mają włączony PSK. |
Zauważ, że dla niektórych metod (aktualizacja, usuwanie) kombinacja wymaganych/opcjonalnych parametrów jest różna.
Inwentarz hosta
Obiekt inwentarza hosta posiada następujące właściwości.
Każda właściwość ma swój unikalny numer ID, który jest używany do łączenia pól inwentarza hosta z pozycjami.
| ID | Właściwość | Typ | Opis | Maksymalna długość |
|---|---|---|---|---|
| 4 | alias | string | Alias. | 128 znaków |
| 11 | asset_tag | string | Etykieta zasobu. | 64 znaki |
| 28 | chassis | string | Obudowa. | 64 znaki |
| 23 | contact | string | Osoba kontaktowa. | Zależy od używanej bazy danych: - 65535 znaków dla baz danych SQL - 2048 znaków dla baz danych Oracle |
| 32 | contract_number | string | Numer kontraktu. | 64 znaki |
| 47 | date_hw_decomm | string | Data wycofania sprzętu z użytku. | 64 znaki |
| 46 | date_hw_expiry | string | Data zakończenia umowy serwisowej. | 64 znaki |
| 45 | date_hw_install | string | Data instalacji sprzętu. | 64 znaki |
| 44 | date_hw_purchase | string | Data zakupu sprzętu. | 64 znaki |
| 34 | deployment_status | string | Stan instalacji. | 64 znaki |
| 14 | hardware | string | Sprzęt. | 255 znaków |
| 15 | hardware_full | string | Sprzęt (wszystkie informacje). | Zależy od używanej bazy danych: - 65535 znaków dla baz danych SQL - 2048 znaków dla baz danych Oracle |
| 39 | host_netmask | string | Maska podsieci hosta. | 39 znaków |
| 38 | host_networks | string | Sieci hosta. | Zależy od używanej bazy danych: - 65535 znaków dla baz danych SQL - 2048 znaków dla baz danych Oracle |
| 40 | host_router | string | Router hosta. | 39 znaków |
| 30 | hw_arch | string | Architektura sprzętu. | 32 znaki |
| 33 | installer_name | string | Nazwa instalatora. | 64 znaki |
| 24 | location | string | Położenie. | Zależy od używanej bazy danych: - 65535 znaków dla baz danych SQL - 2048 znaków dla baz danych Oracle |
| 25 | location_lat | string | Szerokość geograficzna lokalizacji. | 16 znaków |
| 26 | location_lon | string | Długość geograficzna lokalizacji. | 16 znaków |
| 12 | macaddress_a | string | Adres MAC A. | 64 znaki |
| 13 | macaddress_b | string | Adres MAC B. | 64 znaki |
| 29 | model | string | Model. | 64 znaki |
| 3 | name | string | Nazwa. | 128 znaków |
| 27 | notes | string | Notatki. | Zależy od używanej bazy danych: - 65535 znaków dla baz danych SQL - 2048 znaków dla baz danych Oracle |
| 41 | oob_ip | string | Adres IP OOB. | 39 znaków |
| 42 | oob_netmask | string | Maska podsieci hosta OOB. | 39 znaków |
| 43 | oob_router | string | Router OOB. | 39 znaków |
| 5 | os | string | Nazwa systemu operacyjnego. | 128 znaków |
| 6 | os_full | string | Szczegółowa nazwa systemu operacyjnego. | 255 znaków |
| 7 | os_short | string | Krótka nazwa systemu operacyjnego. | 128 znaków |
| 61 | poc_1_cell | string | Telefon komórkowy głównego punktu kontaktu. | 64 znaki |
| 58 | poc_1_email | string | E-mail głównego punktu kontaktu. | 128 znaków |
| 57 | poc_1_name | string | Nazwa głównego punktu kontaktu. | 128 znaków |
| 63 | poc_1_notes | string | Notatki odnośnie głównego punktu kontaktu. | Zależy od używanej bazy danych: - 65535 znaków dla baz danych SQL - 2048 znaków dla baz danych Oracle |
| 59 | poc_1_phone_a | string | Telefon A głównego punktu kontaktu | 64 znaki |
| 60 | poc_1_phone_b | string | Telefon B głównego punktu kontaktu. | 64 znaki |
| 62 | poc_1_screen | string | Pseudonim głównego punktu kontaktu. | 64 znaki |
| 68 | poc_2_cell | string | Telefon komórkowy drugiego punktu kontaktu. | 64 znaki |
| 65 | poc_2_email | string | E-mail drugiego punktu kontaktu. | 128 znaków |
| 64 | poc_2_name | string | Nazwa drugiego punktu kontaktu. | 128 znaków |
| 70 | poc_2_notes | string | Notatki drugiego punktu kontaktu. | Zależy od używanej bazy danych: - 65535 znaków dla baz danych SQL - 2048 znaków dla baz danych Oracle |
| 66 | poc_2_phone_a | string | Telefon A drugiego punktu kontaktu. | 64 znaki |
| 67 | poc_2_phone_b | string | Telefon B drugiego punktu kontaktu. | 64 znaki |
| 69 | poc_2_screen | string | Pseudonim drugiego punktu kontaktu. | 64 znaki |
| 8 | serialno_a | string | Numer seryjny A. | 64 znaki |
| 9 | serialno_b | string | Numer seryjny B. | 64 znaki |
| 48 | site_address_a | string | Adres A oddziału. | 128 znaków |
| 49 | site_address_b | string | Adres B oddziału. | 128 znaków |
| 50 | site_address_c | string | Adres C oddziału. | 128 znaków |
| 51 | site_city | string | Miasto oddziału. | 128 znaków |
| 53 | site_country | string | Kraj oddziału. | 64 znaki |
| 56 | site_notes | string | Notatki oddziału. | Zależy od używanej bazy danych: - 65535 znaków dla baz danych SQL - 2048 znaków dla baz danych Oracle |
| 55 | site_rack | string | Oddział lokalizacji szafy rack. | 128 znaków |
| 52 | site_state | string | Stan witryny. | 64 znaki |
| 54 | site_zip | string | Kod pocztowy / ZIP oddziału. | 64 znaki |
| 16 | software | string | Oprogramowanie. | 255 znaków |
| 18 | software_app_a | string | Aplikacja oprogramowania A. | 64 znaki |
| 19 | software_app_b | string | Aplikacja oprogramowania B. | 64 znaki |
| 20 | software_app_c | string | Aplikacja oprogramowania C. | 64 znaki |
| 21 | software_app_d | string | Aplikacja oprogramowania D. | 64 znaki |
| 22 | software_app_e | string | Aplikacja oprogramowania E. | 64 znaki |
| 17 | software_full | string | Szczegóły oprogramowania. | Zależy od używanej bazy danych: - 65535 znaków dla baz danych SQL - 2048 znaków dla baz danych Oracle |
| 10 | tag | string | Znacznik. | 64 znaki |
| 1 | type | string | Typ. | 64 znaki |
| 2 | type_full | string | Szczegóły typu. | 64 znaki |
| 35 | url_a | string | URL A. | 255 znaków |
| 36 | url_b | string | URL B. | 255 znaków |
| 37 | url_c | string | URL C. | 255 znaków |
| 31 | vendor | string | Producent. | 64 znaki |
Znacznik hosta
Obiekt tagu hosta posiada następujące właściwości.
| Właściwość | Typ | Opis |
|---|---|---|
| tag (wymagane) |
string | Nazwa znacznika hosta. |
| value | string | Wartość znacznika hosta. |