host.get

Beschreibung

integer/array host.get(object parameters)

Diese Methode ermöglicht es, Hosts entsprechend den angegebenen Parametern abzurufen.

Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object) Parameter, die die gewünschte Ausgabe definieren.

Die Methode unterstützt die folgenden Parameter.

Parameter Type Beschreibung
groupids ID/array Gibt nur Hosts zurück, die zu den angegebenen Gruppen gehören.
dserviceids ID/array Gibt nur Hosts zurück, die mit den angegebenen erkannten Services verknüpft sind.
graphids ID/array Gibt nur Hosts zurück, die die angegebenen Graphen haben.
hostids ID/array Gibt nur Hosts mit den angegebenen Host-IDs zurück.
httptestids ID/array Gibt nur Hosts zurück, die die angegebenen Webprüfungen haben.
interfaceids ID/array Gibt nur Hosts zurück, die die angegebenen Schnittstellen verwenden.
itemids ID/array Gibt nur Hosts zurück, die die angegebenen Datenpunkte haben.
maintenanceids ID/array Gibt nur Hosts zurück, die von den angegebenen Wartungen betroffen sind.
monitored_hosts flag Gibt nur überwachte Hosts zurück.
proxyids ID/array Gibt nur Hosts zurück, die von den angegebenen Proxys überwacht werden.
proxy_groupids ID/array Gibt nur Hosts zurück, die von den angegebenen Proxy-Gruppen überwacht werden.
templated_hosts flag Gibt sowohl Hosts als auch Vorlagen zurück.
templateids ID/array Gibt nur Hosts zurück, die mit den angegebenen Vorlagen verknüpft sind.
triggerids ID/array Gibt nur Hosts zurück, die die angegebenen Auslöser haben.
with_items flag Gibt nur Hosts zurück, die Datenpunkte haben.

Überschreibt die Parameter with_monitored_items und with_simple_graph_items.
with_item_prototypes flag Gibt nur Hosts zurück, die Datenpunktprototypen haben.

Überschreibt den Parameter with_simple_graph_item_prototypes.
with_simple_graph_item_prototypes flag Gibt nur Hosts zurück, die Datenpunktprototypen haben, die für die Erstellung aktiviert sind und einen numerischen Informationstyp haben.
with_graphs flag Gibt nur Hosts zurück, die Graphen haben.
with_graph_prototypes flag Gibt nur Hosts zurück, die Graphprototypen haben.
with_httptests flag Gibt nur Hosts zurück, die Webprüfungen haben.

Überschreibt den Parameter with_monitored_httptests.
with_monitored_httptests flag Gibt nur Hosts zurück, die aktivierte Webprüfungen haben.
with_monitored_items flag Gibt nur Hosts zurück, die aktivierte Datenpunkte haben.

Überschreibt den Parameter with_simple_graph_items.
with_monitored_triggers flag Gibt nur Hosts zurück, die aktivierte Auslöser haben. Alle im Auslöser verwendeten Datenpunkte müssen ebenfalls aktiviert sein.
with_simple_graph_items flag Gibt nur Hosts zurück, die Datenpunkte mit numerischem Informationstyp haben.
with_triggers flag Gibt nur Hosts zurück, die Auslöser haben.

Überschreibt den Parameter with_monitored_triggers.
withProblemsSuppressed boolean Wenn auf true gesetzt, werden nur Hosts mit unterdrückten Problemen zurückgegeben.
evaltype integer Auswertungsmethode für Tags.

Mögliche Werte:
0 - (Standard) Und/Oder;
2 - Oder.
severities integer/array Gibt Hosts zurück, die nur Probleme mit den angegebenen Schweregraden haben. Gilt nur, wenn das Problemobjekt ein Auslöser ist.
tags object/array Gibt nur Hosts mit den angegebenen Tags zurück.
Format: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].
Ein leeres Array gibt alle Hosts zurück.

Mögliche Werte für operator:
0 - (Standard) Enthält;
1 - Gleich;
2 - Enthält nicht;
3 - Ungleich;
4 - Existiert;
5 - Existiert nicht.
inheritedTags boolean Gibt Hosts zurück, die die angegebenen tags auch in allen mit ihnen verknüpften Vorlagen haben.

