

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.

# Kampagnendaten speichern und weiterleiten
<a name="store-and-forward"></a>

**Wichtig**  
Der Zugriff auf bestimmte AWS FleetWise IoT-Funktionen ist derzeit gesperrt. Weitere Informationen finden Sie unter [AWS Verfügbarkeit von Regionen und Funktionen im AWS Internet der Dinge FleetWise](fleetwise-regions.md).

Verwenden Sie Datenpartitionen innerhalb von Kampagnen, um Signaldaten für Fahrzeuge und Flotten vorübergehend auf dem Edge zu speichern. Durch die Konfiguration von Upload- und Speicheroptionen für Datenpartitionen können Sie Ihre idealen Bedingungen für die Datenweiterleitung an Ihre angegebenen Datenziele (z. B. einen Amazon S3 S3-Bucket) optimieren. Sie können die Datenpartition beispielsweise so konfigurieren, dass Daten auf einem Fahrzeug gespeichert werden, bis es eine Wi-Fi-Verbindung herstellt. Sobald das Fahrzeug eine Verbindung hergestellt hat, löst die Kampagne aus, dass die Daten in dieser bestimmten Partition an die Cloud gesendet werden. Alternativ können Sie Daten mithilfe von AWS IoT Jobs sammeln.

**Topics**
+ [Erstellen Sie Datenpartitionen](create-campaign-data-partitions.md)
+ [Laden Sie Kampagnendaten hoch](update-campaign-cli-data-partitions.md)
+ [Laden Sie Daten mithilfe von AWS IoT Jobs hoch](update-campaign-cli-data-partitions-jobs.md)

# Erstellen Sie Datenpartitionen
<a name="create-campaign-data-partitions"></a>

**Wichtig**  
Der Zugriff auf bestimmte AWS FleetWise IoT-Funktionen ist derzeit gesperrt. Weitere Informationen finden Sie unter [AWS Verfügbarkeit von Regionen und Funktionen im AWS Internet der Dinge FleetWise](fleetwise-regions.md).

Eine Datenpartition in einer Kampagne speichert vorübergehend Signaldaten. Sie konfigurieren, wann und wie die Daten an die Cloud weitergeleitet werden sollen. 

Bei einer Datenpartition wird zunächst ein bestimmter Datensatz anhand der `dataPartitionId` für eine Kampagne verwendet. Anschließend können Sie weitere Speicheroptionen für Partitionen definieren, z. B. die maximale Größe, die Mindestdauer für die Aktualisierung der Datenpartition (auf der Festplatte) und den Speicherort der Daten auf dem Edge. Sie können den Speicherort im Fahrzeug mithilfe von ermitteln`storageLocation`. Der Speicherort bestimmt den Ordnernamen für die Datenpartition unter dem Kampagnen-Speicherordner. Der Kampagnen-Speicherordner befindet sich in einem Ordner, der nach dem Fahrzeugnamen benannt ist, unter einem Persistenzpfad, der in der Edge-Konfigurationsdatei definiert ist. Dies ist der absolute Pfad des Speicherorts:. `{persistency_path} / {vehicle_name} / {campaign_name} / {storage_location}`

Der auf eingestellte Spooling-Modus `TO_DISK` gibt an, dass die partitionierten Daten auf einer Festplatte im Fahrzeug gespeichert werden sollen. Die Datenspeicherung für Datenpartitionen erfolgt auf FIFO-Basis (First In, First Out). Wenn Sie eine Kampagne löschen, löschen Sie auch die Daten in der zugehörigen Datenpartition. Wenn Sie keine Datenpartition für on/off Konnektivitätsanwendungsfälle angeben, speichert AWS IoT FleetWise dennoch Daten in einem Ringpuffer auf dem Fahrzeug, wenn keine Konnektivität besteht. Wenn die Konnektivität wieder hergestellt wird, FleetWise lädt AWS IoT die Daten in die Cloud hoch. Dieses Verhalten ist in der Edge Agent for AWS FleetWise IoT-Software konfigurierbar.

