hostprototype.get

Опис

integer/array hostprototype.get(object parameters)

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

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

Параметри

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

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

Parameter Type Description
hostids ID/array Враћа само прототипове домаћина са датим ID-ијевима.
discoveryids ID/array Враћа само прототипове домаћина који припадају датим LLD правилима.
inherited boolean Ако је подешено на true, враћа само ставке наслеђене из шаблона.
selectDiscoveryRule query Враћа својство discoveryRule са LLD правилом којем припада прототипдомаћина.
selectDiscoveryRulePrototype query Врати својство discoveryRulePrototype са родитељским прототипом LLD правила којем припада прототип домаћина.
selectInterfaces query Врати својство interfaces са прилагођеним интерфејсима прототипа домаћина.
selectGroupLinks query Врати својство groupLinks са групним везама прототипа si.
selectGroupPrototypes query Врати својство groupPrototypes са групним прототиповима прототипа домаћина.
selectMacros query Врати својство macros са макроима прототипа домаћина.
selectParentHost query Врати својство parentHost са домаћином којем припада прототип домаћина.
selectTags query Врати својство tags са ознакама прототипа домаћина.
selectTemplates query Врати својство templates са шаблонима повезаним са прототипом домаћина.

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

Могуће вредности: hostid, host, name, status, discovered.
countOutput boolean Ови параметри су описани у референтном коментару.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

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

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

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

Примери

Преузимање прототипова домаћина из LLD правила

Преузми све прототипове домаћина, њихове групне везе, прототипове група и ознаке из LLD правила.

Request:

{
            "jsonrpc": "2.0",
            "method": "hostprototype.get",
            "params": {
            "output": "extend",
            "selectInterfaces": "extend",
            "selectGroupLinks": "extend",
            "selectGroupPrototypes": "extend",
            "selectTags": "extend",
            "discoveryids": "23554"
            },
            "id": 1
       }

Одговор:

{
            "jsonrpc": "2.0",
            "result": [
            {
            "hostid": "10092",
            "host": "{#HV.UUID}",
            "name": "{#HV.UUID}",
            "status": "0",
            "templateid": "0",
            "discover": "0",
            "custom_interfaces": "1",
            "inventory_mode": "-1",
            "groupLinks": [
            {
            "group_prototypeid": "4",
            "hostid": "10092",
            "groupid": "7",
            "templateid": "0"
            }
            ],
            "groupPrototypes": [
            {
            "group_prototypeid": "7",
            "hostid": "10092",
            "name": "{#CLUSTER.NAME}",
            "templateid": "0"
            }
            ],
            "tags": [
            {
            "tag": "datacenter",
            "value": "{#DATACENTER.NAME}"
            },
            {
            "tag": "instance-type",
            "value": "{#INSTANCE_TYPE}"
            }
            ],
            "interfaces": [
            {
            "main": "1",
            "type": "2",
            "useip": "1",
            "ip": "127.0.0.1",
            "dns": "",
            "port": "161",
            "details": {
            "version": "2",
            "bulk": "1",
            "community": "{$SNMP_COMMUNITY}",
            "max_repetitions": "10"
            }
            }
            ]
            }
            ],
            "id": 1
       }

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

Извор

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