host.get

Опис

integer/array host.get(object parameters)

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

Ова метода је доступна корисницима било ког типа. Дозволе за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте Userroles за више информација.

Параметри

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

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

Parameter Type Description
groupids ID/array Враћа само домаћине који припадају датим групама.
dserviceids ID/array Враћа само домаћине који су повезани са датим откривеним услугама.
graphids ID/array Враћа само домаћине који имају дате графиконе.
hostids ID/array Враћа само домаћине са датим ID-ијевима домаћина.
httptestids ID/array Враћа само домаћине који имају дате веб провере.
interfaceids ID/array Враћа само домаћине који користе дате интерфејсе.
itemids ID/array Враћа само домаћине који имају дате ставке.
maintenanceids ID/array Враћа само домаћине на које утиче дато одржавање.
monitored_hosts flag Враћа само надгледане домаћине.
proxyids ID/array Враћа само домаћине које надгледају дати проксији.
proxy_groupids ID/array Враћа само домаћине које надгледају дате прокси групе.
templated_hosts flag Враћа и домаћине и шаблоне.
templateids ID/array Враћа само домаћине који су повезани са датим шаблонима.
triggerids ID/array Враћа само домаћине који имају дате окидаче.
with_items flag Враћа само домаћине који имају ставке.

Замењује параметре with_monitored_items и with_simple_graph_items.
with_item_prototypes flag Враћа само домаћине који имају прототипове ставке.

Замењује параметар with_simple_graph_item_prototypes.
with_simple_graph_item_prototypes flag Враћа само домаћине који имају прототипове ставки, који су омогућени за креирање и имају нумерички тип информација.
with_graphs flag Враћа само домаћине који имају графиконе.
with_graph_prototypes flag Враћа само домаћине који имају прототипове графикона.
with_httptests flag Враћа само домаћине који имају веб провере.

Замењује параметар with_monitored_httptests.
with_monitored_httptests flag Враћа само домаћине који су омогућили веб провере.
with_monitored_items flag Враћа само домаћине који су омогућили ставке.

Замењује параметар with_simple_graph_items.
with_monitored_triggers flag Враћа само домаћине који имају омогућене окидаче. Све ставке које се користе у окидачу такође морају бити омогућене.
with_simple_graph_items flag Враћа само домаћине који имају ставке са нумеричким типом информација.
with_triggers flag Враћа само домаћине који имају окидачи.

Замењује параметар with_monitored_triggers.
withProblemsSuppressed boolean Враћа домаћине који имају потиснуте проблеме.

Могуће вредности:
null - (подразумевано) сви домаћини;
true - само домаћини са потиснутим проблемима;
false - само домаћини са неприкривеним проблемима.
evaltype integer Правила за претрагу ознака.

Могуће вредности:
0 - (подразумевано) И/Или;
2 - Или.
severities integer/array Враћа домаћине који имају само проблеме са датим озбиљностима. Примењује се само ако је проблемски објекат окидач.
tags object/array Враћа само домаћине са датим ознакама. Тачно подударање по ознаци и претрага која се разликује од великих или малих слова по вредности ознаке у зависности од вредности оператора.
Формат: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].
Празан низ враћа све домаћине.

Могуће вредности оператора:
0 - (подразумевано) Садржи;
1 - Једнако;
2 - Није као;
3 - Није једнако;
4 - Постоји;
5 - Не постоји.
inheritedTags boolean Враћа домаћине који су дали tags такође у свим својим повезаним шаблонима. Подразумевано:

Могуће вредности:
true - повезани шаблони такође морају да имају дате tags;
false - (подразумевано) повезане ознаке шаблона се занемарују.
selectDiscoveries query Враћа својство discoveries са правилима откривања ниског нивоа домаћина.

Подржава count.
selectDiscoveryRule query Враћа својство discoveryRule са правилом откривања ниског нивоа које је креирало домаћина (из прототипа домаћина у VMware мониторингу).
selectGraphs query Враћа graphs својство са графовима домаћина.

Подржава count.
selectHostDiscovery query Враћа својство hostDiscovery са подацима објекта откривања домаћина.

