Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# BatchPutAssetPropertyValue API
<a name="ingest-api-batch-putasset"></a>

Utilizzare l'operazione [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) per caricare i dati. Con questa operazione, puoi caricare più immissioni di dati alla volta per raccogliere dati da più dispositivi e inviarli tutti in un'unica richiesta.

**Importante**  
L'[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)operazione è soggetta alle seguenti quote:   
Fino a 10 [iscrizioni](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html#API_BatchPutAssetPropertyValue_RequestSyntax) per richiesta.
Fino a 10 [valori di proprietà](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutAssetPropertyValueEntry.html#iotsitewise-Type-PutAssetPropertyValueEntry-propertyValues) (punti dati TQV) per ingresso. 
AWS IoT SiteWise rifiuta tutti i dati con un timestamp datato a più di 7 giorni nel passato o a più di 10 minuti nel futuro.
 Per ulteriori informazioni su queste quote, consulta la voce [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) nella *documentazione di riferimento delle API di AWS IoT SiteWise *.

Per identificare la proprietà di una risorsa, specificate una delle seguenti opzioni:
+ La proprietà `assetId` e `propertyId` della risorsa a cui vengono inviati i dati.
+ Il`propertyAlias`, che è un alias del flusso di dati (ad esempio,`/company/windfarm/3/turbine/7/temperature`). Per utilizzare questa opzione, è necessario prima impostare l'alias della proprietà dell'asset. Per impostare gli alias delle proprietà, vedere. [Gestisci i flussi di dati per AWS IoT SiteWise](manage-data-streams.md)

L'esempio seguente illustra come inviare le letture della temperatura e delle rotazioni al minuto (RPM) di una turbina eolica da un payload archiviato in un file JSON.

```
aws iotsitewise batch-put-asset-property-value --cli-input-json file://batch-put-payload.json
```

Il payload in di esempio `batch-put-payload.json` ha il seguente contenuto.

```
{
  "enablePartialEntryProcessing": true,      
  "entries": [
    {
      "entryId": "{{unique entry ID}}",
      "propertyAlias": "/company/windfarm/3/turbine/7/temperature",
      "propertyValues": [
        {
          "value": {
            "integerValue": 38
          },
          "timestamp": {
            "timeInSeconds": 1575691200
          }
        }
      ]
    },
    {
      "entryId": "{{unique entry ID}}",
      "propertyAlias": "/company/windfarm/3/turbine/7/rpm",
      "propertyValues": [
        {
          "value": {
            "doubleValue": 15.09
          },
          "timestamp": {
            "timeInSeconds": 1575691200
          },
          "quality": "GOOD"
        }
      ]
    },
    {
  "entryId": "unique entry ID",
      "propertyAlias": "/company/windfarm/3/turbine/7/rpm",
      "propertyValues": [
        {
  "value": {
  "nullValue":{"valueType": "D"}
          },
          "timestamp": {
  "timeInSeconds": 1575691200
          },
          "quality": "BAD"
        }
      ]
    }
  ]
}
```

Specificando `enablePartialEntryProcessing` as è `true` possibile l'ingestione di tutti i valori che non provocano errori. Il comportamento predefinito è `false`. Se un valore non è valido, l'intera voce non viene inserita.

Ogni voce nel payload contiene un `entryId` che è possibile definire come una qualsiasi stringa univoca. Se una richiesta non riesce, ciascun errore conterrà l'`entryId` della richiesta corrispondente in modo che sia possibile sapere quale richiesta riprovare.

Ogni struttura nell'elenco di `propertyValues` è una struttura timestamp-quality-value (TQV) che contiene a`value`, a e facoltativamente a`timestamp`. `quality`
+ `value`— Una struttura che contiene uno dei seguenti campi, a seconda del tipo di proprietà impostata:
  + `booleanValue`
  + `doubleValue`
  + `integerValue`
  + `stringValue`
  + `nullValue`
+ `nullValue`— Una struttura con il seguente campo che indica il tipo di valore della proprietà con valore Null e qualità o. `BAD` `UNCERTAIN`
  + `valueType`— Enumerazione di {"B», «D», «S», «I"}
+ `timestamp`— Una struttura che contiene l'ora attuale dell'epoca Unix in secondi,. `timeInSeconds` È inoltre possibile impostare la `offsetInNanos` chiave nella `timestamp` struttura se si dispone di dati temporalmente precisi. AWS IoT SiteWise rifiuta tutti i punti dati con timestamp più vecchi di 7 giorni nel passato o più recenti di 10 minuti nelle future.
+ `quality`— (Facoltativo) Una delle seguenti stringhe di qualità:
  + `GOOD`— (Impostazione predefinita) I dati non sono interessati da alcun problema.
  + `BAD`— I dati sono interessati da un problema, ad esempio un guasto del sensore.
  + `UNCERTAIN`— I dati sono influenzati da un problema come l'imprecisione del sensore.

  Per ulteriori informazioni su come AWS IoT SiteWise gestisce la qualità dei dati nei calcoli, vedi [Qualità dei dati nelle espressioni di formule](expression-tutorials.md#data-quality).