[comment]: # translation:outdated

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

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

[comment]: # ({12e31652-12e31652})
### Descripción

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

Este método permite actualizar los grupos de hosts existentes.

::: noteclassic
Este método solo está disponible para los tipos de usuarios *Administrador* y *Superadministrador*. Los permisos para activar el método se pueden revocar en los ajustes de rol de usuario.
Ver [User  roles](/manual/web_interface/frontend_sections/administration/user_roles)
para más información.
:::

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

[comment]: # ({6727520a-3a8eac6a})
### Parámetros

`(object/array)` Propiedades del host que se actualizarán.

La propiedad `hostid` debe definirse para cada host, a todos los demás
las propiedades son opcionales. Sólo se actualizarán las propiedades dadas, todas
otras permanecerán sin cambios.

Sin embargo, tenga en cuenta que al actualizar el nombre técnico del host también se actualizará el nombre visible del host (si no está dado o está vacío) por el valor de nombre técnico del host.

Además de las [standard host properties](object#host), el método acepta los siguientes parámetros.

|Parámetro|[Tipo](/manual/api/reference_commentary#tipos_de_datos)|Descripción|
|--|--|------|
|groups|objeto/matriz|Host [grupos](/manual/api/reference/hostgroup/object#grupo_de_host) para reemplazar los grupos de hosts actuales a los que pertenece el host.<br><br>Los grupos de hosts deben tener la propiedad definida `groupid `. Todos los grupos de hosts que no figuran en la solicitud se desvincularán.|
|interfaces|objeto/matriz|Host [interfaces](/manual/api/reference/hostinterface/object) para reemplazar las interfaces de host actuales.<br><br>Se eliminarán todas las interfaces que no figuran en la solicitud.|
|tags|objeto/matriz|Host [etiquetas](/manual/api/reference/host/object#host_tag) para reemplazar las etiquetas de host actuales.<br><br>Se eliminarán todas las etiquetas que no aparezcan en la solicitud .|
|inventario|objeto|Propiedades del host [inventory](/manual/api/reference/host/object#inventario_de_host).|
|macros|objeto/matriz|[User macros](/manual/api/reference/usermacro/object) para reemplazar las macros de usuario actuales.<br><br>Se eliminarán todas las macros que no figuran en la solicitud.|
|templates|objeto/matriz|[Templates](/manual/api/reference/template/object) para reemplazar las templates actualmente vinculadas. Todas las templates que no figuran en la solicitud solo se desvincularán.<br><br>Las templates deben tener definida la propiedad `templateid`.|
|templates\_clear|objeto/matriz|[Templates](/manual/api/reference/template/object) para desvincular y borrar del host.<br><br>Las templates deben tener definida la propiedad `templateid`.|

::: notetip
A diferencia de la Zabbix Frontend, cuando "nombre" (visible
nombre de host) es el mismo que `host` (nombre de host técnico), actualizando `host`
a través de API no actualizará automáticamente el "nombre". Ambas propiedades deben ser actualizadas explícitamente.
:::

[comment]: # ({/6727520a-3a8eac6a})

[comment]: # ({d166b99b-d166b99b})
### Valores devueltos

`(object)` Devuelve un objeto que contiene los IDs de los hosts actualizados
bajo la propiedad `hostids`.

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

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

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

[comment]: # ({c3fe23f1-ce50c453})
#### Habilitando un host

Habilite el monitoreo del host, es decir, establezca su estado en "0".

Solicitud:

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

Respuesta:

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

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

[comment]: # ({f7b507a7-bea1db7e})
#### Desvincular templates

Desvincule y borrar dos templates del host. 

Solicitud:

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

Respuesta:

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

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

[comment]: # ({6e297824-98dcfd68})
#### Actualización de macros de host 

Reemplace todas las macros del host por dos nuevas. 

Solicitud:

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

Respuesta:

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

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

[comment]: # ({2a58e37a-da99f3b8})
#### Actualización del inventario de host

Cambie el modo de inventario y agregue ubicación

Solicitud:

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

Respuesta:

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

[comment]: # ({/2a58e37a-da99f3b8})

[comment]: # ({54c37e2f-5cc5d950})
#### Actualización de etiquetas de host 

Reemplace todas las etiquetas de host por una nueva.  

Solicitud:

```json
{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10387",
        "tags": {
            "tag": "OS",
            "value": "RHEL 7"
        }
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Respuesta:

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

[comment]: # ({/54c37e2f-5cc5d950})

[comment]: # ({6bea1aed-f2841bd8})
#### Actualización del cifrado del host 

Actualice el host "10590" para usar la PSK cifrada solo para conexiones desde el host al Zabbix server y cambie la identidad PSK y la clave PSK. 
Tenga en cuenta que el host debe estar [pre-configured to use PSK](/manual/encryption/using_pre_shared_keys#configurar-psk-para-ejemplo-de-comunicacion-de-agente-servidor).

Solicitud:

```json
{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10590",
        "tls_connect": 1,
        "tls_accept": 2,
        "tls_psk_identity": "PSK 002",
        "tls_psk": "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Respuesta:

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

[comment]: # ({/6bea1aed-f2841bd8})

[comment]: # ({29f34c97-23501347})
### Ver también

-   [host.massadd](massadd)
-   [host.massupdate](massupdate)
-   [host.massremove](massremove)
-   [Host group](/manual/api/reference/hostgroup/object#grupo_de_host)
-   [Template](/manual/api/reference/template/object#template)
-   [User macro](/manual/api/reference/usermacro/object#hosttemplate_nivel_macro)
-   [Host interface](/manual/api/reference/hostinterface/object#interfaz_de_host)
-   [Host inventory](object#inventario_de_host)
-   [Host tag](object#etiqueta_de_host)

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

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

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

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