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

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

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

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

Mit dieser Methode können vorhandene Hosts aktualisiert werden.

::: noteclassic
Diese Methode ist nur für die Benutzertypen *Admin* und *Super admin*
verfügbar. Die Berechtigung zum Aufrufen der Methode kann in den
Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen
finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

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

`(object/array)` Zu aktualisierende Host-Eigenschaften.

Die Eigenschaft `hostid` muss für jeden Host definiert sein, alle anderen
Eigenschaften sind optional. Nur die angegebenen Eigenschaften werden aktualisiert, alle
anderen bleiben unverändert.

Beachten Sie jedoch, dass die Aktualisierung des technischen Host-Namens auch den
sichtbaren Namen des Hosts auf den Wert des technischen Host-Namens aktualisiert
(falls er nicht separat angegeben wird).

Zusätzlich zu den [standardmäßigen Host-Eigenschaften](object#host) akzeptiert die Methode
die folgenden Parameter.

|Parameter|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|groups|object/array|[Host-Gruppen](/manual/api/reference/hostgroup/object#host-group), die die aktuellen Host-Gruppen ersetzen, denen der Host angehört.<br>Alle Host-Gruppen, die nicht in der Anfrage aufgeführt sind, werden getrennt.<br><br>Für die Host-Gruppen darf nur die Eigenschaft `groupid` definiert sein.|
|interfaces|object/array|[Host-Schnittstellen](/manual/api/reference/hostinterface/object), die die aktuellen Host-Schnittstellen ersetzen.<br>Alle Schnittstellen, die nicht in der Anfrage aufgeführt sind, werden entfernt.|
|tags|object/array|[Host-Tags](/manual/api/reference/host/object#host-tag), die die aktuellen Host-Tags ersetzen.<br>Alle Tags, die nicht in der Anfrage aufgeführt sind, werden entfernt.|
|inventory|object|Eigenschaften des [Host-Inventars](/manual/api/reference/host/object#host-inventory).|
|macros|object/array|[Benutzermakros](/manual/api/reference/usermacro/object), die die aktuellen Benutzermakros ersetzen.<br>Alle Makros, die nicht in der Anfrage aufgeführt sind, werden entfernt.|
|templates|object/array|[Vorlagen](/manual/api/reference/template/object), die die aktuell verknüpften Vorlagen ersetzen.<br>Alle Vorlagen, die nicht in der Anfrage aufgeführt sind, werden nur getrennt.<br><br>Für die Vorlagen darf nur die Eigenschaft `templateid` definiert sein.|
|templates\_clear|object/array|[Vorlagen](/manual/api/reference/template/object), die vom Host getrennt und daraus entfernt werden.<br><br>Für die Vorlagen darf nur die Eigenschaft `templateid` definiert sein.|

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

[comment]: # ({d166b99b-d166b99b})
### Rückgabewerte

`(object)` Gibt ein Objekt zurück, das die IDs der aktualisierten Hosts
unter der Eigenschaft `hostids` enthält.

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

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

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

[comment]: # ({bcd7b728-ce50c453})
#### Aktivieren eines Hosts

Aktivieren Sie die Überwachung des Hosts, d. h. setzen Sie seinen Status auf „0“.

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

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

Antwort:

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

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

[comment]: # ({56f46465-bea1db7e})
#### Verknüpfung von Vorlagen aufheben

Heben Sie die Verknüpfung von zwei Vorlagen mit dem Host auf und löschen Sie sie.

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

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

Antwort:

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

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

[comment]: # ({b789e636-98dcfd68})
#### Host-Makros aktualisieren

Ersetzen Sie alle Host-Makros durch zwei neue.

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

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

Antwort:

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

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

[comment]: # ({72eb8ecc-da99f3b8})
#### Host-Inventar aktualisieren

Inventarmodus ändern und Standort hinzufügen

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

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

Antwort:

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

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

[comment]: # ({603ba164-5cc5d950})
#### Aktualisieren von Host-Tags

Ersetzen Sie alle Host-Tags durch ein neues.

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

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

Antwort:

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

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

[comment]: # ({58eba4cd-ae2d89bf})
#### Aktualisieren entdeckter Host-Makros

Wandeln Sie das von der Discovery-Regel erstellte „automatische“ Makro in ein „manuelles“ um und ändern Sie seinen Wert in „new-value“.

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

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

Antwort:

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

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

[comment]: # ({1948c7c9-f620e859})
#### Aktualisieren der Host-Verschlüsselung

Aktualisieren Sie den Host „10590“ so, dass für Verbindungen vom Host zum Zabbix-Server nur PSK-Verschlüsselung verwendet wird, und ändern Sie die PSK-Identität sowie den PSK-Schlüssel.
Beachten Sie, dass der Host [für die Verwendung von PSK vorkonfiguriert sein muss](/manual/encryption/using_pre_shared_keys#configuring-psk-for-server-agent-communication-example).

[Anfrage](/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
}
```

Antwort:

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

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

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

-   [host.massadd](massadd)
-   [host.massupdate](massupdate)
-   [host.massremove](massremove)
-   [Host group](/manual/api/reference/hostgroup/object#host-group)
-   [Vorlage](/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]: # ({/78cf261e-23501347})

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

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

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