AWS IoT FleetWise wird ab dem 30. April 2026 nicht mehr für Neukunden verfügbar sein. Bestehende AWS FleetWise IoT-Kunden können den Service weiterhin nutzen. Die [Leitlinien für vernetzte Mobilität am AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/) geben Hinweise zur Entwicklung und Bereitstellung modularer Dienste für vernetzte Mobilitätslösungen, mit denen vergleichbare Fähigkeiten wie das Internet der Dinge erreicht werden AWS IoT FleetWise. 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. # Starten und Überwachen von Befehlsausführungen **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). Nachdem Sie eine Befehlsressource erstellt haben, können Sie eine Befehlsausführung auf dem Zielfahrzeug starten. Sobald das Fahrzeug mit der Ausführung des Befehls beginnt, kann es damit beginnen, das Ergebnis der Befehlsausführung zu aktualisieren und Statusaktualisierungen und Ergebnisinformationen in den reservierten MQTT-Themen zu veröffentlichen. Sie können dann den Status der Befehlsausführung abrufen und den Status der Ausführungen in Ihrem Konto überwachen. In diesem Thema wird gezeigt, wie Sie mithilfe der AWS CLI oder der AWS FleetWise IoT-Konsole einen Befehl an Ihr Fahrzeug senden können. Außerdem erfahren Sie, wie Sie den Status der Befehlsausführung überwachen und aktualisieren können. **Topics** + [Das Ergebnis der Befehlsausführung aktualisieren](#update-remote-command-execution-cli) + [Holen Sie sich die Befehlsausführung](#get-remote-command-execution-cli) + [Listet die Befehlsausführungen in Ihrem Konto auf](#list-remote-command-execution-cli) + [Löscht die Ausführung eines Befehls](#delete-remote-command-execution-cli) ## Senden Sie einen Befehl (Konsole) Um einen Befehl von der Konsole aus zu senden, rufen Sie die Seite [Fahrzeuge](https://console.aws.amazon.com/iotfleetwise/home#/vehicles) der AWS FleetWise IoT-Konsole auf und führen Sie die folgenden Schritte aus. 1. Wählen Sie das Fahrzeug aus, an das Sie einen Befehl senden möchten. 1. Wählen Sie **Befehl ausführen** aus. 1. Wählen Sie die Befehls-ID aus. 1. Geben Sie das Zeitlimit für die Befehlsausführung an und wählen Sie dann **Befehl ausführen** aus. ## Senden Sie einen Befehl ()AWS CLI Sie können den API-Vorgang für die [https://docs.aws.amazon.com/iot/latest/apireference/API_iot_data_StartCommandExecution.html](https://docs.aws.amazon.com/iot/latest/apireference/API_iot_data_StartCommandExecution.html) AWS IoT Datenebene verwenden, um einen Befehl an ein Fahrzeug zu senden. Das Fahrzeug leitet den Befehl dann an einen Middleware-Dienst für die Automobilindustrie weiter (z. B. SOME/IP (Scalable Service-Oriented Middleware over IP)) oder veröffentlicht ihn in einem Fahrzeugnetzwerk (z. B. eine CAN-Geräteschnittstelle (Controller Area Network)). Das folgende Beispiel verwendet die AWS CLI. **Topics** + [Überlegungen beim Senden eines Befehls](#send-remote-command-considerations) + [Rufen Sie den kontospezifischen Endpunkt der Datenebene ab](#send-remote-command-endpoint) + [Senden Sie ein Befehlsbeispiel](#send-remote-command-example) ### Überlegungen beim Senden eines Befehls Wenn Sie die Ausführung eines Befehls starten in AWS IoT FleetWise: + Sie müssen AWS IoT etwas für das Fahrzeug bereitstellen. Weitere Informationen finden Sie unter [Bereitstellung von AWS FleetWise IoT-Fahrzeugen](provision-vehicles.md). + Sie müssen bereits einen Befehl mit dem Namespace `AWS-IoT-FleetWise` als Namespace erstellt und einen angegeben haben, der Ihnen `role-Arn` die Erlaubnis erteilt, Befehle in AWS IoT FleetWise zu erstellen und auszuführen. Weitere Informationen finden Sie unter [Erstellen Sie eine Befehlsressource](create-manage-remote-command-cli.md#create-remote-command-cli). + Sie können das `parameters` Feld überspringen, wenn Sie Standardwerte verwenden möchten, die bei der Erstellung des Befehls für die Parameter angegeben wurden. Wenn das bei der Erstellung `mandatory-parameters` nicht angegeben wurde oder wenn Sie Standardwerte überschreiben möchten, indem Sie Ihre eigenen Werte für die Parameter angeben, müssen Sie das `parameters` Feld angeben. Diese zusätzlichen Beispiele finden Sie unter[Szenarien zur Verwendung von Befehlen](remote-command-use-cases.md). + Sie können bis zu drei Name-Wert-Paare für das `mandatory-parameters` Feld angeben. Bei der Ausführung des Befehls auf dem Fahrzeug wird jedoch nur ein Name-Wert-Paar akzeptiert, und das `name` Feld muss den vollqualifizierten Namen mit dem Präfix verwenden. `$actuatorPath.` ### Rufen Sie den kontospezifischen Endpunkt der Datenebene ab Bevor Sie den API-Befehl ausführen, müssen Sie die kontospezifische Endpunkt-URL für den Endpunkt abrufen. `iot:Jobs` Wenn Sie z. B. den folgenden Befehl ausführen: ``` aws iot describe-endpoint --endpoint-type iot:Jobs ``` Es wird die kontospezifische Endpunkt-URL zurückgegeben, wie in der folgenden Beispielantwort gezeigt. ``` { "endpointAddress": "{{}}.jobs.iot.{{}}.amazonaws.com" } ``` ### Senden Sie ein Befehlsbeispiel Um einen Befehl an ein Fahrzeug zu senden, führen Sie den folgenden Befehl aus. + {{command-arn}}Ersetzen Sie durch den ARN für den Befehl, den Sie ausführen möchten. Sie können diese Informationen aus der Antwort des `create-command` CLI-Befehls abrufen. + {{target-arn}}Ersetzen Sie es durch den ARN für das Zielgerät oder die AWS IoT Sache, für die Sie den Befehl ausführen möchten. **Anmerkung** Sie können den Ziel-ARN einer AWS IoT Sache (AWS FleetWise IoT-Fahrzeug) angeben. Dinggruppen und Flotten werden derzeit nicht unterstützt. + {{endpoint-url}}Ersetzen Sie es durch den kontospezifischen Endpunkt, den Sie in abgerufen haben[Rufen Sie den kontospezifischen Endpunkt der Datenebene ab](#send-remote-command-endpoint), mit dem Präfix z. `https://` B. `https://{{123456789012abcd}}.jobs.iot.{{ap-south-1}}.amazonaws.com` + Ersetzen Sie {{name}} und {{value}} durch das `mandatory-parameters` Feld, das Sie bei der Erstellung des Befehls mit der `create-command` CLI angegeben haben. Das `name` Feld ist der vollqualifizierte Name, wie er im Signalkatalog definiert ist, mit `$actuatorPath.` dem Präfix. Kann {{$actuatorPath.Vehicle.Chassis.SteeringWheel.HandsOff.HandsOffSteeringMode}} und `name` `value` kann beispielsweise ein boolescher Wert sein, der einen Lenkmodusstatus wie anzeigt. {{{"B": false}}} + (Optional) Sie können auch einen zusätzlichen Parameter angeben,. `executionTimeoutSeconds` Dieses optionale Feld gibt die Zeit in Sekunden an, innerhalb derer das Gerät mit dem Ausführungsergebnis antworten muss. Sie können das Timeout auf einen Höchstwert von 24 Stunden konfigurieren. Wenn die Befehlsausführung erstellt wurde, wird ein Timer gestartet. Wenn sich der Status der Befehlsausführung vor Ablauf des Timers nicht in einen Status ändert, der ihn zum Terminal macht, z. B. `SUCCEEDED` oder`FAILED`, ändert sich der Status automatisch zu`TIMED_OUT`. **Anmerkung** Das Gerät kann auch einen `TIMED_OUT` Status melden oder diesen Status in einen Status wie`SUCCEEDED`, `FAILED` oder überschreiben`REJECTED`, und die Befehlsausführung wird zum Terminal. Weitere Informationen finden Sie unter [Status des Timeouts bei der Befehlsausführung](remote-command-concepts-states.md#remote-command-execution-status-timeout). ``` aws iot-jobs-data start-command-execution \ --command-arn {{command-arn}} \ --target-arn {{target-arn}} \ --execution-timeout-seconds {{30}} \ --endpoint-url {{endpoint-url}} \ --parameters '[ { "name": {{name}}, "value": {{value}} } ]' ``` Die `StartCommandExecution` API-Operation gibt eine Befehlsausführungs-ID zurück. Sie können diese ID verwenden, um den Status der Befehlsausführung, die Details und den Verlauf der Befehlsausführung abzufragen. ``` { "executionId": "07e4b780-7eca-4ffd-b772-b76358da5542" } ``` Nachdem Sie den Befehl ausgeführt haben, erhalten Ihre Geräte eine Benachrichtigung mit den folgenden Informationen. Das `issued_timestamp_ms` Feld entspricht der Uhrzeit, zu der die `StartCommandExecution` API aufgerufen wurde. Das `timeout_ms` entspricht dem Timeout-Wert, der beim Aufrufen der API mithilfe des `executionTimeoutSeconds` Parameters konfiguriert wurde. `StartCommandExecution` ``` timeout_ms: {{9000000}} issued_timestamp_ms: {{1723847831317}} ``` ## Das Ergebnis der Befehlsausführung aktualisieren Um den Status der Befehlsausführung zu aktualisieren, muss Ihr Gerät eine MQTT-Verbindung hergestellt und das folgende Thema zur Befehlsanfrage abonniert haben. Ersetzen Sie in diesem Beispiel durch die eindeutige Kennung Ihres Zielgeräts, {{``}} bei der es sich um den Namen `VehicleId` oder den Namen der Sache handeln kann, und {{``}} durch die Kennung für die Befehlsausführung. **Anmerkung** Die Payload muss das Protobuf-Format verwenden. Es ist für Ihre Geräte optional, die Themen `/accepted` und `/rejected` Antworten zu abonnieren. Ihre Geräte erhalten diese Antwortnachrichten auch dann, wenn sie sie nicht ausdrücklich abonniert haben. ``` // Request topic $aws/devices/{{}}/command_executions/+/request/protobuf // Response topics (Optional) $aws/devices/{{}}/command_executions/{{}}/response/accepted/protobuf $aws/devices/{{}}/command_executions/{{}}/response/rejected/protobuf ``` Ihr Gerät kann eine Nachricht zum Thema Befehlsantwort veröffentlichen. Nach der Verarbeitung des Befehls wird eine protobuf-kodierte Antwort zu diesem Thema gesendet. Das {{}} Feld muss mit dem entsprechenden Feld im Anforderungsthema übereinstimmen. ``` $aws/devices/{{}}/command_executions/{{}}/response/{{}} ``` Nachdem Ihr Gerät eine Antwort zu diesem Thema veröffentlicht hat, können Sie die aktualisierten Statusinformationen mithilfe der `GetCommandExecution` API abrufen. Der Status der Befehlsausführung kann einer der hier aufgeführten sein. + `IN_PROGRESS` + `SUCCEEDED` + `FAILED` + `REJECTED` + `TIMED_OUT` Beachten Sie, dass es sich bei der Ausführung eines Befehls in einem der Status `SUCCEEDED``FAILED`, und um `REJECTED` ein Terminal handelt und der Status vom Gerät gemeldet wird. Wenn ein Befehl terminalförmig ausgeführt wird, bedeutet dies, dass der Status oder die zugehörigen Felder nicht weiter aktualisiert werden. Ein `TIMED_OUT` Status kann vom Gerät oder der Cloud gemeldet werden. Wenn es von der Cloud gemeldet wird, kann das Gerät später eine Aktualisierung des Felds für den Statusgrund vornehmen. Im Folgenden wird beispielsweise eine MQTT-Beispielnachricht gezeigt, die vom Gerät veröffentlicht wurde. **Anmerkung** Für den Status der Befehlsausführung müssen Sie Folgendes sicherstellen, wenn Ihre Geräte das `statusReason` Objekt zum Veröffentlichen der Statusinformationen verwenden: Der `reasonCode` verwendet das Muster `[A-Z0-9_-]+` und es ist nicht länger als 64 Zeichen. Das `reasonDescription` ist nicht länger als 1.024 Zeichen. Es können alle Zeichen außer Steuerzeichen wie Zeilenumbrüchen verwendet werden. ``` { "deviceId": "", "executionId": "", "status": "CREATED", "statusReason": { "reasonCode": "", "reasonDescription": "" } } ``` Ein Beispiel, das zeigt, wie Sie den AWS IoT Core MQTT-Testclient verwenden können, um die Themen zu abonnieren und die Meldungen zur Befehlsausführung zu [sehen, finden Sie unter Befehlsaktualisierungen mit dem MQTT-Testclient](https://docs.aws.amazon.com/iot/latest/developerguide/iot-remote-command-execution-start-monitor.html#iot-remote-command-execution-update-mqtt) anzeigen im *AWS IoT Core Entwicklerhandbuch*. ## Holen Sie sich die Befehlsausführung Sie können den API-Vorgang der [https://docs.aws.amazon.com/iot/latest/apireference/API_GetCommandExecution.html](https://docs.aws.amazon.com/iot/latest/apireference/API_GetCommandExecution.html) AWS IoT Steuerungsebene verwenden, um Informationen über die Ausführung eines Befehls abzurufen. Sie müssen diesen Befehl bereits mithilfe der `StartCommandExecution` API-Operation ausgeführt haben. Führen Sie den folgenden Befehl aus, um die Metadaten eines ausgeführten Befehls abzurufen. + {{execution-id}}Ersetzen Sie ihn durch die ID des Befehls. Sie können diese Informationen aus der Antwort des `start-command-execution` CLI-Befehls abrufen. + {{target-arn}}Ersetzen Sie es durch den ARN für das Zielfahrzeug AWS IoT oder Objekt, für das Sie den Befehl ausführen möchten. ``` aws iot get-command-execution --execution-id {{execution-id}} \ --target-arn {{target-arn}} ``` Die `GetCommandExecution` API-Operation gibt eine Antwort zurück, die Informationen über den ARN der Befehlsausführung, den Ausführungsstatus und den Zeitpunkt enthält, zu dem der Befehl ausgeführt wurde und wann er abgeschlossen wurde. Der folgende Code zeigt eine Beispielantwort aus der API-Anfrage. Um zusätzlichen Kontext zum Status der einzelnen Befehlsausführungen bereitzustellen, stellt die Befehlsfunktion ein `statusReason` Objekt bereit. Das Objekt enthält zwei Felder `reasonCode` und`reasonDescription`. Mithilfe dieser Felder können Ihre Geräte zusätzliche Informationen über den Status der Befehlsausführung bereitstellen. Diese Informationen überschreiben alle `reasonCode` Standardwerte`reasonDescription`, die aus der Cloud gemeldet werden. Um diese Informationen zu melden, können Ihre Geräte die aktualisierten Statusinformationen in der Cloud veröffentlichen. Wenn Sie dann den Status der Befehlsausführung mithilfe der `GetCommandExecution` API abrufen, werden Ihnen die neuesten Statuscodes angezeigt. **Anmerkung** Das `completedAt` Feld in der Ausführungsantwort entspricht dem Zeitpunkt, zu dem das Gerät einen Terminalstatus an die Cloud meldet. Im Fall eines `TIMED_OUT` Status wird dieses Feld nur gesetzt, wenn das Gerät einen Timeout meldet. Wenn der `TIMED_OUT` Status von der Cloud festgelegt wird, wird der `TIMED_OUT` Status nicht aktualisiert. Weitere Informationen zum Timeout-Verhalten finden Sie unter[Status des Timeouts bei der Befehlsausführung](remote-command-concepts-states.md#remote-command-execution-status-timeout). ``` { "executionId": "07e4b780-7eca-4ffd-b772-b76358da5542", "commandArn": "arn:aws:iot:ap-south-1:123456789012:command/LockDoor", "targetArn": "arn:aws:iot:ap-south-1:123456789012:thing/myFrontDoor", "status": "SUCCEEDED", "statusReason": { "reasonCode": "65536", "reasonDescription": "SUCCESS" }, "createdAt": "2024-03-23T00:50:10.095000-07:00", "completedAt": "2024-03-23T00:50:10.095000-07:00", "Parameters": '{ "$actuatorPath.Vehicle.Chassis.SteeringWheel.HandsOff.HandsOffSteeringMode": { "B": true } }' } ``` ## Listet die Befehlsausführungen in Ihrem Konto auf Verwenden Sie den HTTP-API-Vorgang der [https://docs.aws.amazon.com/iot/latest/apireference/API_ListCommandExecutions.html](https://docs.aws.amazon.com/iot/latest/apireference/API_ListCommandExecutions.html) AWS IoT Core Steuerungsebene, um alle Befehlsausführungen in Ihrem Konto aufzulisten. Das Beispiel verwendet das AWS CLI. **Topics** + [Überlegungen beim Auflisten von Befehlsausführungen](#list-remote-command-considerations) + [Beispiel für Befehlsausführungen auflisten](#list-remote-command-example) ### Überlegungen beim Auflisten von Befehlsausführungen Im Folgenden sind einige Überlegungen zur Verwendung der `ListCommandExecutions` API aufgeführt. + Sie müssen mindestens das `targetArn` oder das angeben, `commandArn` je nachdem, ob Sie Ausführungen für einen bestimmten Befehl oder ein Zielfahrzeug auflisten möchten. Die API-Anforderung darf nicht leer sein und nicht beide Felder in derselben Anfrage enthalten. + Sie müssen nur die `startedTimeFilter` oder die `completedTimeFilter` Informationen angeben. Die API-Anforderung darf nicht leer sein und nicht beide Felder in derselben Anfrage enthalten. Sie können die `after` Felder `before` und des Objekts verwenden, um Befehlsausführungen aufzulisten, die innerhalb eines bestimmten Zeitraums entweder erstellt oder abgeschlossen wurden. + `before`Sowohl die `after` Felder als auch dürfen nicht größer als die aktuelle Uhrzeit sein. Wenn Sie keinen Wert angeben, entspricht das `before` Feld standardmäßig der aktuellen Uhrzeit und dem `after` Feld der aktuellen Uhrzeit — 6 Monate. Das heißt, je nach verwendetem Filter listet die API alle Ausführungen auf, die in den letzten sechs Monaten entweder erstellt oder abgeschlossen wurden. + Sie können den `sort-order` Parameter verwenden, um anzugeben, ob Sie die Ausführungen in aufsteigender Reihenfolge auflisten möchten. Standardmäßig werden die Ausführungen in absteigender Reihenfolge aufgeführt, wenn Sie dieses Feld nicht angeben. + Sie können die Befehlsausführungen nicht nach ihrem Status filtern, wenn Sie Befehlsausführungen für einen Befehl-ARN auflisten. ### Beispiel für Befehlsausführungen auflisten Das folgende Beispiel zeigt Ihnen, wie Sie Befehlsausführungen in Ihrem auflisten. AWS-Konto Bei der Ausführung des Befehls müssen Sie angeben, ob die Liste so gefiltert werden soll, dass nur Befehlsausführungen angezeigt werden, die mit dem für ein bestimmtes Gerät erstellt wurden`targetArn`, oder Ausführungen für einen bestimmten Befehl, der mit dem angegeben wurde. `commandArn` Ersetzen Sie in diesem Beispiel: + {{``}}mit der Amazon-Ressourcennummer (ARN) des Geräts, für das Sie die Ausführung planen, z. `arn:aws:iot:{{us-east-1}}:{{123456789012}}:thing/{{b8e4157c98f332cffb37627f}}` B. + {{``}}mit der Amazon-Ressourcennummer (ARN) des Geräts, für das Sie die Ausführung planen, z. `arn:aws:iot:{{us-east-1}}:{{123456789012}}:thing/{{b8e4157c98f332cffb37627f}}` B. + {{``}}mit der Zeit, nach der Sie die Ausführungen auflisten möchten, die erstellt wurden, zum Beispiel. `2024-11-01T03:00` ``` aws iot list-command-executions \ --target-arn {{}} \ --started-time-filter '{after={{}}}' \ --sort-order "ASCENDING" ``` Wenn Sie diesen Befehl ausführen, wird eine Antwort generiert, die eine Liste der von Ihnen erstellten Befehlsausführungen sowie die Uhrzeit enthält, zu der die Ausführung begonnen und abgeschlossen wurde. Es enthält auch Statusinformationen und das `statusReason` Objekt, das zusätzliche Informationen über den Status enthält. ``` { "commandExecutions": [ { "commandArn": "arn:aws:iot:us-east-1:123456789012:command/TestMe002", "executionId": "b2b654ca-1a71-427f-9669-e74ae9d92d24", "targetArn": "arn:aws:iot:us-east-1:123456789012:thing/b8e4157c98f332cffb37627f", "status": "TIMED_OUT", "createdAt": "2024-11-24T14:39:25.791000-08:00", "startedAt": "2024-11-24T14:39:25.791000-08:00" }, { "commandArn": "arn:aws:iot:us-east-1:123456789012:command/TestMe002", "executionId": "34bf015f-ef0f-4453-acd0-9cca2d42a48f", "targetArn": "arn:aws:iot:us-east-1:123456789012:thing/b8e4157c98f332cffb37627f", "status": "IN_PROGRESS", "createdAt": "2024-11-24T14:05:36.021000-08:00", "startedAt": "2024-11-24T14:05:36.021000-08:00" } ] } ``` ## Löscht die Ausführung eines Befehls Wenn Sie eine Befehlsausführung nicht mehr verwenden möchten, können Sie sie dauerhaft aus Ihrem Konto entfernen. **Anmerkung** Eine Befehlsausführung kann nur gelöscht werden, wenn sie einen Terminalstatus wie `SUCCEEDED``FAILED`, oder erreicht hat`REJECTED`. Das folgende Beispiel zeigt Ihnen, wie Sie eine Befehlsausführung mithilfe des `delete-command-execution` AWS CLI Befehls löschen. {{``}}Ersetzen Sie es durch den Bezeichner der Befehlsausführung, die Sie löschen möchten. ``` aws iot delete-command-execution --execution-id {{}} ``` Wenn die API-Anfrage erfolgreich ist, generiert die Befehlsausführung den Statuscode 200. Sie können die `GetCommandExecution` API verwenden, um zu überprüfen, ob die Befehlsausführung in Ihrem Konto nicht mehr vorhanden ist.