Mögliche Werte:
true - verknüpfte Vorlagen müssen die angegebenen tags ebenfalls haben;
false - (Standard) Tags verknüpfter Vorlagen werden ignoriert.
selectDiscoveryData query Gibt eine Eigenschaft discoveryData mit den Objektdaten der Host-Erkennung zurück. Das Host-Erkennungsobjekt verknüpft einen erkannten Host mit einem Hostprototyp, über den er erkannt wurde.

Es hat die folgenden Eigenschaften:
host - (string) ID des Hosts;
parent_hostid - (string) ID des Hostprototyps, aus dem der Host erstellt wurde;
status - (int) Status der Host-Erkennung:
0 - (Standard) Host ist erkannt,
1 - Host ist nicht mehr erkannt;
ts_delete - (timestamp) Zeitpunkt, zu dem ein nicht mehr erkannter Host gelöscht wird;
ts_disable - (timestamp) Zeitpunkt, zu dem ein nicht mehr erkannter Host deaktiviert wird;
disable_source - (int) Kennzeichen dafür, ob der Host durch eine LLD-Regel oder manuell deaktiviert wurde:
0 - (Standard) automatisch deaktiviert,
1 - durch eine LLD-Regel deaktiviert.
selectDiscoveryRule query Gibt eine Eigenschaft discoveryRule mit der Low-Level-Discovery-Regel zurück, die den Host erstellt hat (aus dem Hostprototyp in der VMware-Überwachung).
selectDiscoveryRules query Gibt eine Eigenschaft discoveryRules mit Host-LLD-Regeln zurück.

Unterstützt count.
selectGraphs query Gibt eine Eigenschaft graphs mit Host-Graphen zurück.

Unterstützt count.
selectHostGroups query Gibt eine Eigenschaft hostgroups mit den Daten der Host-Gruppen zurück, zu denen der Host gehört.
selectHttpTests query Gibt eine Eigenschaft httpTests mit Webszenarien des Hosts zurück.

Unterstützt count.
selectInterfaces query Gibt eine Eigenschaft interfaces mit Host-Schnittstellen zurück.

Unterstützt count.
selectInventory query Gibt eine Eigenschaft inventory mit den Inventardaten des Hosts zurück.
selectItems query Gibt eine Eigenschaft items mit Host-Datenpunkten zurück.

Unterstützt count.
selectMacros query Gibt eine Eigenschaft macros mit Host-Makros zurück.
selectParentTemplates query Gibt eine Eigenschaft parentTemplates mit Vorlagen zurück, mit denen der Host verknüpft ist.

Zusätzlich zu den Feldern des Vorlagenobjekts enthält sie link_type - (integer) die Art, wie die Vorlage mit dem Host verknüpft ist.
Mögliche Werte:
0 - (Standard) manuell verknüpft;
1 - automatisch durch LLD verknüpft.

Unterstützt count.
selectDashboards query Gibt eine Eigenschaft dashboards zurück.

Unterstützt count.
selectTags query Gibt eine Eigenschaft tags mit Host-Tags zurück.
selectInheritedTags query Gibt eine Eigenschaft inheritedTags mit Tags zurück, die auf allen mit dem Host verknüpften Vorlagen vorhanden sind.
selectTriggers query Gibt eine Eigenschaft triggers mit Host-Auslösern zurück.

Unterstützt count.
selectValueMaps query Gibt eine Eigenschaft valuemaps mit Host-Wertzuordnungen zurück.
filter object Gibt nur Ergebnisse zurück, die exakt dem angegebenen Filter entsprechen.

Akzeptiert ein Objekt, bei dem die Schlüssel Eigenschaftsnamen sind und die Werte entweder ein einzelner Wert oder ein Array von Werten sind, mit denen abgeglichen werden soll.

Unterstützt keine Eigenschaften vom Datentyp text.

Unterstützt zusätzliche Eigenschaften: Eigenschaften des Host interface.
limitSelects integer Begrenzt die Anzahl der von Unterabfragen zurückgegebenen Datensätze.

