[comment]: # ({59b410c0-59b410c0})
# hostinterface.update

[comment]: # ({/59b410c0-59b410c0})

[comment]: # ({ff3d5f77-253ed57f})
### Beschreibung

`object hostinterface.update(object/array hostInterfaces)`

Diese Methode ermöglicht die Aktualisierung bestehender Host-Schnittstellen.

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

[comment]: # ({/ff3d5f77-253ed57f})

[comment]: # ({cafa0d92-a99ac0ad})
### Parameter

`(object/array)` zu aktualisierende [Eigenschaften der Host-Schnittstelle](object#host-interface).

Die Eigenschaft `interfaceid` muss für jede Host-Schnittstelle definiert werden, alle anderen Eigenschaften sind optional. Nur die angegebenen Eigenschaften werden aktualisiert, alle anderen bleiben unverändert.

[comment]: # ({/cafa0d92-a99ac0ad})

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

`(object)` Gibt ein Objekt zurück, das die IDs der aktualisierten Host-Schnittstellen
unter der Eigenschaft `interfaceids` enthält.

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

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

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

[comment]: # ({d6135bbd-eb8b35e8})
#### Ändern eines Host-Schnittstellenports

Ändern Sie den Port einer Host-Schnittstelle.

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

```json
{
    "jsonrpc": "2.0",
    "method": "hostinterface.update",
    "params": {
        "interfaceid": "30048",
        "port": "30050"
    },
    "id": 1
}
```

Antwort:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "interfaceids": [
            "30048"
        ]
    },
    "id": 1
}
```

[comment]: # ({/d6135bbd-eb8b35e8})

[comment]: # ({97e4c8d0-97e4c8d0})
### Quelle

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

[comment]: # ({/97e4c8d0-97e4c8d0})