**Wichtig**  
Wenn Ihre Datenpartition das festgelegte maximale Speicherlimit überschreitet, überschreiben neuere Daten ältere Daten, wenn die Partition die maximale Größe erreicht. Verlorene Daten auf dem Edge können nicht wiederhergestellt werden. Die Speichergröße wird durch Ihr Edge-Speicherlimit bestimmt.  
Wenn Daten in die Cloud hochgeladen werden, können sie nach Ablauf der Mindestzeit entfernt werden. Stellen Sie die Mindestlebensdauer entsprechend ein, um ein unbeabsichtigtes Löschen zu vermeiden.

Die Upload-Optionen bestimmen die Variablenausdrücke und die Sprache der Bedingungen. Wenn Upload-Optionen angegeben sind, müssen Sie auch Speicheroptionen angeben. Sie können auch verlangen, dass Signale in Datenpartitionen in die Cloud hochgeladen werden. Weitere Informationen finden Sie unter [Laden Sie Kampagnendaten hoch](update-campaign-cli-data-partitions.md).

Nachdem die Bedingungen für die Datenpartition definiert wurden`signalsToCollect`, können Sie festlegen, welche Signale in der Datenpartition berücksichtigt werden sollen. Sie können entweder IDs Datenpartitionen angeben oder `dataPartitionId` auf `default` festlegen, dass eine etablierte Standarddatenpartition verwendet wird. Ein Signal ohne Angabe `dataPartitionId` wird der Standardeinstellung zugeordnet`dataPartition`.

**Um eine Datenpartition zu erstellen**

Erstellen Sie anhand des folgenden Beispiels eine Kampagne mit einer Speicherbedingung für Datenpartitionen. Diese Beispielkampagne ist so konfiguriert, dass Fahrzeugdaten in Amazon Timestream gespeichert werden.

1. *campaign-name*Ersetzen Sie es durch den Namen der Kampagne, die Sie erstellen.

1. (Optional) Geben Sie eine Beschreibung ein.

1. *role-arn*Ersetzen Sie es durch den Amazon-Ressourcennamen (ARN) der Aufgabenausführungsrolle, die AWS FleetWise IoT-Berechtigungen zur Übermittlung von Daten an die Timestream-Tabelle erteilt.

1. *table-arn*Ersetzen Sie durch den ARN der Timestream-Tabelle.

1. Durch *signal-catalog-arn* den ARN des Signalkatalogs ersetzen.

1. Ersetzen Sie *data-partition-id* sowohl die `dataPartitions` ID als auch die ID, der Sie zuordnen möchten`signalsToCollect`. Ersetzen Sie zunächst die ID der Datenpartition, die im Signal verwendet werden soll. Denn `signalsToCollect` die ID muss mit einer der unter IDs angegebenen übereinstimmen`dataPartitions`.
**Anmerkung**  
Richten Sie eine Standarddatenpartition für eine Kampagne ein, indem Sie `default` sie als ID verwenden.

1. *target-arn*Ersetzen Sie es durch den ARN einer Flotte oder eines Fahrzeugs, das Sie erstellt haben.

```
{
    "name": "campaign-name",
    "description": "Measurement of SOC, SOH, thermal, and power optimization for Fleet 2704",
    "targetArn": "target-arn",
    "collectionScheme": {
        "conditionBasedCollectionScheme": {
            "conditionLanguageVersion": 1,
            "expression": "$variable.`Vehicle.BMS` > 50",
            "minimumTriggerIntervalMs": 1000,
            "triggerMode": "ALWAYS"
        }
    },
    "compression": "SNAPPY",
    "dataDestinationConfigs": [{
        "timestreamConfig": {
            "executionRoleArn": "role-arn",
            "timestreamTableArn": "table-arn"
        }
    }],
    "dataPartitions": [{
        "id": "data-partition-id",
        "storageOptions": {
            "maximumSize": {
                "unit": "GB",
                "value": 1024
            },
            "minimumTimeToLive": {
                "unit": "WEEKS",
                "value": 6
            },
            "storageLocation": "string"
        },
        "uploadOptions": {
            "conditionLanguageVersion": 1,
            "expression": "$variable.`Vehicle.BMS.PowerOptimization` > 90"
        }
    }],
    "signalCatalogArn": "signal-catalog-arn",
    "signalsToCollect": [{
        "dataPartitionId": "data-partition-id",
        "maxSampleCount": 50000,
        "minimumSamplingIntervalMs": 100,
        "name": "Below-90-percent"
    }],
    "spoolingMode": "TO_DISK",
    "tags": [{
        "Key": "BMS",
        "Value": "Under-90"
    }]
}
```

