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. # Operationen zu Statusvorlagen für die Datenerfassung und -verarbeitung **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). In den folgenden Abschnitten wird beschrieben, wie Sie Statusvorlagen verwenden, um die Datenerfassung zu aktivieren und zu deaktivieren, einen Abrufvorgang durchzuführen und Zustandsdaten von Ihren Fahrzeugen zu verarbeiten. **Topics** + [Aktivieren und deaktivieren Sie die Erfassung von Zustandsdaten mithilfe von Statusvorlagen](start-stop-data-ingestion.md) + [Rufen Sie mithilfe von Statusvorlagen einen Fahrzeugstatus-Snapshot ab](on-demand-operations.md) + [Verarbeiten Sie die letzten bekannten Statusfahrzeugdaten mithilfe von MQTT-Messaging](process-last-known-state-vehicle-data.md) # Aktivieren und deaktivieren Sie die Erfassung von Zustandsdaten mithilfe von Statusvorlagen **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). In den folgenden Abschnitten wird beschrieben, wie Sie die Datenaufnahme mit Statusvorlagen mithilfe von aktivieren und deaktivieren. AWS CLI **Wichtig** Bevor Sie beginnen, stellen Sie sicher, dass Sie bereits eine [Statusvorlage](state-templates.md) erstellt und diese und ihre Aktualisierungsstrategie einem Fahrzeug zugeordnet haben. Sie müssen eine Statusvorlage aktivieren, damit der Edge Agent Signalaktualisierungen an die Cloud senden kann. Um diese Operationen mit Statusvorlagen durchzuführen, erstellen Sie zunächst eine Befehlsressource und starten Sie dann die Befehlsausführung auf dem Fahrzeug. Im folgenden Abschnitt wird beschrieben, wie Sie diese API verwenden und wie Sie die Datenaufnahme aktivieren und deaktivieren. **Topics** + [Verwenden der `CreateCommand`-API](#start-stop-ingestion-create-command) + [Beispiel: Aktivieren Sie eine Statusvorlage](#start-stop-ingestion-activate-template) + [Beispiel: Deaktivieren Sie eine Statusvorlage](#start-stop-ingestion-deactivate-template) ## Verwenden der `CreateCommand`-API Erstellen Sie eine Befehlsressource im Namespace `AWS-IoTFleetwise` "" und verwenden Sie die folgenden Parameter, wenn Sie eine Befehlsressource für eine Statusvorlage erstellen oder senden: + `$stateTemplate.name`— Der Name der Statusvorlage, für die der Vorgang ausgeführt werden soll. Die Statusvorlage muss auf das Fahrzeug aufgebracht werden, bevor Sie einen Vorgang durchführen können. Weitere Informationen finden Sie unter [Ordnen Sie einem Fahrzeug eine AWS FleetWise IoT-Statusvorlage zu](state-templates.md#apply-state-templates). + `$stateTemplate.operation`— Der Vorgang, der an der Statusvorlage ausgeführt werden soll. Verwenden Sie einen der folgenden Werte für diesen Parameter: + `activate`— Der Edge-Agent beginnt mit dem Senden von Signalaktualisierungen an die Cloud, die `stateTemplateUpdateStrategy` Sie bei der Anwendung der Statusvorlage auf das Fahrzeug angegeben haben (bei Änderung oder in regelmäßigen Abständen). Weitere Informationen finden Sie unter [Ordnen Sie einem Fahrzeug eine AWS FleetWise IoT-Statusvorlage zu](state-templates.md#apply-state-templates). Sie können auch eine automatische Deaktivierungszeit für die Statusvorlage definieren, um Aktualisierungen nach einem bestimmten Zeitraum zu beenden. Wenn keine automatische Deaktivierungszeit angegeben ist, senden die Statusvorlagen so lange Updates, bis ein Deaktivierungsaufruf erfolgt. Sobald der `activate` Befehl empfangen wurde, sollte das Gerät die in der Statusvorlage angegebenen Signale gemäß der Aktualisierungsstrategie senden. AWS IoT FleetWise empfiehlt, dass, wenn ein Aktivierungsbefehl vom Gerät empfangen wird, die erste Nachricht, die es sendet, eine Momentaufnahme aller Signale in der Statusvorlage enthalten sollte. Nachfolgende Nachrichten sollten entsprechend der Aktualisierungsstrategie gesendet werden. + `deactivate`— Der Edge-Agent sendet keine Signalaktualisierungen mehr an die Cloud. + `fetchSnapshot`— Der Edge-Agent sendet einen einmaligen Snapshot der in der Statusvorlage definierten Signale, unabhängig davon, welche `stateTemplateUpdateStrategy` Sie bei der Anwendung der Statusvorlage auf das Fahrzeug angegeben haben. + (Optional) `$stateTemplate.deactivateAfterSeconds` — Die Statusvorlage wird nach Ablauf der angegebenen Zeit automatisch deaktiviert. Dieser Parameter kann nur verwendet werden, wenn der Wert des `$stateTemplate.operation` Parameters „activate“ ist. Wenn dieser Parameter nicht angegeben ist oder wenn der Wert dieses Parameters 0 ist, sendet der Edge-Agent weiterhin Signalaktualisierungen an die Cloud, bis eine Deaktivierungsoperation für die Statusvorlage empfangen wird. Die Statusvorlage wird niemals automatisch deaktiviert. Mindestwert: 0, Höchstwert: 4294967295. **Anmerkung** Die API gibt als Antwort auf eine Aktivierungsanfrage für eine Vorlage, die sich bereits im aktiven Status befindet, erfolgreich zurück. Die API gibt als Antwort auf eine Deaktivierungsanfrage für eine Vorlage, die sich bereits im Deaktivierungsstatus befindet, erfolgreich zurück. Die letzte Anfrage, die Sie für eine Statusvorlage stellen, ist diejenige, die wirksam wird. Wenn Sie beispielsweise die Deaktivierung einer Statusvorlage in einer Stunde beantragen und dann eine zweite Anfrage zur Deaktivierung derselben Vorlage innerhalb von vier Stunden stellen, wird die Deaktivierung innerhalb von vier Stunden wirksam, da es sich um die neueste Anforderung handelt. **Wichtig** Eine Validierungsausnahme kann in jedem der folgenden Szenarien auftreten: Es wird eine Vorlage für den Bundesstaat bereitgestellt, die nicht im `ASSOCIATED` Lieferumfang eines Fahrzeugs enthalten ist. Es wurde eine Anfrage zur Aktivierung einer Statusvorlage gestellt, die jedoch noch nicht in `DEPLOYED` einem Fahrzeug enthalten war. Es wird eine Anfrage an eine Statusvorlage gestellt, die sich jedoch `DELETED` auf ein Fahrzeug bezieht. ## Beispiel: Aktivieren Sie eine Statusvorlage Um eine Statusvorlage zu aktivieren, erstellen Sie zunächst eine Befehlsressource. Anschließend können Sie den folgenden Befehl an das Fahrzeug senden, für das Sie die Statusvorlage aktivieren möchten. Dieses Beispiel zeigt, wie Sie beim Erstellen eines Befehls Standardwerte für die Parameter angeben können. Diese Parameter und ihre Werte werden verwendet, wenn die Befehlsausführung gestartet wird, um die Statusvorlage zu aktivieren. 1. **Erstellen Sie eine Befehlsressource** Bevor Sie einen Befehl an das Fahrzeug senden können, müssen Sie eine Befehlsressource erstellen. Sie können alternative Werte für obligatorische Parameter angeben, wenn Sie den Befehl an das Fahrzeug senden. Weitere Informationen finden Sie unter [Erstellen Sie eine Befehlsressource](create-manage-remote-command-cli.md#create-remote-command-cli). **Wichtig** `$stateTemplate.name`und `$stateTemplate.operation` Parameter müssen als String-Datentyp bereitgestellt werden. Wenn ein anderer Datentyp angegeben wird oder einer dieser beiden Parameter fehlt, schlägt die Befehlsausführung mit einer Validierungsausnahme fehl. Der `$stateTemplate.deactivateAfterSeconds` Parameter muss als `Long` Datentyp bereitgestellt werden. ``` aws iot create-command \ --description "This command activates a state template on a vehicle" --command-id ActivateStateTemplate \ --display-name "Activate State Template" \ --namespace AWS-IoTFleetWise \ --mandatory-parameters '[ { "name": "$stateTemplate.name", "defaultValue": {"S": "ST123"} }, { "name": "$stateTemplate.operation", "defaultValue": {"S": "activate"} }, { "name": "$stateTemplate.deactivateAfterSeconds", "defaultValue": {"L": "120"} } ]' ``` 1. **Starten Sie die Befehlsausführung auf dem Fahrzeug** Nachdem der Befehl erstellt wurde, senden Sie den Befehl an das Fahrzeug. Wenn Sie bei der Erstellung der Befehlsressource keine Werte für die obligatorischen Parameter angegeben haben, müssen Sie sie jetzt angeben. Weitere Informationen finden Sie unter [Senden Sie einen Befehl ()AWS CLI](send-monitor-remote-command-cli.md#send-remote-command-cli). **Wichtig** Stellen Sie sicher, dass Sie den API-Endpunkt der kontospezifischen AWS IoT Auftragsdatenebene für den API-Vorgang verwenden. ``` aws iot-jobs-data start-command-execution \ --endpoint-url \ --command-arn arn:aws:iot:region:111122223333:command/ActivateStateTemplate \ --target-arn arn:aws:iot:region:111122223333:thing/ ``` 1. **Rufen Sie den Status des Vorlagenvorgangs für den Status ab** Nachdem Sie die Befehlsausführung gestartet haben, können Sie die `GetCommandExecution` API verwenden, um die Statusvorlage abzurufen. ``` aws iot get-command-execution --execution-id ``` ## Beispiel: Deaktivieren Sie eine Statusvorlage Um eine Statusvorlage zu deaktivieren, erstellen Sie zunächst eine Befehlsressource. Anschließend können Sie den folgenden Befehl an das Fahrzeug senden, für das Sie die Statusvorlage deaktivieren möchten. Dieses Beispiel zeigt, wie Sie beim Erstellen eines Befehls Standardwerte für die Parameter angeben können. Diese Parameter und ihre Werte werden verwendet, wenn die Befehlsausführung gestartet wird, um die Statusvorlage zu deaktivieren. 1. **Erstellen Sie eine Befehlsressource** Bevor Sie einen Befehl an das Fahrzeug senden können, müssen Sie eine Befehlsressource erstellen. Sie können alternative Werte für obligatorische Parameter angeben, wenn Sie den Befehl an das Fahrzeug senden. Weitere Informationen finden Sie unter [Erstellen Sie eine Befehlsressource](create-manage-remote-command-cli.md#create-remote-command-cli). ``` aws iot create-command \ --description "This command deactivates a state template on a vehicle" --command-id DeactivateStateTemplate \ --display-name "Deactivate State Template" \ --namespace AWS-IoTFleetWise \ --mandatory-parameters '[ { "name": "$stateTemplate.name", "defaultValue": {"S": "ST123"} }, { "name": "$stateTemplate.operation", "defaultValue": {"S": "deactivate"} } ]' ``` 1. **Starten Sie die Befehlsausführung auf dem Fahrzeug** Nachdem der Befehl erstellt wurde, senden Sie den Befehl an das Fahrzeug. Wenn Sie bei der Erstellung der Befehlsressource keine Werte für die obligatorischen Parameter angegeben haben, müssen Sie sie jetzt angeben. Weitere Informationen finden Sie unter [Senden Sie einen Befehl ()AWS CLI](send-monitor-remote-command-cli.md#send-remote-command-cli). ``` aws iot-jobs-data start-command-execution \ --endpoint-url \ --command-arn arn:aws:iot:region:111122223333:command/DeactivateStateTemplate \ --target-arn arn:aws:iot:region:111122223333:thing/ ``` 1. **Rufen Sie den Status des Vorgangs mit der Statusvorlage ab** Nachdem Sie die Befehlsausführung gestartet haben, können Sie die `GetCommandExecution` API verwenden, um die Statusvorlage abzurufen. ``` aws iot get-command-execution --execution-id ``` # Rufen Sie mithilfe von Statusvorlagen einen Fahrzeugstatus-Snapshot ab **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). Sie können den letzten bekannten Status eines Fahrzeugs mithilfe der API-Operation der [https://docs.aws.amazon.com/iot/latest/apireference/API_CreateCommand.html](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateCommand.html) AWS IoT Core Steuerungsebene oder der AWS FleetWise IoT-Konsole abrufen. **Wichtig** Eine Validierungsausnahme kann in jedem der folgenden Szenarien auftreten: Es wird eine Vorlage für den Bundesstaat bereitgestellt, die nicht im `ASSOCIATED` Lieferumfang eines Fahrzeugs enthalten ist. Es wurde eine Anfrage zur Aktivierung einer Statusvorlage gestellt, die jedoch noch nicht in `DEPLOYED` einem Fahrzeug enthalten war. Es wird eine Anfrage an eine Statusvorlage gestellt, die sich jedoch `DELETED` auf ein Fahrzeug bezieht. ## Ruft einen Fahrzeugstatus-Snapshot ab (Konsole) Sie können die AWS FleetWise IoT-Konsole verwenden, um den letzten bekannten Status eines Fahrzeugs abzurufen. AWS IoT erstellt FleetWise einen Befehl, mit dem Sie Daten abrufen können. **Um den Status eines Fahrzeugs abzurufen** 1. Öffnen Sie die [AWS FleetWise IoT-Konsole](https://console.aws.amazon.com/iotfleetwise). 1. Wählen Sie im Navigationsbereich **Fahrzeuge** aus. 1. Wählen Sie ein Fahrzeug aus der Liste aus, um die zugehörige Detailseite zu öffnen. 1. Wählen Sie auf der Registerkarte **Vorlagen für Bundesstaaten** die Option **Daten abrufen** aus. 1. Wählen Sie die IAM-Rolle aus, die AWS FleetWise IoT-Berechtigungen zum Senden eines Befehls und zum Abrufen von Daten gewährt. Weitere Informationen finden Sie unter [Zugriffskontrolle](https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/controlling-access.html#generate-command-payload). 1. Wählen Sie **Status abrufen** aus. ## Ruft einen Fahrzeugstatus-Snapshot ab ()AWS CLI Um einen Status-Snapshot abzurufen, erstellen Sie zunächst eine Befehlsressource. Anschließend können Sie den folgenden Befehl an das Fahrzeug senden, für das Sie den Status-Snapshot abrufen möchten. Weitere Hinweise zur Verwendung der `CreateCommand` API und ihrer Parameter finden Sie unter[Verwenden der `CreateCommand`-API](start-stop-data-ingestion.md#start-stop-ingestion-create-command). 1. **Erstellen Sie eine Befehlsressource** Das folgende Beispiel zeigt, wie Sie die Befehlsressource erstellen, um den Abrufvorgang auszuführen. Sie können alternative Werte für obligatorische Parameter angeben, wenn Sie den Befehl an das Fahrzeug senden. Weitere Informationen finden Sie unter [Erstellen Sie eine Befehlsressource](create-manage-remote-command-cli.md#create-remote-command-cli). ``` aws iot create-command \ --command-id \ --display-name "FetchSnapshot State Template" \ --namespace AWS-IoTFleetWise \ --mandatory-parameters '[ { "name": "$stateTemplate.name", "defaultValue": {"S": "ST123"} }, { "name": "$stateTemplate.operation", "defaultValue": {"S": "fetchSnapshot"} } ]' ``` Antwort: ``` { "commandId": "", "commandArn": "arn:aws:iot::111122223333:command/" } ``` 1. **Starten Sie die Befehlsausführung, um den Status-Snapshot abzurufen** Nachdem der Befehl erstellt wurde, senden Sie den Befehl an das Fahrzeug. Wenn Sie bei der Erstellung der Befehlsressource keine Werte für die obligatorischen Parameter angegeben haben, müssen Sie sie jetzt angeben. Weitere Informationen finden Sie unter [Senden Sie einen Befehl ()AWS CLI](send-monitor-remote-command-cli.md#send-remote-command-cli). ``` aws iot-jobs-data start-command-execution \ --command-arn arn:aws:iot:region:111122223333:command/ \ --target-arn arn:aws:iot:region:111122223333:thing/ ``` Antwort: ``` { "executionId": "" } ``` 1. Rufen Sie den Status des Vorgangs mit der Statusvorlage ab Nachdem Sie die Befehlsausführung gestartet haben, können Sie die `GetCommandExecution` API verwenden, um die Statusvorlage abzurufen. ``` aws iot get-command-execution --execution-id ``` # Verarbeiten Sie die letzten bekannten Statusfahrzeugdaten mithilfe von MQTT-Messaging **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). Abonnieren Sie das folgende MQTT-Thema, um Updates von Ihrem Fahrzeug zu erhalten und dessen Daten zu verarbeiten. Weitere Informationen finden Sie unter [MQTT-Themen](https://docs.aws.amazon.com/iot/latest/developerguide/iot-connect-devices.html) im *AWS IoT Core Developer* Guide. ``` $aws/iotfleetwise/vehicles/$vehicle_name/last_known_state/$state_template_name/data ``` Die letzten bekannten Statussignal-Aktualisierungsnachrichten werden möglicherweise nicht in der richtigen Reihenfolge empfangen, da MQTT die Reihenfolge nicht garantiert. Alle Kunden, die MQTT zum Empfangen und Verarbeiten von Fahrzeugdaten verwenden, müssen damit umgehen. Die letzten bekannten Statussignal-Aktualisierungsnachrichten folgen dem MQTT 5-Messaging-Protokoll. Der Nachrichtenkopf für jede MQTT-Nachricht hat die folgenden Benutzereigenschaften: + **VehicleName** [— Eine eindeutige Kennung der Fahrzeuge.](vehicles.md) + **stateTemplateName**— Eine eindeutige Kennung der letzten bekannten [Statusvorlage](state-templates.md). Darüber hinaus können Sie [Fahrzeugattribute](signal-catalogs.md) angeben, die in den MQTT-Nachrichtenkopf aufgenommen werden sollen, indem Sie den `metadataExtraDimensions` Anforderungsparameter bei der Aktualisierung oder Erstellung einer Statusvorlage angeben. (Siehe [Vorlagen für Bundesstaaten](state-templates.md).) Die Benutzereigenschaften im MQTT-Nachrichtenkopf sind nützlich, um Nachrichten an verschiedene Ziele weiterzuleiten, ohne die Nutzlast zu überprüfen. Die Nutzdaten der MQTT-Nachricht enthalten Daten, die von den Fahrzeugen gesammelt wurden. Sie können Fahrzeugattribute angeben, die in die MQTT-Nachrichtennutzlast aufgenommen werden sollen, indem Sie bei der Erstellung oder Aktualisierung einer Statusvorlage den `extraDimensions` Anforderungsparameter angeben (siehe). [Erstellen Sie eine AWS FleetWise IoT-Statusvorlage](state-templates.md) Die zusätzlichen Dimensionen bereichern die von den Fahrzeugen gesammelten Daten, indem sie ihnen zusätzliche Dimensionen zuordnen. Die Nutzdaten der MQTT-Nachricht sind in Protokollpuffern (Protobuf) kodiert, und der MQTT-Nachrichtenkopf enthält einen Inhaltstypindikator, der als application/octet-stream definiert ist. Das Protobuf-Kodierungsschema lautet wie folgt: ``` // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. // SPDX-License-Identifier: Apache-2.0 syntax = "proto3"; option java_package = "com.amazonaws.iot.autobahn.schemas.lastknownstate"; package Aws.IoTFleetWise.Schemas.CustomerMessage; message LastKnownState { /* * The absolute timestamp in milliseconds since Unix Epoch of when the event was triggered in vehicle. */ uint64 time_ms = 1; /* * This field is deprecated, use signals instead */ repeated Signal signal = 2 [ deprecated = true ]; repeated Signal signals = 3; repeated ExtraDimension extra_dimensions = 4; } message Signal { /* * The Fully Qualified Name of the signal is the path to the signal plus the signal's name. * For example, Vehicle.Chassis.SteeringWheel.HandsOff.HandsOffSteeringState * The fully qualified name can have up to 150 characters. Valid characters: a-z, A-Z, 0-9, : (colon), and _ (underscore). */ string name = 1; /* * The FWE reported signal value can be one of the following data types. */ oneof SignalValue { double double_value = 2; bool boolean_value = 3; sint32 int8_value = 4; uint32 uint8_value = 5; sint32 int16_value = 6; uint32 uint16_value = 7; sint32 int32_value = 8; uint32 uint32_value = 9; sint64 int64_value = 10; uint64 uint64_value = 11; float float_value = 12; /* * An UTF-8 encoded or 7-bit ASCII string */ string string_value = 13; } } message ExtraDimension { /* * The Fully Qualified Name of the attribute is the path to the attribute plus the attribute's name. * For example, Vehicle.Model.Color * The fully qualified name can have up to 150 characters. Valid characters: a-z, A-Z, 0-9, : (colon), and _ (underscore). */ string name = 1; oneof ExtraDimensionValue { /* * An UTF-8 encoded or 7-bit ASCII string */ string string_value = 2; } } ``` Wobei Folgendes gilt: + `time_ms`: Der absolute Zeitstempel (in Millisekunden seit der Unix-Epoche), zu dem das Ereignis im Fahrzeug ausgelöst wurde. Die Edge Agent-Software verwendet für diesen Zeitstempel die Uhr des Fahrzeugs. + `signal`: Ein Array von `Signal` s, das die Signalinformationen `name` (Zeichenfolge) enthält und `signalValue` die folgenden Datentypen unterstützt:`double`,`bool`,`int8`,`uint8`,`int16`,`uint16`,`int32`,`uint32`,`int64`, `uint64``float`,`string`. + `extra_dimensions`: Ein Array `ExtraDimensions` davon enthält Fahrzeugattributinformationen: `name` (Zeichenfolge) und `extraDimensionValue` unterstützt derzeit nur den `string` Datentyp.