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

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

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

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

Aquest mètode permet actualitzar els equips existents.

::: noteclassic
Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

[comment]: # ({6727520a-3a8eac6a})
### Paràmetres

`(object/array)` Propietats de l'equip per actualitzar.

La propietat `hostid` s'ha d'establir per a cada equip, totes les altres propietats són opcionals. Només s'actualitzaran les propietats indicades, les altres romandran sense canvis.

A més de les [propietats de l'objecte equip estàndard] (objecte#host), el mètode admet els paràmetres següents.

|Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|groups|object/array|[Grups d'equips](/manual/api/reference/hostgroup/object#host_group) substituint els grups d'equips actuals als quals pertany l'equip.<br><br>Els grups d'equip han de tindre la propietat `groupid` conjunt. Tots els grups d'equip que no són pas a la petició es desenllaçaran.|
|interfaces|object/array|[Interfícies d'equips](/manual/api/reference/hostinterface/object) substituint les interfícies de l'equip actuals.<br><br>S'esborraran les interfícies que no són pas a la petició.|
|tags|object/array|[Etiquetes d'equips](/manual/api/reference/host/object#host_tag) substituint les etiquetes d'equip actuals.<br><br>S'esborraran totes etiquetes que no siguin pas a la petició.|
|inventory|object|Propietats de l'[inventari d'equip](/manual/api/reference/host/object#host_inventory) .|
|macros|object/array|[Macros d'usuari](/manual/api/reference/usermacro/object) que substitueixen les macros d'usuari actuals.<br><br>S'esborraran les macros que no són pas a la petició.|
|templates|object/array|[Plantilles](/manual/api/reference/template/object) substituint les plantilles enllaçades actualment. Totes les plantilles que no són pas a la petició es desenllaçaran.<br><br>Les plantilles han de tindre la propietat `templateid` establerta.|
|templates\_clear|object/array|[Templates](/manual/api/reference/template/object) per desenllaçar i esborrar de l'equip.<br><br>Les plantilles han de tenir la propietat `templateid` definida.

::: notetip
A diferència de la interfície de Zabbix, quan `name` (nom d'equip visible) és el mateix que `host` (nom d'equip tècnic), l'actualització de `host` mitjançant l'API no actualitzarà automàticament `name`. Les dues propietats s'han d'actualitzar explícitament.
:::

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

[comment]: # ({d166b99b-d166b99b})
### Valors de retorn

`(object)` Retorna un objecte contingut als IDs dels equips actualitzats sota la propietat `hostids`.

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

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

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

[comment]: # ({bcd7b728-ce50c453})
#### Activar un equip

Activa el monitoratge d'un equip; és a dir, defineix el seu estat a "0".

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

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

Resposta:

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

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

[comment]: # ({56f46465-bea1db7e})
#### Desenllaçar plantilles

Desenllaçar i netejar dues plantilles de l'equip.

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

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

Resposta:

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

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

[comment]: # ({b789e636-98dcfd68})
#### Actualitzar les macros d'equips

Reemplaça totes les macros d'equips per dues de noves.

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

Resposta:

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

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

[comment]: # ({72eb8ecc-da99f3b8})
#### Actualitzar l'inventari d'equips

Canvia el mode d'inventari i hi afegeix una ubicació

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

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

Resposta:

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

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

[comment]: # ({4a11868e-5cc5d950})
#### Actualitzar les etiquetes d'equips

Reemplaça totes les etiquetes d'un equip per una de nova.

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

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

Resposta:

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

[comment]: # ({/4a11868e-5cc5d950})

[comment]: # ({58eba4cd-ae2d89bf})
#### Actualitzar les macros d'equip descobertes

Converteix les regles de descobertes creades com a macro "automàtica" a "manual" i canvia el seu valor a "new-value".

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

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

Resposta:

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

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

[comment]: # ({1948c7c9-b4a9cd46})
#### Actualitzant el xifrat d'equip

Actualitzar l'equip "10590" per emprar el xifrat PSK només per a les connexions de l'equip al servidor Zabbix i canviar la identitat PSK i la clau PSK.
Tingueu en compte que l'equip ha d'ésser [preconfigurat per emprar PSK](/manual/encryption/using_pre_shared_keys#configuring-psk-for-server-agent-communication-example).

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

Resposta:

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

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

[comment]: # ({29f34c97-23501347})
### Veieu també

-   [host.massadd](massadd)
-   [host.massupdate](massupdate)
-   [host.massremove](massremove)
-   [Grup d'equip](/manual/api/reference/hostgroup/object#host_group)
-   [Plantilla](/manual/api/reference/template/object#template)
-   [Macro d'usuari](/manual/api/reference/usermacro/object#hosttemplate_level_macro)
-   [Interfície d'equip](/manual/api/reference/hostinterface/object#host_interface)
-   [Inventari d'equip](object#host_inventory)
-   [Etiqueta d'equip](object#host_tag)

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

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

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

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