Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Utilisez l'opération [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) pour charger vos données. Grâce à cette opération, vous pouvez télécharger plusieurs entrées de données à la fois pour collecter des données provenant de plusieurs appareils et les envoyer en une seule demande.

**Important**  
L'[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)opération est soumise aux quotas suivants :   
Jusqu'à 10 [entrées](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html#API_BatchPutAssetPropertyValue_RequestSyntax) par demande.
Jusqu'à 10 [valeurs de propriété](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutAssetPropertyValueEntry.html#iotsitewise-Type-PutAssetPropertyValueEntry-propertyValues) (points de données TQV) par entrée. 
AWS IoT SiteWise rejette toutes les données dont l'horodatage date de plus de 7 jours dans le passé ou de plus de 10 minutes dans le futur.
 Pour de plus amples informations sur ces quotas, veuillez consulter [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) dans la *Référence de l'API AWS IoT SiteWise *.

Pour identifier une propriété d'actif, spécifiez l'une des options suivantes :
+ La `assetId` fin `propertyId` de la propriété de l'actif à laquelle les données sont envoyées.
+ Le`propertyAlias`, qui est un alias de flux de données (par exemple,`/company/windfarm/3/turbine/7/temperature`). Pour utiliser cette option, vous devez d'abord définir l'alias de votre propriété de ressource. Pour définir des alias de propriété, consultez[Gérez les flux de données pour AWS IoT SiteWise](manage-data-streams.md).

L'exemple suivant montre comment envoyer des lectures de température et de rotations par minute (RPM) d'une éolienne à partir d'une charge utile stockée dans un fichier JSON.

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

L'exemple de charge utile `batch-put-payload.json` contient le contenu suivant.

```
{
  "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"
        }
      ]
    }
  ]
}
```

La spécification « `enablePartialEntryProcessing` as » `true` permet l'ingestion de toutes les valeurs qui n'entraînent pas de défaillance. Le comportement par défaut est `false`. Si une valeur n'est pas valide, l'entrée entière échoue à être ingérée.

Chaque entrée de la charge utile contient un `entryId` que vous pouvez définir sous la forme d'une chaîne unique. Si des entrées de demande échouent, chaque erreur contiendra l'`entryId` de la demande correspondante afin que vous sachiez quelles demandes réessayer.

Chaque structure de la liste des `propertyValues` est une structure timestamp-quality-value (TQV) qui contient a `value``timestamp`, a et éventuellement a. `quality`
+ `value`— Structure contenant l'un des champs suivants, en fonction du type de propriété défini :
  + `booleanValue`
  + `doubleValue`
  + `integerValue`
  + `stringValue`
  + `nullValue`
+ `nullValue`— Une structure dont le champ suivant indique le type de la valeur de propriété avec la valeur Null et la qualité de `BAD` ou`UNCERTAIN`.
  + `valueType`— Enum de {"B », « D », « S », « I"}
+ `timestamp`— Une structure qui contient l'heure actuelle d'Unix en secondes,. `timeInSeconds` Vous pouvez également définir la `offsetInNanos` clé dans la `timestamp` structure si vous disposez de données temporellement précises. AWS IoT SiteWise rejette tous les points de données dont l'horodatage date de plus de 7 jours dans le passé ou de moins de 10 minutes dans le futur.
+ `quality`— (Facultatif) L'une des chaînes de qualité suivantes :
  + `GOOD`— (Par défaut) Les données ne sont affectées par aucun problème.
  + `BAD`— Les données sont affectées par un problème tel qu'une défaillance du capteur.
  + `UNCERTAIN`— Les données sont affectées par un problème tel que l'imprécision du capteur.

  Pour plus d'informations sur la gestion de AWS IoT SiteWise la qualité des données dans les calculs, consultez la section [Qualité des données dans les expressions de formule](expression-tutorials.md#data-quality).