Nachdem alle angegebenen Bedingungen erfüllt sind, werden die partitionierten Daten an die Cloud weitergeleitet, sodass neue partitionierte Signale gesammelt und gespeichert werden können.

Als Nächstes rufen Sie die `UpdateCampaign` API auf, um sie in der Edge Agent for AWS FleetWise IoT-Software bereitzustellen. Weitere Informationen finden Sie unter [Laden Sie Kampagnendaten hoch](update-campaign-cli-data-partitions.md).

# Laden Sie Kampagnendaten hoch
<a name="update-campaign-cli-data-partitions"></a>

**Wichtig**  
Der Zugriff auf bestimmte AWS FleetWise IoT-Funktionen ist derzeit gesperrt. Weitere Informationen finden Sie unter [AWS Verfügbarkeit von Regionen und Funktionen im AWS Internet der Dinge FleetWise](fleetwise-regions.md).

Es gibt zwei Möglichkeiten, Kampagnendaten auf den Edge hochzuladen:
+ Kampagnen, die Ihre Upload-Bedingungen erfüllen, laden nach ihrer Genehmigung automatisch Daten in die Cloud hoch. Verwenden Sie den `updateCampaign` API-Vorgang, um eine Kampagne zu genehmigen. 
+ Mithilfe von AWS IoT Jobs können Sie das Hochladen von Daten erzwingen, auch wenn bestimmte Bedingungen nicht erfüllt sind. Weitere Informationen finden Sie unter [Laden Sie Daten mithilfe von AWS IoT Jobs hoch](update-campaign-cli-data-partitions-jobs.md).

**Um Kampagnendaten mithilfe der `UpdateCampaign` API-Operation hochzuladen**

Nachdem Sie die Kampagne erstellt haben, wird der Kampagnenstatus so `WAITING_FOR_APPROVAL` lange angezeigt, bis Sie das `action` in ändern`APPROVED`.
+ Verwenden Sie das folgende Beispiel, um die Kampagne zu aktualisieren, `action` indem Sie den [UpdateCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateCampaign.html)API-Vorgang aufrufen.

  ```
  {
     "action": "APPROVED",
     "dataExtraDimensions": [ "string" ],
     "description": "string",
     "name": "string"
  }
  ```

# Laden Sie Daten mithilfe von AWS IoT Jobs hoch
<a name="update-campaign-cli-data-partitions-jobs"></a>

**Wichtig**  
Der Zugriff auf bestimmte AWS FleetWise IoT-Funktionen ist derzeit gesperrt. Weitere Informationen finden Sie unter [AWS Verfügbarkeit von Regionen und Funktionen im AWS Internet der Dinge FleetWise](fleetwise-regions.md).

Mit AWS IoT Jobs können Sie Kampagnen so konfigurieren, dass gespeicherte Fahrzeugdaten bei Bedarf in die Cloud hochgeladen werden.

