Documentation
Table of Contents
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",
"method": "host.update",
"params": {
"hostid": "10126",
"templates_clear": [
{
"templateid": "10124"
},
{
"templateid": "10125"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"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",
"method": "host.update",
"params": {
"hostid": "10387",
"inventory_mode": 0,
"inventory": {
"location": "Latvia, Riga"
}
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Ответ:
Смотрите также
- host.massadd
- host.massupdate
- host.massremove
- Группа узлов сети
- Шаблон
- Пользовательский макрос
- Интерфейс узла сети
- Инвентаризация узла сети
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:
Исходный код
CHost::update() в frontends/php/include/classes/api/services/CHost.php.
Source
CHost::update() in ui/include/classes/api/services/CHost.php.