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

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

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

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

Ta metoda umożliwia aktualizację istniejących hostów.

::: noteclassic
Ta metoda jest dostępna tylko dla typów użytkowników *Admin* i *Super admin*.
Uprawnienia do wywołania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika.
Więcej informacji można znaleźć w sekcji [User
roles](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

[comment]: # ({7c7a9b0d-3a8eac6a})
### Parametry

`(object/array)` Właściwości hosta do zaktualizowania.

Właściwość `hostid` musi być zdefiniowana dla każdego hosta, wszystkie pozostałe
właściwości są opcjonalne. Zaktualizowane zostaną tylko podane właściwości, wszystkie
pozostałe pozostaną bez zmian.

Należy jednak pamiętać, że aktualizacja technicznej nazwy hosta spowoduje również aktualizację
widocznej nazwy hosta (jeśli nie została podana osobno) na wartość technicznej
nazwy hosta.

Oprócz [standardowych właściwości hosta](object#host), metoda
akceptuje następujące parametry.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|groups|object/array|[Grupy hostów](/manual/api/reference/hostgroup/object#host-group) zastępujące bieżące grupy hostów, do których należy host.<br>Wszystkie grupy hostów, które nie zostały wymienione w żądaniu, zostaną odłączone.<br><br>Grupy hostów muszą mieć zdefiniowaną wyłącznie właściwość `groupid`.|
|interfaces|object/array|[Interfejsy hosta](/manual/api/reference/hostinterface/object) zastępujące bieżące interfejsy hosta.<br>Wszystkie interfejsy, które nie zostały wymienione w żądaniu, zostaną usunięte.|
|tags|object/array|[Tagi hosta](/manual/api/reference/host/object#host-tag) zastępujące bieżące tagi hosta.<br>Wszystkie tagi, które nie zostały wymienione w żądaniu, zostaną usunięte.|
|inventory|object|Właściwości [inwentarza hosta](/manual/api/reference/host/object#host-inventory).|
|macros|object/array|[Makra użytkownika](/manual/api/reference/usermacro/object) zastępujące bieżące makra użytkownika.<br>Wszystkie makra, które nie zostały wymienione w żądaniu, zostaną usunięte.|
|templates|object/array|[Szablony](/manual/api/reference/template/object) zastępujące aktualnie podłączone szablony.<br>Wszystkie szablony, które nie zostały wymienione w żądaniu, zostaną jedynie odłączone.<br><br>Szablony muszą mieć zdefiniowaną wyłącznie właściwość `templateid`.|
|templates\_clear|object/array|[Szablony](/manual/api/reference/template/object) do odłączenia i wyczyszczenia z hosta.<br><br>Szablony muszą mieć zdefiniowaną wyłącznie właściwość `templateid`.|

[comment]: # ({/7c7a9b0d-3a8eac6a})

[comment]: # ({d166b99b-d166b99b})
### Zwracane wartości

`(object)` Zwraca obiekt zawierający identyfikatory zaktualizowanych hostów
we właściwości `hostids`.

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

[comment]: # ({b41637d2-b41637d2})
### Przykłady

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

[comment]: # ({bcd7b728-ce50c453})
#### Włączanie monitorowania hosta

Włącz monitorowanie hosta, czyli ustaw jego status na „0”.

[Żądanie](/manual/api#performing-requests):

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

Odpowiedź:

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

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

[comment]: # ({56f46465-bea1db7e})
#### Odłączanie szablonów

Odłącz i wyczyść dwa szablony z hosta.

[Żądanie](/manual/api#performing-requests):

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

Odpowiedź:

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

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

[comment]: # ({b789e636-98dcfd68})
#### Aktualizowanie makr hosta

Zastąp wszystkie makra hosta dwoma nowymi.

[Żądanie](/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
}
```

Odpowiedź:

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

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

[comment]: # ({72eb8ecc-da99f3b8})
#### Aktualizowanie inwentarza hosta

Zmień tryb inwentarza i dodaj lokalizację

[Żądanie](/manual/api#performing-requests):

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

Odpowiedź:

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

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

[comment]: # ({603ba164-5cc5d950})
#### Aktualizowanie tagów hosta

Zastąp wszystkie tagi hosta nowym tagiem.

[Żądanie](/manual/api#performing-requests):

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

Odpowiedź:

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

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

[comment]: # ({58eba4cd-ae2d89bf})
#### Aktualizowanie makr wykrytego hosta

Przekształć makro utworzone przez regułę wykrywania z trybu „automatic” na „manual” i zmień jego wartość na „new-value”.

[Żądanie](/manual/api#performing-requests):

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

Odpowiedź:

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

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

[comment]: # ({1948c7c9-f620e859})
#### Aktualizacja szyfrowania hosta

Zaktualizuj host „10590”, aby używał wyłącznie szyfrowania PSK dla połączeń z hosta do serwera Zabbix, oraz zmień tożsamość PSK i klucz PSK.
Zwróć uwagę, że host musi być [wstępnie skonfigurowany do używania PSK](/manual/encryption/using_pre_shared_keys#configuring-psk-for-server-agent-communication-example).

[Żądanie](/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
}
```

Odpowiedź:

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

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

[comment]: # ({78cf261e-23501347})
### Zobacz także

-   [host.massadd](massadd)
-   [host.massupdate](massupdate)
-   [host.massremove](massremove)
-   [Grupa hostów](/manual/api/reference/hostgroup/object#host-group)
-   [Szablon](/manual/api/reference/template/object#template)
-   [Makro użytkownika](/manual/api/reference/usermacro/object#hosttemplate-level-macro)
-   [Interfejs hosta](/manual/api/reference/hostinterface/object#host-interface)
-   [Inwentarz hosta](object#host-inventory)
-   [Tag hosta](object#host-tag)
-   [Proxy](/manual/api/reference/proxy/object#proxy)
-   [Grupa proxy](/manual/api/reference/proxygroup/object#proxy-group)

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

[comment]: # ({a39b5a01-a39b5a01})
### Źródło

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

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