Gilt für die folgenden Unterabfragen:
selectParentTemplates - Ergebnisse werden nach host sortiert;
selectInterfaces;
selectItems - sortiert nach name;
selectDiscoveryRules - sortiert nach name;
selectTriggers - sortiert nach description;
selectGraphs - sortiert nach name;
selectDashboards - sortiert nach name.
search object Gibt Ergebnisse zurück, die dem angegebenen Muster entsprechen (Groß-/Kleinschreibung wird nicht beachtet).

Akzeptiert ein Objekt, bei dem die Schlüssel Eigenschaftsnamen sind und die Werte Zeichenfolgen sind, nach denen gesucht werden soll. Wenn keine zusätzlichen Optionen angegeben werden, wird eine Suche vom Typ LIKE "%…%" durchgeführt.

Unterstützt nur Eigenschaften vom Datentyp string und text.

Unterstützt zusätzliche Eigenschaften: Eigenschaften des Host interface.
searchInventory object Gibt Hosts zurück, deren Inventardaten dem angegebenen Muster entsprechen (Groß-/Kleinschreibung wird nicht beachtet).

Akzeptiert ein Objekt, bei dem die Schlüssel Eigenschaftsnamen sind und die Werte Zeichenfolgen sind, nach denen gesucht werden soll. Wenn keine zusätzlichen Optionen angegeben werden, wird eine Suche vom Typ LIKE "%…%" durchgeführt.

Unterstützt nur Eigenschaften vom Datentyp string und text.
sortfield string/array Sortiert das Ergebnis nach den angegebenen Eigenschaften.

Mögliche Werte: hostid, host, name, status.
countOutput boolean Diese Parameter sind in der Referenzkommentierung beschrieben.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean
selectDiscoveries query Gibt eine Eigenschaft discoveries mit Low-Level-Discovery-Regeln des Hosts zurück.

Unterstützt count.

Diese Abfrage ist veraltet, bitte verwenden Sie stattdessen selectDiscoveryRules.
selectHostDiscovery query Gibt eine Eigenschaft hostDiscovery mit den Objektdaten der Host-Erkennung zurück.

Diese Abfrage ist veraltet, bitte verwenden Sie stattdessen selectDiscoveryData.

Rückgabewerte

(integer/array) Kann die folgenden Dinge zurück geben:

  • ein Array von Objekten;
  • die Anzahl der abgerufenen Objekte, wenn der Parameter countOutput verwendet wurde.

Beispiele

Daten nach Namen abrufen

Rufen Sie alle Daten zu zwei Hosts mit den Namen „Zabbix server“ und „Linux server“ ab.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "filter": {
            "host": [
                "Zabbix server",
                "Linux server"
            ]
        }
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "hostid": "10160",
            "proxyid": "0",
            "host": "Zabbix server",
            "status": "0",
            "ipmi_authtype": "-1",
            "ipmi_privilege": "2",
            "ipmi_username": "",
            "ipmi_password": "",
            "maintenanceid": "0",
            "maintenance_status": "0",
            "maintenance_type": "0",
            "maintenance_from": "0",
            "name": "Zabbix server",
            "flags": "0",
            "description": "Der Zabbix-Monitoring-Server.",
            "tls_connect": "1",
            "tls_accept": "1",
            "tls_issuer": "",
            "tls_subject": "",
            "proxy_groupid": "0",
            "monitored_by": "0",
            "inventory_mode": "1",
            "active_available": "1",
            "assigned_proxyid": "0"
        },
        {
            "hostid": "10167",
            "proxyid": "0",
            "host": "Linux server",
            "status": "0",
            "ipmi_authtype": "-1",
            "ipmi_privilege": "2",
            "ipmi_username": "",
            "ipmi_password": "",
            "maintenanceid": "0",
            "maintenance_status": "0",
            "maintenance_type": "0",
            "maintenance_from": "0",
            "name": "Linux server",
            "flags": "0",
            "description": "",
            "tls_connect": "1",
            "tls_accept": "1",
            "tls_issuer": "",
            "tls_subject": "",
            "proxy_groupid": "0",
            "monitored_by": "0",
            "inventory_mode": "1",
            "active_available": "1",
            "assigned_proxyid": "0"
        }
    ],
    "id": 1
}

Abrufen von Hostgruppen

