Zabbix Documentation 3.0

2.23.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.43.23.4

User Tools

Site Tools


Sidebar

ru:manual:api:reference:hostprototype:get

hostprototype.get

Описание

целое число/массив hostprototype.get(объект параметры)

Этот метод позволяет получать прототипы узлов сети в соответствии с заданными параметрами.

Параметры

(объект) Параметры задают желаемый вывод.

Этот метод поддерживает следующие параметры.

ПараметрТипОписание
hostids строка/массив Возврат прототипов узлов сети только с заданными ID.
discoveryids строка/массив Возврат только тех прототипов узлов сети, которые принадлежат заданным LLD правилам.
inherited логический Если задано значение true, возвращать только те прототипы элементов данных, которые унаследованы из шаблона.
selectDiscoveryRule запрос Возврат LLD правила, которому принадлежит прототип узлов сети, в свойстве discoveryRule.
selectGroupLinks запрос Возврат соединений с группами прототипа узлов сети в свойстве groupLinks.
selectGroupPrototypes запрос Возврат прототипов групп прототипа узлов сети в свойстве groupPrototypes.
selectInventory логический/массив Возврат данных инвентаризации прототипа узлов сети в свойстве inventory.

Возможными значениями являются true для получения всех данных или массив имен свойств для получения только указанных свойств.
selectParentHost запрос Возврат узла сети, которому принадлежит прототип узлов сети, в свойстве parentHost.
selectTemplates запрос Возврат шаблонов, которые соединены с прототипами узлов сети, в свойстве templates.
sortfield строка/массив Сортировка результата в соответствии с заданными свойствами.

Возможные значения: hostid, host, name и status.
countOutput флагЭти параметры являются общими для всех методов get и они описаны в справочных комментариях.
editable логический
excludeSearch флаг
filter объект
limit целое число
output запрос
preservekeys флаг
search объект
searchByAny логический
searchWildcardsEnabled логический
sortorder строка/массив
startSearch флаг

Возвращаемые значения

(целое число/массив) Возвращает либо:

  • массив объектов;
  • количество найденных объектов, если используется параметр countOutput.

Примеры

Получение прототипов узлов сети с LLD правила

Получение всех прототипов узлов сети и их соединий с группами и прототипы групп с LLD правила.

Запрос:

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

Ответ:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "hostid": "10092",
            "host": "{#HV.UUID}",
            "status": "0",
            "name": "{#HV.NAME}",
            "templateid": "0",
            "tls_connect": "1",
            "tls_accept": "1",
            "tls_issuer": "",
            "tls_subject": "",
            "tls_psk_identity": "",
            "tls_psk": "",
            "groupLinks": [
                {
                    "group_prototypeid": "4",
                    "hostid": "10092",
                    "groupid": "7",
                    "templateid": "0"
                }
            ],
            "groupPrototypes": [
                {
                    "group_prototypeid": "7",
                    "hostid": "10092",
                    "name": "{#CLUSTER.NAME}",
                    "templateid": "0"
                }
            ]
        }
    ],
    "id": 1
}

Смотрите также

Исходный код

CHostPrototype::get() в frontends/php/include/classes/api/services/CHostPrototype.php.