**Um ein Jobdokument für Ihre Kampagne zu erstellen**
+ Verwenden Sie das folgende Beispiel, um ein Jobdokument für die Kampagne zu erstellen. Ein Auftragsdokument ist eine JSON-Datei, die Informationen über Fahrzeuge oder Flotten enthält, die für die Ausführung eines Auftrags erforderlich sind. Weitere Informationen zum Erstellen von Auftragsdokumenten finden Sie unter [Erstellen und Verwalten von Aufträgen mithilfe von AWS CLI im AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) *Entwicklerhandbuch*.

  Um anzufordern, dass nur ein Fahrzeug Daten hochlädt, legen Sie als Jobziel das Objekt AWS IoT fest, das dem Fahrzeug zugeordnet ist. Um zu verlangen, dass mehrere Fahrzeuge (in derselben Kampagne) Daten hochladen, erstellen Sie eine Dinggruppe mit allen Dingen, die den Fahrzeugen entsprechen, und legen Sie dann das Jobziel auf die Dinggruppe fest.

  ```
  {
    "version": "1.0",
    "parameters": {
       "campaignArn": ${aws:iot:parameter:campaignArn},
       "endTime": ${aws:iot:parameter:endTime}
    }
  }
  ```

  1. `CampaignArn`Ersetzen Sie es durch den Amazon-Ressourcennamen (ARN) einer Kampagne in derselben Region und demselben Konto. Der Kampagnen-ARN ist erforderlich.

  1. (Optional) `endTime` Ersetzen Sie ihn durch den Zeitstempel der am Fahrzeug gesammelten Daten im UTC-Format ISO 8601 (ohne Millisekunden). Beispiel, `2024-03-05T23:00:00Z`. Der Zeitstempel ist exklusiv und bestimmt den letzten hochzuladenden Datenpunkt. Wenn Sie diesen Wert weglassen`endTime`, fährt die Edge Agent-Software mit dem Upload fort, bis alle gespeicherten Daten einer Kampagne hochgeladen sind. Nachdem alle Daten hochgeladen wurden, wird der [Status der Auftragsausführung](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs-lifecycle.html#iot-job-execution-states) auf `SUCCEEDED` aktualisiert. Der [Status](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs-lifecycle.html#iot-jobs-states) des Jobs wird auf aktualisiert`COMPLETED`.

**Um einen Job mit einer verwalteten Jobvorlage zu erstellen**

1. Wählen Sie **IoT-IO TFleet Wise- CollectCampaignData** aus der Liste der verwalteten Vorlagen aus. Weitere Informationen finden Sie im *AWS IoT Entwicklerhandbuch* unter [Erstellen eines Jobs aus AWS verwalteten Vorlagen](https://docs.aws.amazon.com/iot/latest/developerguide/job-template-manage-console-create.html).

1. Die verwaltete Vorlage hat die `endTime` Parameter `CampaignArn` und.

   1. `CampaignArn`Ersetzen Sie es durch den Amazon-Ressourcennamen (ARN) einer Kampagne in derselben Region und demselben Konto. Der Kampagnen-ARN ist erforderlich.

   1. (Optional) `endTime` Ersetzen Sie ihn durch den Zeitstempel der am Fahrzeug gesammelten Daten im UTC-Format ISO 8601 (ohne Millisekunden). Beispiel, `2024-03-05T23:00:00Z`. Der Zeitstempel ist exklusiv und bestimmt den letzten hochzuladenden Datenpunkt. Wenn Sie diesen Wert weglassen`endTime`, fährt die Edge Agent-Software mit dem Upload fort, bis alle gespeicherten Daten einer Kampagne hochgeladen sind. Nachdem alle Daten hochgeladen wurden, wird der [Status der Auftragsausführung](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs-lifecycle.html#iot-job-execution-states) auf `SUCCEEDED` aktualisiert. Der [Status](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs-lifecycle.html#iot-jobs-states) des Jobs wird auf aktualisiert`COMPLETED`.

Verwandte Themen zur Problembehandlung finden Sie unter[Probleme speichern und weiterleiten](troubleshooting-campaign.md).

Weitere Informationen zu AWS IoT [Jobs](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs.html) finden Sie im *AWS IoT Developer Guide* unter Jobs.