# host.update

### Описание

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

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

### Параметры

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

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

В дополнение к [стандартным свойствам узла сети](object#узел_сети), этот
метод принимает следующие параметры.

|Параметр|Тип|Описание|
|----------------|------|----------------|
|groups|объект/массив|Группы узлов сети, которые заменят текущие группы узлов сети в которые входят узлы сети.<br><br>У групп узлов сети должно быть задано свойство `groupid`.|
|interfaces|объект/массив|Интерфейсы узла сети, которые заменят текущие интерфейсы узла сети.|
|inventory|объект|Свойства инвентаризации узлов сети.|
|macros|объект/массив|Пользовательские макросы, которые заменят текущие макросы.|
|templates|объект/массив|Шаблоны, которые заменят присоединенные в настоящий момент шаблоны. Шаблоны, которые не переданы, только отсоединятся.<br><br>У шаблонов должно быть задано свойство `templateid`.|
|templates\_clear|объект/массив|Шаблоны, которые отсоединятся и очистят узлы сети.<br><br>У шаблонов должно быть задано свойство `templateid`.|

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

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

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

### Примеры

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

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

Запрос:

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

Ответ:

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

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

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

Запрос:

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

Ответ:

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

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

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

Запрос:

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

Ответ:

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

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

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

Запрос:

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

Ответ:

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

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

-   [host.massadd](massadd)
-   [host.massupdate](massupdate)
-   [host.massremove](massremove)
-   [Группа узлов
    сети](/ru/manual/api/reference/hostgroup/object#группа_узлов_сети)
-   [Шаблон](/ru/manual/api/reference/template/object#шаблон)
-   [Пользовательский
    макрос](/ru/manual/api/reference/usermacro/object#макрос_узла_сети)
-   [Интерфейс узла
    сети](/ru/manual/api/reference/hostinterface/object#интерфейс_узла_сети)
-   [Инвентаризация узла сети](object#данные_инвентаризации_узлов_сети)

### Исходный код

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