Table of Contents

host.update

host.update

Опис

object host.update(object/array hosts)

Овај метод омогућава ажурирање постојећих домаћина.

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

Параметри

(object/array) Својства домаћина која се ажурирају.

Својство хостид мора бити дефинисано за сваког домаћина, сва остала својства су опциона. Само дата својства ће бити ажурирана, сва остала ће остати непромењена. Имајте на уму, међутим, да ће ажурирање техничког имена домаћина такође ажурирати видљиво име домаћина (ако није дато или празно) вредности техничког имена домаћина.

Поред тога standard host properties, метода прихвата следеће параметре.

Parameter	Type	Опис
groups	object/array	Host groups за замену тренутних група домаћина којима домаћин припада. Све групе домаћина које нису наведене у захтеву биће прекинуте.<br > Групе домаћина морају имати дефинисано само својство `groupid`.
interfaces	object/array	Host interfaces да би се заменили тренутни интерфејси домаћина. Сви интерфејси који нису наведени у захтеву ће бити уклоњени.
tags	object/array	Host tags да би се замениле тренутне ознаке домаћина. Све ознаке које нису наведене у захтеву биће уклоњене.
inventory	object	Host inventory својства.
macros	object/array	User macros за замену макроа тренутног корисника. Сви макрои који нису наведени у захтеву биће уклоњени.
templates	object/array	Templates да замени тренутно повезане шаблоне. Сви шаблони који нису наведени у захтеву биће само прекинути. Шаблони морају имати само дефинисано својство `templateid` .
templates_clear	object/array	Templates за раскид везе и брисање са домаћина. Шаблони морају имати само својство `templateid` дефинисано.

За разлику од Zabbix корисничког интерфејса, када је name (име видљивог домаћина) исто што и host (техничко име домаћина), ажурирање hostа преко API-ја неће аутоматски ажурирати name. Оба својства треба експлицитно да се ажурирају.

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

(object) Враћа објекат који садржи ID-ијеве ажурираних домаћина испод својства hostids.

Примери

Омогућавање домаћина

Омогућите праћење домаћина, односно поставите његов статус на "0".

Request:

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

Одговор:

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

Ажурирање макроа домаћина

Замените све макрое домаћина са два нова.

Request:

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

Одговор:

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

Ажурирање макроа домаћина

Замените све макрое домаћина са два нова.

Request:

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

Одговор:

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

Ажурирање инвентара домаћина

Промените режим инвентара и додајте локацију

Request:

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

Одговор:

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

Ажурирање ознака домаћина

Замените све ознаке домаћина новим.

Request:

{
            "jsonrpc": "2.0",
            "method": "host.update",
            "params": {
            "hostid": "10387",
            "tags": {
            "tag": "os",
            "value": "rhel-7"
            }
            },
            "id": 1
       }

Одговор:

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

Ажурирање откривених макроа домаћина

Претворите креирани „аутоматски“ макро из правила откривања у „ручно“ и промените његову вредност у „нова вредност“.

Request:

{
            "jsonrpc": "2.0",
            "method": "host.update",
            "params": {
            "hostid": "10387",
            "macros": {
            "hostmacroid": "5541",
            "value": "new-value",
            "automatic": "0"
            }
            },
            "id": 1
       }

Одговор:

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

Ажурирање шифровања домаћина

Ажурирајте домаћина "10590" да користи PSK шифровање само за везе између домаћина и Zabbix сервера и промените PSK идентитет и PSK кључ. Имајте на уму да домаћин мора бити (/manual/encryption/using_pre_shared_keys#configuring-psk-for-server-agent-communication-example).

Request:

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

Одговор:

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

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

Извор

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

Documentation

host.update

Опис

Параметри

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

Примери

Омогућавање домаћина

Ажурирање макроа домаћина

Ажурирање макроа домаћина

Ажурирање инвентара домаћина

Ажурирање ознака домаћина

Ажурирање откривених макроа домаћина

Ажурирање шифровања домаћина

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

Извор