

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.

# Daten aufnehmen mit AWS IoT SiteWise APIs
<a name="ingest-api"></a>

Verwenden Sie diese AWS IoT SiteWise APIs Option, um Industriedaten mit Zeitstempel an die Attribut- und Messeigenschaften Ihrer Anlagen zu senden. Der APIs akzeptiert Strukturen, die Nutzdaten enthalten timestamp-quality-value (TQV).

# 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 \$1"B“, „D“, „S“, „I"\$1
+ `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).

# CreateBulkImportJob API
<a name="ingest-bulkImport"></a>

Verwenden Sie die `CreateBulkImportJob` API, um große Datenmengen aus Amazon S3 zu importieren. Ihre Daten müssen im CSV-Format in Amazon S3 gespeichert werden. Datendateien können die folgenden Spalten haben.

**Anmerkung**  
 Daten, die älter als der 1. Januar 1970 00:00:00 UTC sind, werden nicht unterstützt.   
Um eine Vermögenseigenschaft zu identifizieren, geben Sie eine der folgenden Optionen an.  
Das `ASSET_ID` Ende `PROPERTY_ID` der Anlageneigenschaft, an die Sie Daten senden.
The`ALIAS`, 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. Weitere Informationen zur Festlegung von Eigenschaftsaliasnamen finden Sie unter [Datenströme verwalten für AWS IoT SiteWise](manage-data-streams.md).
+ `ALIAS`— Der Alias, der die Eigenschaft identifiziert, z. B. ein Datenstream-Pfad eines OPC UA-Servers (zum Beispiel`/company/windfarm/3/turbine/7/temperature`). Weitere Informationen finden Sie unter [Datenströme verwalten für AWS IoT SiteWise](manage-data-streams.md).
+ `ASSET_ID`— Die ID des Assets.
+ `PROPERTY_ID`— Die ID der Anlageeigenschaft.
+ `DATA_TYPE`— Der Datentyp der Eigenschaft kann einer der folgenden sein.
  + `STRING`— Eine Zeichenfolge mit bis zu 1024 Byte.
  + `INTEGER`— Eine 32-Bit-Ganzzahl mit Vorzeichen im Bereich [-2.147.483.648, 2.147.483.647].
  + `DOUBLE`— Eine Fließkommazahl mit einem Bereich [-10^100, 10^100] und einer doppelten IEEE-754-Genauigkeit.
  + `BOOLEAN`— `true` oder. `false`
+ `TIMESTAMP_SECONDS`— Der Zeitstempel des Datenpunkts in der Unix-Epochenzeit.
+ `TIMESTAMP_NANO_OFFSET`— Der Nanosekunden-Offset, aus dem konvertiert wurde. `TIMESTAMP_SECONDS`
+ `QUALITY`— (Fakultativ) Die Qualität des Vermögenswerts. Der Wert kann einer der folgenden sein.
  + `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).
+ `VALUE`— Der Wert der Vermögenseigenschaft.

**Example Datendatei (en) im CSV-Format**  

```
asset_id,property_id,DOUBLE,1635201373,0,GOOD,1.0
asset_id,property_id,DOUBLE,1635201374,0,GOOD,2.0
asset_id,property_id,DOUBLE,1635201375,0,GOOD,3.0
```

```
unmodeled_alias1,DOUBLE,1635201373,0,GOOD,1.0
unmodeled_alias1,DOUBLE,1635201374,0,GOOD,2.0
unmodeled_alias1,DOUBLE,1635201375,0,GOOD,3.0
unmodeled_alias1,DOUBLE,1635201376,0,GOOD,4.0
unmodeled_alias1,DOUBLE,1635201377,0,GOOD,5.0
unmodeled_alias1,DOUBLE,1635201378,0,GOOD,6.0
unmodeled_alias1,DOUBLE,1635201379,0,GOOD,7.0
unmodeled_alias1,DOUBLE,1635201380,0,GOOD,8.0
unmodeled_alias1,DOUBLE,1635201381,0,GOOD,9.0
unmodeled_alias1,DOUBLE,1635201382,0,GOOD,10.0
```

AWS IoT SiteWise stellt die folgenden API-Operationen bereit, um einen Massenimportauftrag zu erstellen und Informationen über einen vorhandenen Auftrag abzurufen.
+ [CreateBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateBulkImportJob.html)— Erstellt einen neuen Massenimportauftrag.
+ [DescribeBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeBulkImportJob.html)— Ruft Informationen über einen Massenimportjob ab.
+ [ListBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListBulkImportJobs.html)— Ruft eine paginierte Liste mit Zusammenfassungen aller Massenimportaufträge ab.

