host.get

Опис

integer/array host.get(object parameters)

Метода омогућава преузимање хостова према датим параметрима.

Параметри

(object) Параметри који дефинишу жељени излаз.

Метод подржава следеће параметре.

Повратне вредности

(integer/array) Враћа било:

• низ објеката;
• број преузетих објеката, ако је параметар countOutput коришћен.

Примери

Преузимање података по имену

Преузми све податке о два хоста под називом "Zabbix server" и "Linux server".

Request:

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

Одговор:

{
     "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": "The 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
}

Преузимање група домаћина

Преузми групе домаћина чији је домаћин "Zabbix server" члан.

Преузимање група домаћина

Преузми групе домаћина чији је хост "Заббик сервер" члан.

Request:

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

Одговор:

{
     "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
}

Преузимање повезаних шаблона

Преузмите ID-ијеве и називе шаблона повезаних са домаћином „10084“.

Request:

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

Одговор:

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

Преузимање домаћина по шаблону

Преузми домаћине са којима је повезан шаблон „10001“ (Linux by Zabbix agent).

Request:

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

Одговор:

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

Претраживање према подацима инвентара домаћина

Преузми домаћине који садрже „ Linux“ у пољу „ OS“ инвентара домаћина.

Request:

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

Одговор:

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

Претраживање по ознакама домаћина

Преузми домаћине који имају ознаку "host-name" једнаку "linux-server".

Захтев:

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

Одговор:

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

Преузми домаћине који имају ове ознаке не само на нивоу домаћина, већ и у њиховим повезаним родитељским шаблонима.

Request:

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

Одговор:

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

Претраживање домаћина са ознакама и ознакама шаблона

Преузми домаћина са ознакама и свим ознакама које су повезане са предлошцима родитеља.

Request:

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

Одговор:

{
     "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
}

Претраживање домаћина према озбиљности проблема

Вратите домаћине који имају проблема са „ Disaster“.

Request:

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

Одговор:

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

Преузми домаћине који имају "Average" и "High" проблем.

Request:`

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

Одговор:

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

Retrieving host items

Retrieve items for the "Zabbix server" host. The request is limited to the item properties itemid, name, and status. Due to the large response size, only a subset of items is shown in the example.

Request:

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

Response:

{
  "jsonrpc": "2.0",
  "result": [
    {
      "hostid": "10084",
      "items": [
        {
          "itemid": "42227",
          "name": "Host name of Zabbix agent running",
          "status": "0"
        },
        {
          "itemid": "42237",
          "name": "Zabbix agent ping",
          "status": "0"
        },
        {
          "itemid": "42250",
          "name": "Version of Zabbix agent running",
          "status": "0"
        },
        {
          "itemid": "42251",
          "name": "Maximum number of open file descriptors",
          "status": "0"
        },
        {
          "itemid": "42252",
          "name": "Maximum number of processes",
          "status": "0"
        },
        {
          "itemid": "69869",
          "name": "Interface enp0s3: Inbound packets discarded",
          "status": "0"
        },
        {
          "itemid": "69870",
          "name": "Interface enp0s3: Inbound packets with errors",
          "status": "0"
        },
        {
          "itemid": "69871",
          "name": "Interface enp0s3: Bits received",
          "status": "0"
        },
        {
          "itemid": "69872",
          "name": "Interface enp0s3: Outbound packets discarded",
          "status": "0"
        },
        {
          "itemid": "69873",
          "name": "Interface enp0s3: Outbound packets with errors",
          "status": "0"
        },
        {
          "itemid": "69874",
          "name": "Interface enp0s3: Bits sent",
          "status": "0"
        },
        {
          "itemid": "42253",
          "name": "Number of processes",
          "status": "0"
        },
        {
          "itemid": "42254",
          "name": "Number of running processes",
          "status": "0"
        },
        {
          "itemid": "42255",
          "name": "System boot time",
          "status": "0"
        }
      ]
    }
  ],
  "id": 1
}

Такође погледајте

• Host group
• Template
• User macro
• Host interface
• Proxy
• Proxy group

Извор

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