Rufen Sie die Hostgruppen ab, deren Mitglied der Host „Zabbix server“ ist.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "output": ["hostid"],
        "selectHostGroups": "extend",
        "filter": {
            "host": [
                "Zabbix server"
            ]
        }
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "hostid": "10085",
            "hostgroups": [
                {
                    "groupid": "2",
                    "name": "Linux servers",
                    "flags": "0",
                    "uuid": "dc579cd7a1a34222933f24f52a68bcd8"
                },
                {
                    "groupid": "4",
                    "name": "Zabbix servers",
                    "flags": "0",
                    "uuid": "6f6799aa69e844b4b3918f779f2abf08"
                }
            ]
        }
    ],
    "id": 1
}

Verknüpfte Vorlagen abrufen

Rufen Sie die IDs und Namen der mit dem Host „10084“ verknüpften Vorlagen ab.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "output": ["hostid"],
        "selectParentTemplates": [
            "templateid",
            "name"
        ],
        "hostids": "10084"
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "hostid": "10084",
            "parentTemplates": [
                {
                    "name": "Linux",
                    "templateid": "10001"
                },
                {
                    "name": "Zabbix Server",
                    "templateid": "10047"
                }
            ]
        }
    ],
    "id": 1
}

Abrufen von Hosts nach Vorlage

Rufen Sie Hosts ab, mit denen die Vorlage „10001“ (Linux by Zabbix Agent) verknüpft ist.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "output": ["hostid", "name"],
        "templateids": "10001"
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "templateid": "10001",
            "hosts": [
                {
                    "hostid": "10084",
                    "name": "Zabbix server"
                },
                {
                    "hostid": "10603",
                    "name": "Host 1"
                },
                {
                    "hostid": "10604",
                    "name": "Host 2"
                }
            ]
        }
    ],
    "id": 1
}

Suche nach Host-Inventardaten

Rufen Sie Hosts ab, die „Linux“ im Host-Inventarfeld „OS“ enthalten.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "output": [
            "host"
        ],
        "selectInventory": [
            "os"
        ],
        "searchInventory": {
            "os": "Linux"
        }
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "hostid": "10084",
            "host": "Zabbix server",
            "inventory": {
                "os": "Linux Ubuntu"
            }
        },
        {
            "hostid": "10107",
            "host": "Linux server",
            "inventory": {
                "os": "Linux Mint"
            }
        }
    ],
    "id": 1
}

Suche nach Host-Tags

Rufen Sie Hosts ab, deren Tag „host-name“ gleich „linux-server“ ist.

Request:

{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "output": ["hostid"],
        "selectTags": "extend",
        "evaltype": 0,
        "tags": [
            {
                "tag": "host-name",
                "value": "linux-server",
                "operator": 1
            }
        ]
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "hostid": "10085",
            "tags": [
                {
                    "tag": "host-name",
                    "value": "linux-server",
                    "automatic": "0"
                },
                {
                    "tag": "os",
                    "value": "rhel-7",
                    "automatic": "0"
                }
            ]
        }
    ],
    "id": 1
}

Rufen Sie Hosts ab, die diese Tags nicht nur auf Host-Ebene, sondern auch in ihren verknüpften übergeordneten Vorlagen haben.

Request:

{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "output": ["name"],
        "tags": [
            {
                "tag": "os",
                "value": "rhel-7",
                "operator": 1
            }
        ],
        "inheritedTags": true
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "hostid": "10623",
            "name": "PC room 1"
        },
        {
            "hostid": "10601",
            "name": "Office"
        }
    ],
    "id": 1
}

Rufen Sie Hosts ab, ausgenommen diejenigen mit dem Tag „component“.

Request:

{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "output": ["hostid"],
        "selectTags": "extend",
        "evaltype": 0,
        "tags": [
            {
                "tag": "component",
                "value": "",
                "operator": 5
            }
        ]
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "hostid": "10084",
            "tags": [
                {
                    "tag": "class",
                    "value": "os",
                    "automatic": "0"
                },
                {
                    "tag": "target",
                    "value": "linux",
                    "automatic": "0"
                }
            ]
        },
        {
            "hostid": "10629",
            "tags": [
                {
                    "tag": "class",
                    "value": "application",
                    "automatic": "0"
                },
                {
                    "tag": "target",
                    "value": "browser",
                    "automatic": "0"
                }
            ]
        }
    ],
    "id": 1
}

