Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

Verwenden Sie die [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)-Operation, um Ihre Daten hochzuladen. Mit diesem Vorgang können Sie mehrere Dateneinträge gleichzeitig hochladen, um Daten von mehreren Geräten zu sammeln und alles in einer einzigen Anfrage zu senden.

**Wichtig**  
Der [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)Vorgang unterliegt den folgenden Kontingenten:   
Bis zu 10 [Einträge](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html#API_BatchPutAssetPropertyValue_RequestSyntax) pro Anfrage.
Bis zu 10 [Eigenschaftswerte](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutAssetPropertyValueEntry.html#iotsitewise-Type-PutAssetPropertyValueEntry-propertyValues) (TQV-Datenpunkte) pro Eintrag. 
AWS IoT SiteWise lehnt alle Daten ab, deren Zeitstempel mehr als 7 Tage in der Vergangenheit oder mehr als 10 Minuten in der future liegt.
 Weitere Informationen zu diesen Kontingenten finden Sie unter [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) in der*AWS IoT SiteWise -API-Referenz*.

Um eine Vermögenseigenschaft zu identifizieren, geben Sie eine der folgenden Optionen an:
+ Das `assetId` Ende `propertyId` der Anlageneigenschaft, an die Daten gesendet werden.
+ The`propertyAlias`, bei dem es sich um einen Datenstream-Alias handelt (z. B.`/company/windfarm/3/turbine/7/temperature`). Um diese Option verwenden zu können, müssen Sie zuerst den Alias der Komponenteneigenschaft festlegen. Informationen zum Festlegen von Eigenschaftsaliasnamen finden Sie unter[Datenströme verwalten für AWS IoT SiteWise](manage-data-streams.md).

Im folgenden Beispiel wird veranschaulicht, wie die Messwerte einer Windkraftanlage für die Temperatur und die Umdrehungen pro Minute (U/min) aus Nutzlasten, die in einer JSON-Datei gespeichert sind, gesendet werden.

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

Die Beispiel-Payload in `batch-put-payload.json` hat den folgenden Inhalt.

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

Wenn Sie `enablePartialEntryProcessing` als angeben, `true` können alle Werte aufgenommen werden, die nicht zu einem Fehler führen. Das Standardverhalten ist `false`. Wenn ein Wert ungültig ist, schlägt die Aufnahme des gesamten Eintrags fehl.

Jeder Eintrag in der Nutzlast enthält eine `entryId`, die Sie als eindeutige Zeichenfolge definieren können. Bei fehlgeschlagenen Anforderungseinträgen enthält jeder Fehler die `entryId` der entsprechenden Anforderung, woran Sie erkennen können, welche Anforderungen zu wiederholen sind.

Jede Struktur in der Liste von `propertyValues` ist eine timestamp-quality-value (TQV-) Struktur, die a`value`, a und optional a `timestamp` enthält. `quality`
+ `value`— Eine Struktur, die je nach Typ der festzulegenden Eigenschaft eines der folgenden Felder enthält:
  + `booleanValue`
  + `doubleValue`
  + `integerValue`
  + `stringValue`
  + `nullValue`
+ `nullValue`— Eine Struktur mit dem folgenden Feld, das den Typ des Eigenschaftswerts mit dem Wert Null und der `BAD` Qualität oder bezeichnet. `UNCERTAIN`
  + `valueType`— Aufzählung von {"B“, „D“, „S“, „I"}
+ `timestamp`— Eine Struktur, die die aktuelle Unix-Epochenzeit in Sekunden enthält,. `timeInSeconds` Sie können den `offsetInNanos` Schlüssel auch in der `timestamp` Struktur angeben, wenn Sie über zeitlich genaue Daten verfügen. AWS IoT SiteWise lehnt alle Datenpunkte ab, deren Zeitstempel älter als 7 Tage in der Vergangenheit oder neuer als 10 Minuten in der future sind.
+ `quality`— (Optional) Eine der folgenden Qualitätszeichenfolgen:
  + `GOOD`— (Standard) Die Daten sind von keinen Problemen betroffen.
  + `BAD`— Die Daten sind von einem Problem wie einem Sensorausfall betroffen.
  + `UNCERTAIN`— Die Daten sind von einem Problem wie einer Sensorungenauigkeit betroffen.

  Weitere Informationen zum AWS IoT SiteWise Umgang mit Datenqualität bei Berechnungen finden Sie unter [Datenqualität in Formelausdrücken](expression-tutorials.md#data-quality).