Објекат откривања домаћина повезује откривеног домаћина са прототипом домаћина или прототипове домаћина са LLD правилом и има следећа својства:
host - (стринг)домаћин од прототипа домаћина;
hostid - (стринг) ID откривеног домаћина или прототипа домаћина;
parent_hostid - (стринг) ID прототипа домаћина од којег је домаћин креиран;
parent_itemid - *(стринг)* ID LLD правила које је креирао откривени домаћин;<br>lastcheck- *(временска ознака)* време када је домаћин последњи пут откривен;<br>status- *(int)* статус откривања домаћина :<br>0 - *(подразумевано)* домаћин је откривен,<br>1 - домаћин више није откривен;<br>ts_delete - *(временска ознака)* време када ће домаћин који више није откривен бити обрисан ;<br>ts_disable- *(времнска ознака)* време када ће домаћин који више није откривен бити онемогућен;<br>disable_source` - (int) индикатор да ли је домаћин онемогућен LLD правилом или ручно :
0 - (подразумевано) онемогућено аутоматски,
1 - онемогућено LLD правилом.
selectHostGroups query Враћа hostgroups својство са подацима о групама домаћина којима домаћин припада.
selectHttpTests query Враћа својство httpTests са веб сценаријима домаћина.

Подржава count.
selectInterfaces query Враћа својство interfaces са интерфејсима домаћина.

Подржава count.
selectInventory query Враћа својство inventory са подацима инвентара домаћина.
selectItems query Враћа items својство са ставкама домаћина.

Подржава count.
selectMacros query Враћа својство macros са макроима домаћина.
selectParentTemplates query Враћа својство parentTemplates са шаблонима са којима је домаћин повезан.

Поред поља Template објекта, садржи link_type - (integer) начин на који је шаблон повезан са домаћином.
Могуће вредности:
0 - (подразумевано) ручно повезано;
1 - аутоматски повезује LLD.

Подржава count.
selectDashboards query Враћа својство dashboards.

Подржава count.
selectTags query Враћа својство tags са ознакама домаћина.
selectInheritedTags query Враћа inheritedTags својство са ознакама које се налазе на свим шаблонима који су повезани са домаћином.
selectTriggers query Враћа својство triggers са окидачима домаћина.

Подржава count.
selectValueMaps query Враћа својство valuemaps са мапама вредности домаћина.
filter object Враћа само оне резултати који се тачно поклапају са датим филтером.

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

Не подржава својства text типа података.

Подржава додатна својства: Интерфејс домаћина својства.
limitSelects integer Ограничава број записа које враћају подизбори.

Примењује се на следеће подизборе:
selectParentTemplates - резултати ће бити сортирани по host;
selectInterfaces;
selectItems - сортирано по name;
selectDiscoveries - сортирано по name;
selectTriggers - сортирано по description;
selectGraphs - сортирано по name;
selectDashboards - сортирано по name.
search object Враћа резултате који се поклапају са датим шаблоном (неосетљиво на велика и мала слова).

Прихвата објекат , где су кључеви имена својстава, а вредности низови за претраживање. Ако нису дате додатне опције, ово ће извршити претрагу LIKE "%…%".

Подржава само својства string и text тип података.
<br >Подржава додатна својства: својства Интерфејс домаћина.
searchInventory object Враћа домаћине који имају инвентар података који се поклапају са датим шаблоном (неосетљив на велика и мала слова).

Прихвата објекат, где су кључеви имена својстава, а вредности низови за тражење. Ако нису дате додатне опције, ово ће извршити претрагу LIKE "%…%".

Подржава само својства string и text тип података.
sortfield string/array Сортира резултат према датим особинама.

Могуће вредности: hostid, host, name, status.
countOutput boolean Ови параметри су описани описани у референтном коментару.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean
selectGroups
(застарело)		 query Овај параметар је застарео, користите selectHostGroups уместо тога.
Вратите својство groups са подацима група домаћина којима домаћин припада.

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

(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",
                    "automatic": "0"
                },
                {
                    "tag": "os",
                    "value": "rhel-7",
                    "automatic": "0"
                }
            ]
        }
    ],
    "id": 1
}

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

Захтев:

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

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

Извор

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