# Erstellen Sie einen AWS IoT SiteWise Massenimportauftrag ()AWS CLI
<a name="CreateBulkImportJob"></a>

Verwenden Sie den [CreateBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateBulkImportJob.html)API-Vorgang, um Daten von Amazon S3 zu zu übertragen AWS IoT SiteWise. Die [CreateBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateBulkImportJob.html)API ermöglicht die Aufnahme großer Mengen historischer Daten und die gepufferte Aufnahme analytischer Datenströme in kleinen Batches. Sie bietet ein kostengünstiges Primitiv für die Datenaufnahme. Das folgende Beispiel verwendet die AWS CLI.

**Wichtig**  
Bevor Sie einen Massenimportauftrag erstellen, müssen Sie AWS IoT SiteWise Warm Tier oder AWS IoT SiteWise Cold Tier aktivieren. Weitere Informationen finden Sie unter [Konfigurieren Sie die Speichereinstellungen in AWS IoT SiteWise](configure-storage.md).  
 Die [CreateBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateBulkImportJob.html)API unterstützt die Aufnahme von historischen Daten AWS IoT SiteWise mit der Option, den Parameter festzulegen. adaptive-ingestion-flag   
Wenn diese Option auf gesetzt ist`false`, nimmt die API historische Daten auf, ohne Berechnungen oder Benachrichtigungen auszulösen.
Wenn diese Option aktiviert ist`true`, nimmt die API neue Daten auf, berechnet Metriken und transformiert die Daten, um die laufenden Analysen und Benachrichtigungen innerhalb von sieben Tagen zu optimieren.

Führen Sie den folgenden Befehl aus. *file-name*Ersetzen Sie es durch den Namen der Datei, die die Konfiguration des Massenimportauftrags enthält.

```
aws iotsitewise create-bulk-import-job --cli-input-json file://file-name.json
```

**Example Konfiguration für den Massenimport-Job**  
Im Folgenden finden Sie Beispiele für Konfigurationseinstellungen:  
+ Ersetzen Sie *adaptive-ingestion-flag* durch `true` oder `false`.
  + Wenn diese Option auf gesetzt ist`false`, nimmt der Massenimportjob historische Daten in AWS IoT SiteWise auf.
  + Wenn diese Option auf gesetzt ist`true`, führt der Massenimportjob Folgendes aus:
    + Nimmt neue Daten auf in AWS IoT SiteWise.
    + Berechnet Kennzahlen und Transformationen und unterstützt Benachrichtigungen für Daten mit einem Zeitstempel innerhalb von sieben Tagen.
+ *delete-files-after-import-flag*Ersetzen Sie durch`true`, um die Daten aus dem Amazon S3 S3-Daten-Bucket zu löschen, nachdem sie in den AWS IoT SiteWise Warm-Tier-Speicher aufgenommen wurden.
+ Ersetzen Sie amzn-s3-demo-bucket *-for-errors* durch den Namen des Amazon S3 S3-Buckets, an den Fehler im Zusammenhang mit diesem Massenimportauftrag gesendet werden.
+ Ersetzen Sie amzn-s3-demo-bucket *-for-errors-prefix* durch das Präfix des Amazon S3 S3-Buckets, an den Fehler im Zusammenhang mit diesem Massenimportauftrag gesendet werden. 

  Amazon S3 verwendet das Präfix als Ordnernamen, um Daten im Bucket zu organisieren. Jedes Amazon S3 S3-Objekt hat einen Schlüssel, der seine eindeutige Kennung im Bucket ist. Jedes Objekt in einem Bucket besitzt genau einen Schlüssel. Das Präfix muss mit einem Schrägstrich enden (/). Weitere Informationen finden Sie unter [Objekte mithilfe von Präfixen organisieren](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) im *Amazon Simple Storage Service-Benutzerhandbuch*.
