Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

host.update

Описание

объект host.update(объект/массив узлы сети)

Этот метод позволяет обновлять существующие узлы сети.

Параметры

(объект/массив) Свойства узлов сети, которые будут обновлены.

Свойство hostid должно быть указано по каждому узлу сети, все остальные свойства опциональны. Будут обновлены только переданные свойства, все остальные останутся неизменными.

В дополнение к стандартным свойствам узла сети, этот метод принимает следующие параметры.

Параметр Тип Описание
groups объект/массив Группы узлов сети, которые заменят текущие группы узлов сети в которые входят узлы сети.

У групп узлов сети должно быть задано свойство groupid.
interfaces объект/массив Интерфейсы узла сети, которые заменят текущие интерфейсы узла сети.
inventory объект Свойства инвентаризации узлов сети.
macros объект/массив Пользовательские макросы, которые заменят текущие макросы.
templates объект/массив Шаблоны, которые заменят присоединенные в настоящий момент шаблоны. Шаблоны, которые не переданы, только отсоединятся.

У шаблонов должно быть задано свойство templateid.
templates_clear объект/массив Шаблоны, которые отсоединятся и очистят узлы сети.

У шаблонов должно быть задано свойство templateid.

В отличие от Zabbix веб-интерфейса, когда name идентично host, обновление свойства host не означает автоматическое обновление name. Оба эти свойства необходимо обновить в явном виде.

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

(объект) Возвращает объект, который содержит ID обновленных узлов сети под свойством hostids.

Примеры

Активация узла сети

Активация мониторинга двух узлов, то есть изменение их состояния на значение 0.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10126",
               "status": 0
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10126"
               ]
           },
           "id": 1
       }

Отсоединение шаблонов

Отсоединение и очистка двух шаблонов с узла сети.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10126",
               "templates_clear": [
                   {
                       "templateid": "10124"
                   },
                   {
                       "templateid": "10125"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10126"
               ]
           },
           "id": 1
       }

Обновление макросов узла сети

Замена всех макросов узла сети на два новых.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10126",
               "macros": [
                   {
                       "macro": "{$PASS}",
                       "value": "password"
                   },
                   {
                       "macro": "{$DISC}",
                       "value": "sda"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10126"
               ]
           },
           "id": 1
       }

Обновление инвентаризации узла сети

Изменение режима инвентаризации и добавление местоположения

Запрос:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10387",
               "inventory_mode": 0,
               "inventory": {
                   "location": "Latvia, Riga"
               }
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10387"
               ]
           },
           "id": 2
       }

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

Updating host encryption

Update the host "10590" to use PSK encryption only for connections from host to Zabbix server, and change the PSK identity and PSK key. Note that the host has to be pre-configured to use PSK.

Request:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10590",
               "tls_connect": 1,
               "tls_accept": 2,
               "tls_psk_identity": "PSK 002",
               "tls_psk": "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10590"
               ]
           },
           "id": 1
       }

Исходный код

CHost::update() в frontends/php/include/classes/api/services/CHost.php.

Source

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