[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]: # ({7c7a9b0d-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.

Veieu també que actualitzant el nom tècnic de l'equip també actualitzarà el nom visible de l'equip (si no s'ha donat o és buit) per el valor del nom tècnic de l'equip.

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>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]: # ({/7c7a9b0d-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]: # ({603ba164-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]: # ({/603ba164-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-f620e859})
#### 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-f620e859})

[comment]: # ({78cf261e-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)
-   [Proxy](/manual/api/reference/proxy/object#proxy)
-   [Grup de proxys](/manual/api/reference/proxygroup/object#proxy-group)

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

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

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

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