+ Ersetzen Sie amzn-s3-demo-bucket *-data* durch den Namen des Amazon S3 S3-Buckets, aus dem Daten importiert werden.
+ *data-bucket-key*Ersetzen Sie es durch den Schlüssel des Amazon S3 S3-Objekts, das Ihre Daten enthält. Jedes Objekt hat einen Schlüssel, der eine eindeutige Kennung ist. Jedes Objekt hat genau einen Schlüssel.
+ *data-bucket-version-id*Ersetzen Sie es durch die Versions-ID, um eine bestimmte Version des Amazon S3 S3-Objekts zu identifizieren, das Ihre Daten enthält. Dieser Parameter ist optional.
+ *column-name*Ersetzen Sie durch den in der CSV-Datei angegebenen Spaltennamen.
+ *job-name*Ersetzen Sie ihn durch einen eindeutigen Namen, der den Massenimportauftrag identifiziert.
+ *job-role-arn*Ersetzen Sie es durch die IAM-Rolle, die das Lesen von Amazon S3 S3-Daten ermöglicht AWS IoT SiteWise .
Stellen Sie sicher, dass Ihre Rolle über die im folgenden Beispiel gezeigten Berechtigungen verfügt. Ersetzen Sie amzn-s3-demo-bucket *-data* durch den Namen des Amazon S3 S3-Buckets, der Ihre Daten enthält. *amzn-s3-demo-bucket-for-errors*Ersetzen Sie es außerdem durch den Namen des Amazon S3 S3-Buckets, an den Fehler im Zusammenhang mit diesem Massenimportauftrag gesendet werden.    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Action": [
                "s3:GetObject",
                "s3:GetBucketLocation"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket-data",
                "arn:aws:s3:::amzn-s3-demo-bucket-data/*"
            ],
            "Effect": "Allow"
        },
        {
            "Action": [
                "s3:PutObject",
                "s3:GetObject",
                "s3:GetBucketLocation"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket-for-errors",
                "arn:aws:s3:::amzn-s3-demo-bucket-for-errors/*"
            ],
            "Effect": "Allow"
        }
    ]
}
```

```
{
   "adaptiveIngestion": adaptive-ingestion-flag,
   "deleteFilesAfterImport": delete-files-after-import-flag,       
   "errorReportLocation": { 
      "bucket": "amzn-s3-demo-bucket-for-errors",
      "prefix": "amzn-s3-demo-bucket-for-errors-prefix"
   },
   "files": [ 
      { 
         "bucket": "amzn-s3-demo-bucket-data",
         "key": "data-bucket-key",
         "versionId": "data-bucket-version-id"
      }
   ],
   "jobConfiguration": { 
      "fileFormat": { 
         "csv": { 
            "columnNames": [ "column-name" ]
         }
      }
   },
   "jobName": "job-name",
   "jobRoleArn": "job-role-arn"    
}
```

**Example response**  

```
{
   "jobId":"f8c031d0-01d1-4b94-90b1-afe8bb93b7e5",
   "jobStatus":"PENDING",
   "jobName":"myBulkImportJob"
}
```

# Beschreiben Sie einen AWS IoT SiteWise Massenimportauftrag (AWS CLI)
<a name="DescribeBulkImportJob"></a>

Verwenden Sie den [DescribeBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeBulkImportJob.html)API-Vorgang, um Informationen zu einem bestimmten Massenimportauftrag in abzurufen AWS IoT SiteWise. Dieser Vorgang gibt Details wie den Status des Jobs, die Erstellungszeit und Fehlerinformationen zurück, falls der Job fehlgeschlagen ist. Sie können diesen Vorgang verwenden, um den Auftragsfortschritt zu überwachen und Probleme zu beheben. Zur Verwendung `DescribeBulkImportJob` benötigen Sie die Auftrags-ID des `CreateBulkImportJob` Vorgangs. Die API gibt folgende Informationen zurück:
+ Liste der importierten Dateien, einschließlich ihrer Amazon S3 S3-Bucket-Speicherorte und Schlüssel
+ Speicherort des Fehlerberichts (falls zutreffend)
+ Details zur Jobkonfiguration, wie Dateiformat und CSV-Spaltennamen
+ Zeitstempel für die Erstellung von Job und die letzte Aktualisierung
+ Aktueller Auftragsstatus (z. B. ob der Job in Bearbeitung, abgeschlossen oder fehlgeschlagen ist)
+ Für den Importjob verwendeter ARN der IAM-Rolle

Überprüfen Sie bei abgeschlossenen Aufträgen die Ergebnisse, um die erfolgreiche Datenintegration zu bestätigen. Wenn ein Job fehlschlägt, überprüfen Sie die Fehlerdetails, um Probleme zu diagnostizieren und zu lösen.

*job-ID*Ersetzen Sie es durch die ID des Massenimportauftrags, den Sie abrufen möchten.

```
aws iotsitewise describe-bulk-import-job --job-id job-ID
```

**Example response**  

```
{
   "files":[
      {
         "bucket":"amzn-s3-demo-bucket1",
         "key":"100Tags12Hours.csv"
      },
      {
         "bucket":"amzn-s3-demo-bucket2",
         "key":"BulkImportData1MB.csv"
      },
      {
         "bucket":"	amzn-s3-demo-bucket3",
         "key":"UnmodeledBulkImportData1MB.csv"
      }
   ],
   "errorReportLocation":{
      "prefix":"errors/",
      "bucket":"amzn-s3-demo-bucket-for-errors"
   },
   "jobConfiguration":{
      "fileFormat":{
         "csv":{
            "columnNames":[
               "ALIAS",
               "DATA_TYPE",
               "TIMESTAMP_SECONDS",
               "TIMESTAMP_NANO_OFFSET",
               "QUALITY",
               "VALUE"
            ]
         }
      }
   },
   "jobCreationDate":1645745176.498,
   "jobStatus":"COMPLETED",
   "jobName":"myBulkImportJob",
   "jobLastUpdateDate":1645745279.968,
   "jobRoleArn":"arn:aws:iam::123456789012:role/DemoRole",
   "jobId":"f8c031d0-01d1-4b94-90b1-afe8bb93b7e5"
}
```

# Auflisten von AWS IoT SiteWise Massenimportaufträgen (AWS CLI)
<a name="ListBulkImportJobs"></a>

Verwenden Sie den [ListBulkImportJobs](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListBulkImportJobss.html)API-Vorgang, um eine Liste mit Zusammenfassungen für Massenimportaufträge in AWS IoT SiteWise abzurufen. Dieser Vorgang bietet eine effiziente Möglichkeit, Ihre Datenimportprozesse zu überwachen und zu verwalten. Es gibt die folgenden Schlüsselinformationen für jeden Job zurück:
+ Job-ID. Eine eindeutige Kennung für jeden Massenimportauftrag
+ Name des Job. Der Name, den Sie dem Job bei der Erstellung zugewiesen haben
+ Aktueller Status. Der aktuelle Status des Jobs (z. B. ABGESCHLOSSEN, LÄUFT, FEHLGESCHLAGEN)

ListBulkImportJobs ist besonders nützlich, um sich einen umfassenden Überblick über all Ihre Massenimportaufträge zu verschaffen. Dies kann Ihnen helfen, mehrere Datenimporte nachzuverfolgen, alle Jobs zu identifizieren, die Aufmerksamkeit erfordern, und einen organisierten Arbeitsablauf aufrechtzuerhalten. Der Vorgang unterstützt die Seitennummerierung, sodass Sie eine große Anzahl von Auftragszusammenfassungen effizient abrufen können. Sie können den von diesem Vorgang IDs zurückgegebenen Auftrag zusammen mit dem [DescribeBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeBulkImportJob.html)Vorgang verwenden, um detailliertere Informationen zu bestimmten Aufträgen abzurufen. Dieser zweistufige Prozess ermöglicht es Ihnen, sich zunächst einen Überblick über alle Jobs zu verschaffen und anschließend die Details der Jobs, die für Sie von Interesse sind, aufzuschlüsseln. Bei der Verwendung können Sie Filter anwenden`ListBulkImportJobs`, um die Ergebnisse einzugrenzen. Sie können beispielsweise Jobs nach ihrem Status filtern, um nur abgeschlossene Jobs oder nur laufende Jobs abzurufen. Mit dieser Funktion können Sie sich auf die relevantesten Informationen für Ihre aktuelle Aufgabe konzentrieren. Der Vorgang gibt auch a zurück`nextToken`, wenn mehr Ergebnisse verfügbar sind. Sie können dieses Token in nachfolgenden Aufrufen verwenden, um den nächsten Satz von Auftragszusammenfassungen abzurufen, sodass Sie alle Ihre Massenimportaufträge durchlaufen können, auch wenn Sie über eine große Anzahl von Aufträgen verfügen. Das folgende Beispiel zeigt, wie Sie `ListBulkImportJobs` mit dem eine Liste AWS CLI abgeschlossener Jobs abrufen können.

```
aws iotsitewise list-bulk-import-jobs --filter COMPLETED
```

**Example Filter „Antwort auf abgeschlossene Jobs“**  

```
{
   "jobSummaries":[
      {
         "id":"bdbbfa52-d775-4952-b816-13ba1c7cb9da",
         "name":"myBulkImportJob",
         "status":"COMPLETED"
      },
      {
         "id":"15ffc641-dbd8-40c6-9983-5cb3b0bc3e6b",
         "name":"myBulkImportJob2",
         "status":"COMPLETED"
      }
   ]
}
```

Mit diesem Befehl wird veranschaulicht, wie `ListBulkImportJobs` Sie eine Liste von Aufträgen abrufen können, die fehlerhaft abgeschlossen wurden. Das Maximum ist auf 50 Ergebnisse festgelegt und wir verwenden ein Next-Token für paginierte Ergebnisse.

```
aws iotsitewise list-bulk-import-jobs --filter COMPLETED_WITH_FAILURES --max-results 50 --next-token "string"
```