[comment]: # translation:outdated

[comment]: # ({3466d178-389b3928})
# history.push

[comment]: # ({/3466d178-389b3928})

[comment]: # ({5e478835-a90ea165})
#### Descrizione

`object history.push(object/array itemHistoryData)`

Questo metodo consente di inviare i dati dello storico degli elementi al server Zabbix.

::: noteclassic
Questo metodo è disponibile per utenti di qualsiasi tipo.
I permessi per chiamare il metodo possono essere revocati nelle impostazioni dei ruoli utente.
Consultare [Ruoli utente](/manual/web_interface/frontend_sections/users/user_roles) per ulteriori informazioni.
:::

[comment]: # ({/5e478835-a90ea165})

[comment]: # ({fecb3622-e0163c70})
#### Parametri

`(object/array)` Dati della cronologia degli item da inviare.

Il metodo supporta i seguenti parametri.

|Parametro|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|itemid|ID|ID dell'item correlato.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se `host` e `key` non sono impostati|
|host|string|Nome tecnico del host.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se `itemid` non è impostato|
|key|string|Chiave dell'item.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se `itemid` non è impostato|
|value|mixed|Valore dell'item.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio*|
|clock|timestamp|Ora in cui il valore è stato ricevuto.|
|ns|integer|Nanosecondi in cui il valore è stato ricevuto.|

[comment]: # ({/fecb3622-e0163c70})

[comment]: # ({a55f92a5-d10d10b9})
#### Valori restituiti

`(oggetto)` Restituisce il risultato dell'operazione di invio dei dati.

[comment]: # ({/a55f92a5-d10d10b9})

[comment]: # ({4c860844-6892d8c2})
#### Esempi

[comment]: # ({/4c860844-6892d8c2})

[comment]: # ({b319fb61-c6721628})
##### Invia i dati dello storico degli elementi

Invia i dati dello storico degli elementi al server Zabbix per gli elementi "10600", "10601" e "999999".

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

```json
{
"jsonrpc": "2.0",
"method": "history.push",
"params": [
{
"itemid": 10600,
"value": 0.5,
"clock": 1690891294,
"ns": 45440940
},
{
"itemid": 10600,
"value": 0.6,
"clock": 1690891295,
"ns": 312431
},
{
"itemid": 10601,
"value": "[Tue Aug 01 15:01:35 2023] [error] [client 1.2.3.4] File does not exist: /var/www/html/robots.txt"
},
{
"itemid": 999999,
"value": 123
}
],
"id": 1
}
```

Risposta:

```json
{
"jsonrpc": "2.0",
"result": {
"response": "success",
"data": [
{
"itemid": "10600"
},
{
"itemid": "10600"
},
{
"itemid": "10601",
"error": "Item is disabled."
},
{
"error": "No permissions to referred object or it does not exist."
}
]
},
"id": 1
}
```

[comment]: # ({/b319fb61-c6721628})

[comment]: # ({57c06937-f4799610})
#### Vedi anche

- [Elementi Trapper](/manual/config/items/itemtypes/trapper#sending-data)
- [HTTP agent](/manual/config/items/itemtypes/http) elementi
- [Host](/manual/api/reference/host/object#host)
- [Elemento](/manual/api/reference/item/object#item)

[comment]: # ({/57c06937-f4799610})

[comment]: # ({7e832fdb-b99de764})
#### Sorgente

CHistory::push() in *ui/include/classes/api/services/CHistory.php*.

[comment]: # ({/7e832fdb-b99de764})