Host mit Tags und Vorlagen-Tags suchen

Rufen Sie einen Host mit Tags und allen Tags ab, die mit übergeordneten Vorlagen verknüpft sind.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "output": ["name"],
        "hostids": 10502,
        "selectTags": ["tag", "value"],
        "selectInheritedTags": ["tag", "value"]
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "hostid": "10502",
            "name": "Desktop",
            "tags": [
                {
                    "tag": "host-name",
                    "value": "linux-server"
                },
                {
                    "tag": "os",
                    "value": "rhel-7"
                }
            ],
            "inheritedTags": [
                {
                    "tag": "class",
                    "value": "os"
                },
                {
                    "tag": "target",
                    "value": "linux"
                },
                {
                    "tag": "os",
                    "value": "rhel-7"
                }
            ]
        }
    ],
    "id": 1
}

Hosts nach Problem-Schweregrad suchen

Rufen Sie Hosts ab, die Probleme mit dem Schweregrad „Katastrophal“ haben.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "output": ["name"],
        "severities": 5
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "hostid": "10160",
            "name": "Zabbix server"
        }
    ],
    "id": 1
}

Rufen Sie Hosts ab, die Probleme mit den Schweregraden „Durchschnittlich“ und „Hoch“ haben.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "output": ["name"],
        "severities": [3, 4]
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "hostid": "20170",
            "name": "Database"
        },
        {
            "hostid": "20183",
            "name": "workstation"
        }
    ],
    "id": 1
}

Abrufen von Host-Datenpunkten

Rufen Sie Datenpunkte für den Host „Zabbix server“ ab. Die Anfrage ist auf die Datenpunkt-Eigenschaften itemid, name und status beschränkt. Aufgrund der großen Antwortgröße wird im Beispiel nur eine Teilmenge der Datenpunkte angezeigt.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "output": ["hostid"],
        "selectItems": ["itemid","name","status"],
        "filter": {
            "host": [
                "Zabbix server"
            ]
        }
    },
    "id": 1
}

Antwort:

{
  "jsonrpc": "2.0",
  "result": [
    {
      "hostid": "10084",
      "items": [
        {
          "itemid": "42227",
          "name": "Host-Name des laufenden Zabbix Agent",
          "status": "0"
        },
        {
          "itemid": "42237",
          "name": "Zabbix Agent ping",
          "status": "0"
        },
        {
          "itemid": "42250",
          "name": "Version des laufenden Zabbix Agent",
          "status": "0"
        },
        {
          "itemid": "42251",
          "name": "Maximale Anzahl offener Dateideskriptoren",
          "status": "0"
        },
        {
          "itemid": "42252",
          "name": "Maximale Anzahl von Prozessen",
          "status": "0"
        },
        {
          "itemid": "69869",
          "name": "Schnittstelle enp0s3: Verworfen eingehende Pakete",
          "status": "0"
        },
        {
          "itemid": "69870",
          "name": "Schnittstelle enp0s3: Eingehende Pakete mit Fehlern",
          "status": "0"
        },
        {
          "itemid": "69871",
          "name": "Schnittstelle enp0s3: Empfangene Bits",
          "status": "0"
        },
        {
          "itemid": "69872",
          "name": "Schnittstelle enp0s3: Verworfen ausgehende Pakete",
          "status": "0"
        },
        {
          "itemid": "69873",
          "name": "Schnittstelle enp0s3: Ausgehende Pakete mit Fehlern",
          "status": "0"
        },
        {
          "itemid": "69874",
          "name": "Schnittstelle enp0s3: Gesendete Bits",
          "status": "0"
        },
        {
          "itemid": "42253",
          "name": "Anzahl der Prozesse",
          "status": "0"
        },
        {
          "itemid": "42254",
          "name": "Anzahl der laufenden Prozesse",
          "status": "0"
        },
        {
          "itemid": "42255",
          "name": "Systemstartzeit",
          "status": "0"
        }
      ]
    }
  ],
  "id": 1
}

Siehe auch

Quelle

CHost::get() in ui/include/classes/api/services/CHost.php.