[comment]: # translation:outdated

[comment]: # ({c572a02a-c572a02a})
# host.update

[comment]: # ({/c572a02a-c572a02a})

[comment]: # ({a740c7d4-12e31652})
### Опис

`object host.update(object/array hosts)`

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

::: noteclassic
Ова метода је доступна само типовима *Админ* и *Супер админ*корисника. Дозволе за позивање методе могу се опозвати у подешавањима улога корисника. Погледајте [Userroles](/manual/web_interface/frontend_sections/users/user_roles) за више информација.
:::

[comment]: # ({/a740c7d4-12e31652})

[comment]: # ({561462a1-3a8eac6a})
### Параметри

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

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

Поред тога [standard host properties](object#host), метода прихвата следеће параметре.

|Parameter|[Type](/manual/api/reference_commentary#data_types)|Опис|
|--|--|------|
|groups|object/array|[Host groups](/manual/api/reference/hostgroup/object#host_group) за замену тренутних група домаћина којима домаћин припада.<br>Све групе домаћина које нису наведене у захтеву биће прекинуте.<br ><br>Групе домаћина морају имати дефинисано само својство `groupid `.|
|interfaces|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) да би се заменили тренутни интерфејси домаћина.<br>Сви интерфејси који нису наведени у захтеву ће бити уклоњени.|
|tags|object/array|[Host tags](/manual/api/reference/host/object#host_tag)  да би се замениле тренутне ознаке домаћина.<br> Све ознаке које нису наведене у захтеву биће уклоњене.|
|inventory|object|[Host inventory](/manual/api/reference/host/object#host_inventory) својства.|
|macros|object/array|[User macros](/manual/api/reference/usermacro/object)  за замену макроа тренутног корисника.<br>Сви макрои који нису наведени у захтеву биће уклоњени.|
|templates|object/array|[Templates](/manual/api/reference/template/object) да замени тренутно повезане шаблоне.<br>Сви шаблони који нису наведени у захтеву биће само прекинути.<br><br>Шаблони морају имати само дефинисано својство `templateid` .|
|templates\_clear|object/array|[Templates](/manual/api/reference/template/object)  за раскид везе и брисање са домаћина.<br><br>Шаблони морају имати само својство `templateid` дефинисано.|

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

[comment]: # ({/561462a1-3a8eac6a})

[comment]: # ({d166b99b-d166b99b})
### Повратне вредности

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

[comment]: # ({/d166b99b-d166b99b})

[comment]: # ({b41637d2-b41637d2})
### Примери

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({bcd7b728-ce50c453})
#### Омогућавање домаћина

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

[Request](/manual/api#performing-requests):

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

Одговор:

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

[comment]: # ({/bcd7b728-ce50c453})

[comment]: # ({56f46465-bea1db7e})
#### Ажурирање макроа домаћина

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

[Request](/manual/api#performing-requests):

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

Одговор:

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

[comment]: # ({/56f46465-bea1db7e})

[comment]: # ({b789e636-98dcfd68})
#### Ажурирање макроа домаћина

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

[Request](/manual/api#performing-requests):

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

Одговор:

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

[comment]: # ({/b789e636-98dcfd68})

[comment]: # ({72eb8ecc-da99f3b8})
#### Ажурирање инвентара домаћина

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

[Request](/manual/api#performing-requests):

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

Одговор:

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

[comment]: # ({/72eb8ecc-da99f3b8})

[comment]: # ({603ba164-5cc5d950})
#### Ажурирање ознака домаћина

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

[Request](/manual/api#performing-requests):

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

Одговор:

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

[comment]: # ({/603ba164-5cc5d950})

[comment]: # ({58eba4cd-ae2d89bf})
#### Ажурирање откривених макроа домаћина

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

[Request](/manual/api#performing-requests):

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

Одговор:

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

[comment]: # ({/58eba4cd-ae2d89bf})

[comment]: # ({1948c7c9-f620e859})
#### Ажурирање шифровања домаћина

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

[Request](/manual/api#performing-requests):

```json
{
     "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
}
```

Одговор:

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

[comment]: # ({/1948c7c9-f620e859})

[comment]: # ({d6a6f0dd-23501347})
### Такође погледајте

- [host.massadd](massadd)
- [host.massupdate](massupdate)
- [host.massremove](massremove)
- [Host group](/manual/api/reference/hostgroup/object#host_group)
- [Template](/manual/api/reference/template/object#template)
- [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro)
- [Host interface](/manual/api/reference/hostinterface/object#host_interface)
- [Host inventory](object#host_inventory)
- [Host tag](object#host_tag)
- [Proxy](/manual/api/reference/proxy/object#proxy)
- [Proxy group](/manual/api/reference/proxygroup/object#proxy_group)

[comment]: # ({/d6a6f0dd-23501347})

[comment]: # ({a39b5a01-a39b5a01})
### Извор

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

[comment]: # ({/a39b5a01-a39b5a01})