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. # AWS FleetWise IoT-Fahrzeuge verwalten Fahrzeuge sind Beispiele für Fahrzeugmodelle. Fahrzeuge müssen anhand eines Fahrzeugmodells erstellt und einem Decoder-Manifest zugeordnet werden. Vehicles lädt einen oder mehrere Datenströme in die Cloud hoch. Beispielsweise kann ein Fahrzeug Daten zu Kilometerstand, Motortemperatur und Zustand der Heizung an die Cloud senden. Jedes Fahrzeug enthält die folgenden Informationen: `vehicleName` Eine ID, die das Fahrzeug identifiziert. Fügen Sie Ihrem Fahrzeugnamen keine personenbezogenen Daten (PII) oder andere vertrauliche oder sensible Informationen hinzu. Fahrzeugnamen sind für andere AWS Dienste, einschließlich Amazon, zugänglich CloudWatch. Fahrzeugnamen sind nicht dazu bestimmt, für private oder sensible Daten verwendet zu werden. `modelManifestARN` Der Amazon-Ressourcenname (ARN) eines Fahrzeugmodells (Modellmanifest). Jedes Fahrzeug wird aus einem Fahrzeugmodell erstellt. Fahrzeuge, die mit demselben Fahrzeugmodell erstellt wurden, bestehen aus derselben Gruppe von Signalen, die vom Fahrzeugmodell übernommen wurden. Diese Signale sind im Signalkatalog definiert und standardisiert. `decoderManifestArn` Der ARN des Decoder-Manifests. Ein Decoder-Manifest bietet Dekodierungsinformationen, die das AWS IoT verwenden FleetWise kann, um Rohsignaldaten (Binärdaten) in für Menschen lesbare Werte umzuwandeln. Ein Decoder-Manifest muss einem Fahrzeugmodell zugeordnet sein. AWS IoT FleetWise verwendet dasselbe Decoder-Manifest, um Rohdaten von Fahrzeugen zu dekodieren, die auf der Grundlage desselben Fahrzeugmodells erstellt wurden. `attributes` Attribute sind Schlüssel-Wert-Paare, die statische Informationen enthalten. Fahrzeuge können Attribute enthalten, die vom Fahrzeugmodell übernommen wurden. Sie können zusätzliche Attribute hinzufügen, um ein einzelnes Fahrzeug von anderen Fahrzeugen zu unterscheiden, die mit demselben Fahrzeugmodell erstellt wurden. Wenn Sie beispielsweise ein schwarzes Auto haben, können Sie den folgenden Wert für ein Attribut angeben:`{"color": "black"}`. Attribute müssen im zugehörigen Fahrzeugmodell definiert werden, bevor Sie sie einzelnen Fahrzeugen hinzufügen können. Weitere Informationen zu Fahrzeugmodellen, Decoder-Manifesten und Attributen finden Sie unter[AWS FleetWise IoT-Fahrzeuge modellieren](vehicle-modeling.md). AWS IoT FleetWise bietet die folgenden API-Operationen, mit denen Sie Fahrzeuge erstellen und verwalten können. + [CreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateVehicle.html)— Erzeugt ein neues Fahrzeug. + [BatchCreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchCreateVehicle.html)— Erzeugt ein oder mehrere neue Fahrzeuge. + [UpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateVehicle.html)— Aktualisiert ein vorhandenes Fahrzeug. + [BatchUpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchUpdateVehicle.html)— Aktualisiert ein oder mehrere bestehende Fahrzeuge. + [DeleteVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteVehicle.html)— Löscht ein vorhandenes Fahrzeug. + [ListVehicles](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehicles.html)— Ruft eine paginierte Liste mit Zusammenfassungen aller Fahrzeuge ab. + [GetVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetVehicle.html)— Ruft Informationen über ein Fahrzeug ab. **Topics** + [Bereitstellung von AWS FleetWise IoT-Fahrzeugen](provision-vehicles.md) + [Reservierte Themen im AWS Internet der Dinge FleetWise](reserved-topics.md) + [Erstellen Sie ein AWS FleetWise IoT-Fahrzeug](create-vehicle.md) + [Erstellen Sie mehrere AWS FleetWise IoT-Fahrzeuge](create-vehicles-cli.md) + [Ein AWS FleetWise IoT-Fahrzeug aktualisieren](update-vehicle-cli.md) + [Aktualisieren Sie mehrere AWS FleetWise IoT-Fahrzeuge](update-vehicles-cli.md) + [Löschen Sie ein AWS FleetWise IoT-Fahrzeug](delete-vehicle.md) + [Holen Sie sich AWS FleetWise IoT-Fahrzeuginformationen](get-vehicle-information-cli.md) # Bereitstellung von AWS FleetWise IoT-Fahrzeugen Die Edge Agent for AWS FleetWise IoT-Software, die in Ihrem Fahrzeug ausgeführt wird, sammelt und überträgt Daten in die Cloud. AWS IoT FleetWise lässt sich integrieren AWS IoT Core , um die sichere Kommunikation zwischen der Edge Agent-Software und der Cloud über MQTT zu unterstützen. Jedes Fahrzeug entspricht einer AWS IoT Sache. Sie können ein vorhandenes Objekt verwenden AWS IoT , um ein Fahrzeug zu erstellen, oder AWS IoT so einstellen FleetWise , dass automatisch ein Objekt AWS IoT für Ihr Fahrzeug erstellt wird. Weitere Informationen finden Sie unter [Erstellen Sie ein AWS FleetWise IoT-Fahrzeug](create-vehicle.md). AWS IoT Core unterstützt [Authentifizierung](https://docs.aws.amazon.com/iot/latest/developerguide/authentication.html) und [Autorisierung](https://docs.aws.amazon.com/iot/latest/developerguide/iot-authorization.html), mit deren Hilfe der Zugriff auf AWS FleetWise IoT-Ressourcen sicher gesteuert werden kann. Fahrzeuge können X.509-Zertifikate verwenden, um sich zu authentifizieren (anzumelden), um AWS IoT zu nutzen, FleetWise und AWS IoT Core Richtlinien, um autorisiert zu werden (über Berechtigungen zu verfügen), um bestimmte Aktionen auszuführen. ## Fahrzeuge authentifizieren Sie können AWS IoT Core Richtlinien zur Authentifizierung Ihrer Fahrzeuge erstellen. **Um Ihr Fahrzeug zu authentifizieren** + Führen Sie den folgenden Befehl aus, um eine AWS IoT Core Richtlinie zu erstellen. + *policy-name*Ersetzen Sie es durch den Namen der Richtlinie, die Sie erstellen möchten. + *file-name*Ersetzen Sie es durch den Namen der JSON-Datei, die die AWS IoT Core Richtlinie enthält. ``` aws iot create-policy --policy-name policy-name --policy-document file://file-name.json ``` ### Beispiel für AWS IoT Core eine Richtlinie Bevor Sie die Beispielrichtlinie verwenden, gehen Sie wie folgt vor: + *us-east-1*Ersetzen Sie durch die AWS Region, in der Sie AWS FleetWise IoT-Ressourcen erstellt haben. + *111122223333*Ersetzen Sie es durch Ihre AWS Konto-ID. Dieses Beispiel beinhaltet Themen, die dem AWS Internet der Dinge vorbehalten sind FleetWise. Sie müssen die Themen zur Richtlinie hinzufügen. Weitere Informationen finden Sie unter [Reservierte Themen im AWS Internet der Dinge FleetWise](reserved-topics.md). ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:Connect" ], "Resource": [ "arn:aws:iot:us-east-1:111122223333:client/${iot:Connection.Thing.ThingName}" ] }, { "Effect": "Allow", "Action": [ "iot:Publish" ], "Resource": [ "arn:aws:iot:us-east-1:111122223333:topic/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/checkins", "arn:aws:iot:us-east-1:111122223333:topic/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/signals" ] }, { "Effect": "Allow", "Action": [ "iot:Subscribe" ], "Resource": [ "arn:aws:iot:us-east-1:111122223333:topicfilter/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/collection_schemes", "arn:aws:iot:us-east-1:111122223333:topicfilter/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/decoder_manifests" ] }, { "Effect": "Allow", "Action": [ "iot:Receive" ], "Resource": [ "arn:aws:iot:us-east-1:111122223333:topic/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/collection_schemes", "arn:aws:iot:us-east-1:111122223333:topic/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/decoder_manifests" ] } ] } ``` ------ ## Fahrzeuge autorisieren Sie können X.509-Zertifikate erstellen, um Ihre Fahrzeuge zu autorisieren. **Um Ihr Fahrzeug zu autorisieren** **Wichtig** Wir empfehlen Ihnen, für jedes Fahrzeug ein neues Zertifikat zu erstellen. 1. Führen Sie den folgenden Befehl aus, um ein RSA-Schlüsselpaar zu erstellen und ein X.509-Zertifikat auszustellen. + *cert*Ersetzen Sie es durch den Namen der Datei, die den Inhalt der Befehlsausgabe von CertificatePEM speichert. + *public-key*Ersetzen Sie es durch den Namen der Datei, die den Inhalt der Befehlsausgabe von KeyPair speichert. PublicKey. + *private-key*Ersetzen Sie es durch den Namen der Datei, die den Inhalt der Befehlsausgabe von KeyPair speichert. PrivateKey. ``` aws iot create-keys-and-certificate \ --set-as-active \ --certificate-pem-outfile cert.pem \ --public-key-outfile public-key.key" \ --private-key-outfile private-key.key" ``` 1. Kopieren Sie den Amazon-Ressourcennamen (ARN) des Zertifikats aus der Ausgabe. 1. Führen Sie den folgenden Befehl aus, um die Richtlinie an das Zertifikat anzuhängen. + *policy-name*Ersetzen Sie es durch den Namen der AWS IoT Core Richtlinie, die Sie erstellt haben. + *certificate-arn*Ersetzen Sie es durch den ARN des Zertifikats, das Sie kopiert haben. ``` aws iot attach-policy \ --policy-name policy-name\ --target "certificate-arn" ``` 1. Führen Sie den folgenden Befehl aus, um das Zertifikat an das Ding anzuhängen. + *thing-name*Ersetze es durch den Namen deiner AWS IoT Sache oder die ID deines Fahrzeugs. + *certificate-arn*Ersetzen Sie es durch den ARN des Zertifikats, das Sie kopiert haben. ``` aws iot attach-thing-principal \ --thing-name thing-name \ --principal "certificate-arn" ``` # Reservierte Themen im AWS Internet der Dinge FleetWise **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). AWS IoT FleetWise behält sich die Verwendung der folgenden Themen vor. Wenn das reservierte Thema es zulässt, können Sie es abonnieren oder veröffentlichen. Sie können jedoch keine neuen Themen erstellen, die mit einem Dollarzeichen (\$1) beginnen. Wenn Sie nicht unterstützte Veröffentlichungs- oder Abonnementvorgänge mit reservierten Themen verwenden, kann dies dazu führen, dass die Verbindung beendet wird. | Thema | Client-Betrieb zulässig | Description | | --- | --- | --- | | `$aws/iotfleetwise/vehicles/vehicleName/checkins` | Veröffentlichen | Die Edge Agent-Software veröffentlicht Fahrzeugstatusinformationen zu diesem Thema. Fahrzeugstatusinformationen werden im Protokollpufferformat (Protobuf) ausgetauscht. Weitere Informationen finden Sie im [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models). | | `$aws/iotfleetwise/vehicles/vehicleName/signals` | Veröffentlichen | Die Edge Agent-Software veröffentlicht Signale zu diesem Thema. Signalinformationen werden im Protokollpufferformat (Protobuf) ausgetauscht. Weitere Informationen finden Sie im [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models). | | `$aws/iotfleetwise/vehicles/vehicleName/collection_schemes` | Abonnieren | AWS IoT FleetWise veröffentlicht Datenerfassungsschemata zu diesem Thema. Fahrzeuge nutzen diese Datenerfassungsschemata. | | `$aws/iotfleetwise/vehicles/vehicleName/decoder_manifests` | Abonnieren | AWS IoT FleetWise veröffentlicht Decoder-Manifeste zu diesem Thema. Fahrzeuge verbrauchen diese Decoder-Manifeste. | | `$aws/iotfleetwise/vehicles/vehicleName/command/request` | Abonnieren | AWS IoT FleetWise veröffentlicht Anfragen zur Ausführung von Befehlen zu diesem Thema. Fahrzeuge verarbeiten diese Befehlsanforderungen dann. | | `$aws/iotfleetwise/vehicles/vehicleName/command/response` | Veröffentlichen | Die Edge Agent-Software veröffentlicht Befehlsantworten des Fahrzeugs zu diesem Thema. Befehlsantworten werden im Protokollpufferformat (Protobuf) ausgetauscht. Weitere Informationen finden Sie im [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models). | | `$aws/iotfleetwise/vehicles/vehicleName/command/notification` | Abonnieren | AWS IoT FleetWise veröffentlicht Befehlsstatusaktualisierungen zu diesem Thema. Die Benachrichtigungen werden in einem JSON-Format gesendet. | | `$aws/iotfleetwise/vehicles/$vehicle_name/last_known_states/config` | Abonnieren | AWS IoT FleetWise veröffentlicht Statusvorlagenkonfigurationen zu diesem Thema. Fahrzeuge verwenden diese Statusvorlagenkonfigurationen. | | `$aws/iotfleetwise/vehicles/$vehicle_name/last_known_states/data` | Veröffentlichen | Die Edge Agent-Software veröffentlicht die aus den Signalen gesammelten Daten zu diesem Thema. | | `$aws/iotfleetwise/vehicles/$vehicle_name/last_known_state/$state_template_name/data` | Abonnieren | AWS IoT FleetWise veröffentlicht Daten, die anhand der im Abschnitt `$state_template_name` zu diesem Thema konfigurierten Signale gesammelt wurden. Die Aktualisierungen können teilweise sein. Wenn beispielsweise eine Zustandsvorlagenzuordnung mehrere Signale mit der Aktualisierungsstrategie bei Änderung enthält, dann sind nur die Signale, die sich geändert haben, in einer bestimmten Nachricht enthalten. Signalinformationen werden im Protokollpufferformat (Protobuf) ausgetauscht. Weitere Informationen finden Sie im [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models). | # Erstellen Sie ein AWS FleetWise IoT-Fahrzeug **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 die AWS FleetWise IoT-Konsole oder API verwenden, um ein Fahrzeug zu erstellen. **Wichtig** Bevor Sie beginnen, überprüfen Sie Folgendes: Sie müssen über ein Fahrzeugmodell verfügen und der Status des Fahrzeugmodells muss lauten`ACTIVE`. Weitere Informationen finden Sie unter [AWS FleetWise IoT-Fahrzeugmodelle verwaltenFahrzeugmodelle](vehicle-models.md). Ihr Fahrzeugmodell muss mit einem Decoder-Manifest verknüpft sein, und der Status des Decoder-Manifests muss lauten. `ACTIVE` Weitere Informationen finden Sie unter [AWS FleetWise IoT-Decoder-Manifeste verwalten](decoder-manifests.md). **Topics** + [Erstellen Sie ein Fahrzeug (Konsole)](#create-vehicle-console) + [Erstellen Sie ein Fahrzeug (AWS CLI)](#create-vehicle-cli) ## Erstellen Sie ein Fahrzeug (Konsole) Sie können die AWS FleetWise IoT-Konsole verwenden, um ein Fahrzeug zu erstellen. **Um ein Fahrzeug zu erstellen** 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 auf der Seite mit der Fahrzeugübersicht die Option **Fahrzeug erstellen** aus, und führen Sie dann die folgenden Schritte aus. **Topics** + [Schritt 1: Definieren Sie die Fahrzeugeigenschaften](#define-vehicle-properties-console) + [Schritt 2: Fahrzeugzertifikat konfigurieren](#define-vehicle-certificate-console) + [Schritt 3: Richtlinien an das Zertifikat anhängen](#attach-vehicle-policy-console) + [Schritt 4: Überprüfen und Erstellen](#review-and-create-vehicle-console) ### Schritt 1: Definieren Sie die Fahrzeugeigenschaften In diesem Schritt benennen Sie das Fahrzeug und verknüpfen es mit dem Modellmanifest und dem Decoder-Manifest. 1. Geben Sie einen eindeutigen Namen für das Fahrzeug ein. **Wichtig** Ein Fahrzeug entspricht einer AWS IoT Sache. Wenn bereits ein Objekt mit diesem Namen existiert, wählen Sie **Fahrzeug mit einem IoT-Ding verknüpfen, um das** Ding mit dem Fahrzeug zu aktualisieren. Oder wählen Sie einen anderen Fahrzeugnamen und AWS IoT erstellt FleetWise automatisch eine neue Sache für das Fahrzeug. 1. Wählen Sie ein Fahrzeugmodell (Modellmanifest) aus der Liste aus. 1. Wählen Sie ein Decoder-Manifest aus der Liste aus. Das Decoder-Manifest ist dem Fahrzeugmodell zugeordnet. 1. (Optional) Um Fahrzeugattribute zuzuordnen, wählen Sie **Attribute hinzufügen**. Wenn Sie diesen Schritt überspringen, müssen Sie nach der Erstellung des Fahrzeugs Attribute hinzufügen, bevor Sie es für Kampagnen einsetzen können. 1. (Optional) Um Tags mit dem Fahrzeug zu verknüpfen, wählen Sie **Neues Tag hinzufügen**. Sie können Tags auch hinzufügen, nachdem das Fahrzeug erstellt wurde. 1. Wählen Sie **Weiter** aus. ### Schritt 2: Fahrzeugzertifikat konfigurieren Um Ihr Fahrzeug als Objekt verwenden zu AWS IoT können, müssen Sie ein Fahrzeugzertifikat mit einer angehängten Richtlinie konfigurieren. Wenn Sie diesen Schritt überspringen, müssen Sie nach der Erstellung des Fahrzeugs ein Zertifikat konfigurieren, bevor Sie es für Kampagnen einsetzen können. 1. Wählen Sie **Neues Zertifikat automatisch generieren (empfohlen)**. 1. Wählen Sie **Weiter** aus. ### Schritt 3: Richtlinien an das Zertifikat anhängen Hängen Sie eine Richtlinie an das Zertifikat an, das Sie im vorherigen Schritt konfiguriert haben. 1. Geben Sie **unter Richtlinien** einen vorhandenen Richtliniennamen ein. Um eine neue Richtlinie zu erstellen, wählen Sie **Richtlinie erstellen** aus. 1. Wählen Sie **Weiter** aus. ### Schritt 4: Überprüfen und Erstellen Überprüfen Sie die Konfigurationen für das Fahrzeug und wählen Sie dann **Fahrzeug erstellen** aus. **Wichtig** Nachdem das Fahrzeug erstellt wurde, müssen Sie das Zertifikat und die Schlüssel herunterladen. Sie verwenden das Zertifikat und den privaten Schlüssel, um das Fahrzeug in der Edge Agent for AWS FleetWise IoT-Software zu verbinden. ## Erstellen Sie ein Fahrzeug (AWS CLI) Wenn Sie ein Fahrzeug erstellen, müssen Sie ein Fahrzeugmodell verwenden, das einem Decoder-Manifest zugeordnet ist. Sie können den [CreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateVehicle.html)API-Vorgang verwenden, um ein Fahrzeug zu erstellen. Das folgende Beispiel verwendet die AWS CLI. Führen Sie den folgenden Befehl aus, um ein Fahrzeug zu erstellen. *file-name*Ersetzen Sie ihn durch den Namen der JSON-Datei, die die Fahrzeugkonfiguration enthält. ``` aws iotfleetwise create-vehicle --cli-input-json file://file-name.json ``` **Example — Fahrzeugkonfiguration** + (Optional) Der `associationBehavior` Wert kann einer der folgenden sein: + `CreateIotThing`— Wenn Ihr Fahrzeug erstellt wird, erstellt AWS IoT FleetWise automatisch eine AWS IoT Sache mit dem Namen Ihrer Fahrzeug-ID für Ihr Fahrzeug. + `ValidateIotThingExists`— Verwenden Sie ein vorhandenes AWS IoT Objekt, um ein Fahrzeug zu erstellen. Um ein AWS IoT Ding zu erstellen, führen Sie den folgenden Befehl aus. *thing-name*Ersetzen Sie es durch den Namen des Dings, das Sie erstellen möchten. ``` aws iot create-thing --thing-name thing-name ``` Wenn es nicht spezifiziert ist, erstellt AWS IoT FleetWise automatisch AWS IoT etwas für Ihr Fahrzeug. **Wichtig** Stellen Sie sicher, dass das AWS IoT Ding nach der Erstellung des Fahrzeugs bereitgestellt wird. Weitere Informationen finden Sie unter [Bereitstellung von AWS FleetWise IoT-Fahrzeugen](provision-vehicles.md). + *vehicle-name*Ersetzen Sie es durch eine der folgenden Optionen. + Der Name Ihres Dings AWS IoT , falls `associationBehavior` es so konfiguriert ist`ValidateIotThingExists`. + Die ID des Fahrzeugs, für das es erstellt werden soll, `associationBehavior` ist konfiguriert`CreateIotThing`. Die Fahrzeug-ID kann 1—100 Zeichen lang sein. Gültige Zeichen: a—z, A—Z, 0—9, Bindestrich (‐), Unterstrich (\$1) und Doppelpunkt (:). + *model-manifest-ARN*Ersetzen Sie es durch den ARN Ihres Fahrzeugmodells (Modellmanifest). + Durch den *decoder-manifest-ARN* ARN des Decoder-Manifests ersetzen, das dem angegebenen Fahrzeugmodell zugeordnet ist. + (Optional) Sie können zusätzliche Attribute hinzufügen, um dieses Fahrzeug von anderen Fahrzeugen zu unterscheiden, die mit demselben Fahrzeugmodell erstellt wurden. Wenn Sie beispielsweise ein Elektroauto haben, können Sie den folgenden Wert für ein Attribut angeben:`{"fuelType": "electric"}`. **Wichtig** Attribute müssen im zugehörigen Fahrzeugmodell definiert werden, bevor Sie sie einzelnen Fahrzeugen hinzufügen können. ``` { "associationBehavior": "associationBehavior", "vehicleName": "vehicle-name", "modelManifestArn": "model-manifest-ARN", "decoderManifestArn": "decoder-manifest-ARN", "attributes": { "key": "value" } } ``` **Example — Ordnen Sie dem Fahrzeug eine Statusvorlage zu** Mithilfe des `stateTemplates` Felds können Sie dem Fahrzeug [Statusvorlagen](state-templates.md) zuordnen, um die Erfassung von Statusaktualisierungen des Fahrzeugs in der Cloud zu ermöglichen. In diesem Beispiel `stateTemplateUpdateStrategy` kann es sich um eines der folgenden handeln: + `periodic`: ermöglicht es Ihnen, eine feste Rate anzugeben, mit der die Edge Agent-Software Signalaktualisierungen an die Cloud sendet (die Edge-Agent-Software sendet Updates auch dann, wenn sich der Signalwert zwischen den Updates nicht geändert hat). + `onChange`: Die Edge Agent-Software sendet Signalaktualisierungen, wenn sich das Signal ändert. ``` aws iotfleetwise create-vehicle --cli-input-json file://create-vehicle.json ``` Wo die `create-vehicle.json` Datei enthält (zum Beispiel): ``` { "associationBehavior": "associationBehavior", "vehicleName": "vehicle-name", "modelManifestArn": "model-manifest-ARN", "decoderManifestArn": "decoder-manifest-ARN", "attributes": { "key": "value" }, "stateTemplates": [ { "identifier": "state-template-name", "stateTemplateUpdateStrategy": { "periodic": { "stateTemplateUpdateRate": { "unit": "SECOND", "value": 10 } } } } ] } ``` Wenn Sie die [Verschlüsselung mit einem vom Kunden verwalteten AWS KMS Schlüssel aktiviert](key-management.md) haben, fügen Sie die folgende Richtlinienerklärung bei, damit Ihre Rolle den `CreateVehicle` API-Vorgang aufrufen kann. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "kms:GenerateDataKey*", "kms:Decrypt" ], "Resource": [ "arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID" ] } ] } ``` ------ # Erstellen Sie mehrere AWS FleetWise IoT-Fahrzeuge Sie können den [BatchCreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchCreateVehicle.html)API-Vorgang verwenden, um mehrere Fahrzeuge gleichzeitig zu erstellen. Das folgende Beispiel verwendet die AWS CLI. Führen Sie den folgenden Befehl aus, um mehrere Fahrzeuge zu erstellen. *file-name*Ersetzen Sie ihn durch den Namen der JSON-Datei, die die Konfigurationen mehrerer Fahrzeuge enthält. ``` aws iotfleetwise batch-create-vehicle --cli-input-json file://file-name.json ``` **Example — Fahrzeugkonfigurationen** ``` { "vehicles": [ { "associationBehavior": "associationBehavior", "vehicleName": "vehicle-name", "modelManifestArn": "model-manifest-ARN", "decoderManifestArn": "decoder-manifest-ARN", "attributes": { "key": "value" } }, { "associationBehavior": "associationBehavior", "vehicleName": "vehicle-name", "modelManifestArn": "model-manifest-ARN", "decoderManifestArn": "decoder-manifest-ARN", "attributes": { "key": "value" } } ] } ``` Sie können bis zu 10 Fahrzeuge für jeden Batch-Vorgang erstellen. Weitere Informationen zur Fahrzeugkonfiguration finden Sie unter[Erstellen Sie ein AWS FleetWise IoT-Fahrzeug](create-vehicle.md). Wenn Sie die [Verschlüsselung mit einem vom Kunden verwalteten AWS KMS Schlüssel aktiviert](key-management.md) haben, fügen Sie die folgende Richtlinienerklärung bei, damit Ihre Rolle den `BatchCreateVehicle` API-Vorgang aufrufen kann. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "kms:GenerateDataKey*", "kms:Decrypt" ], "Resource": [ "arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID" ] } ] } ``` ------ # Ein AWS FleetWise IoT-Fahrzeug aktualisieren **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 [UpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateVehicle.html)API-Vorgang verwenden, um ein vorhandenes Fahrzeug zu aktualisieren. Das folgende Beispiel verwendet die AWS CLI. Führen Sie den folgenden Befehl aus, um ein Fahrzeug zu aktualisieren. *file-name*Ersetzen Sie ihn durch den Namen der JSON-Datei, die die Konfiguration Ihres Fahrzeugs enthält. ``` aws iotfleetwise update-vehicle --cli-input-json file://file-name.json ``` **Example — Fahrzeugkonfiguration** + *vehicle-name*Ersetzen Sie es durch die ID des Fahrzeugs, das Sie aktualisieren möchten. + (Optional) *model-manifest-ARN* Ersetzen Sie es durch den ARN des Fahrzeugmodells (Modellmanifest), das Sie verwenden, um das verwendete Fahrzeugmodell zu ersetzen. + (Optional) *decoder-manifest-ARN* Ersetzen Sie es durch den ARN Ihres Decoder-Manifests, das dem von Ihnen angegebenen neuen Fahrzeugmodell zugeordnet ist. + (Optional) Durch Fahrzeugattribute *attribute-update-mode* ersetzen. + `Merge`— Führen Sie neue Attribute mit vorhandenen Attributen zusammen, indem Sie bestehende Attribute mit neuen Werten aktualisieren und neue Attribute hinzufügen, falls sie nicht existieren. Wenn ein Fahrzeug beispielsweise die folgenden Attribute hat:`{"color": "black", "fuelType": "electric"}`, und Sie aktualisieren das Fahrzeug mit den folgenden Attributen:`{"color": "", "fuelType": "gasoline", "model": "x"}`, hat das aktualisierte Fahrzeug die folgenden Attribute:`{"fuelType": "gasoline", "model": "x"}`. + `Overwrite`— Ersetzt bestehende Attribute durch neue Attribute. Wenn ein Fahrzeug beispielsweise die folgenden Attribute hat:`{"color": "black", "fuelType": "electric"}`, und Sie das Fahrzeug mit dem `{"model": "x"}` Attribut aktualisieren, hat das aktualisierte Fahrzeug das `{"model": "x"}` Attribut. Dies ist erforderlich, wenn Attribute in der Eingabe vorhanden sind. + (Optional) Um neue Attribute hinzuzufügen oder bestehende mit neuen Werten zu aktualisieren, konfigurieren Sie`attributes`. Wenn Sie beispielsweise ein Elektroauto haben, können Sie den folgenden Wert für ein Attribut angeben:`{"fuelType": "electric"}`. Um Attribute zu löschen, konfigurieren Sie `attributeUpdateMode` auf`Merge`. **Wichtig** Attribute müssen im zugehörigen Fahrzeugmodell definiert werden, bevor Sie sie einzelnen Fahrzeugen hinzufügen können. ``` { "vehicleName": "vehicle-name", "modelManifestArn": "model-manifest-arn", "decoderManifestArn": "decoder-manifest-arn", "attributeUpdateMode": "attribute-update-mode" } } ``` **Example — dem Fahrzeug zugeordnete Statusvorlagen hinzufügen oder entfernen** Mithilfe der folgenden Felder können Sie zusätzliche Statusvorlagen zuordnen oder bestehende Zuordnungen aus dem Fahrzeug entfernen: + `stateTemplatesToAdd` + `stateTemplatesToRemove` ``` aws iotfleetwise update-vehicle --cli-input-json file://update-vehicle.json ``` Wo die `update-vehicle.json` Datei enthält (zum Beispiel): ``` { "vehicleName": "vehicle-name", "modelManifestArn": "model-manifest-arn", "decoderManifestArn": "decoder-manifest-arn", "attributeUpdateMode": "attribute-update-mode", "stateTemplatesToAdd": [ { "identifier": "state-template-name", "stateTemplateUpdateStrategy": { "onChange": {} } } ], "stateTemplatesToRemove": ["state-template-name"] } ``` Wenn Sie die [Verschlüsselung mit einem vom Kunden verwalteten AWS KMS Schlüssel aktiviert](key-management.md) haben, fügen Sie die folgende Richtlinienerklärung bei, damit Ihre Rolle den `UpdateVehicle` API-Vorgang aufrufen kann. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "kms:GenerateDataKey*", "kms:Decrypt" ], "Resource": [ "arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID" ] } ] } ``` ------ # Aktualisieren Sie mehrere AWS FleetWise IoT-Fahrzeuge Sie können den [BatchUpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchUpdateVehicle.html)API-Vorgang verwenden, um mehrere vorhandene Fahrzeuge gleichzeitig zu aktualisieren. Das folgende Beispiel verwendet die AWS CLI. Führen Sie den folgenden Befehl aus, um mehrere Fahrzeuge zu aktualisieren. *file-name*Ersetzen Sie ihn durch den Namen der JSON-Datei, die die Konfigurationen mehrerer Fahrzeuge enthält. ``` aws iotfleetwise batch-update-vehicle --cli-input-json file://file-name.json ``` **Example — Fahrzeugkonfigurationen** ``` { "vehicles": [ { "vehicleName": "vehicle-name", "modelManifestArn": "model-manifest-arn", "decoderManifestArn": "decoder-manifest-arn", "mergeAttributes": true, "attributes": { "key": "value" } }, { "vehicleName": "vehicle-name", "modelManifestArn": "model-manifest-arn", "decoderManifestArn": "decoder-manifest-arn", "mergeAttributes": true, "attributes": { "key": "value" } } ] } ``` Sie können bis zu 10 Fahrzeuge für jeden Batch-Vorgang aktualisieren. Weitere Informationen zur Konfiguration der einzelnen Fahrzeuge finden Sie unter[Ein AWS FleetWise IoT-Fahrzeug aktualisieren](update-vehicle-cli.md). Wenn Sie die [Verschlüsselung mit einem vom Kunden verwalteten AWS KMS Schlüssel aktiviert](key-management.md) haben, fügen Sie die folgende Richtlinienerklärung bei, damit Ihre Rolle den `BatchUpdateVehicle` API-Vorgang aufrufen kann. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "kms:GenerateDataKey*", "kms:Decrypt" ], "Resource": [ "arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID" ] } ] } ``` ------ # Löschen Sie ein AWS FleetWise IoT-Fahrzeug Sie können die AWS FleetWise IoT-Konsole oder API verwenden, um Fahrzeuge zu löschen. **Wichtig** Nachdem ein Fahrzeug gelöscht wurde, entfernt AWS IoT das Fahrzeug FleetWise automatisch aus den zugehörigen Flotten und Kampagnen. Weitere Informationen erhalten Sie unter [Flotten im AWS IoT verwalten FleetWise](fleets.md) und [Sammeln Sie AWS FleetWise IoT-Daten mit Kampagnen](campaigns.md). Das Fahrzeug existiert jedoch immer noch als Ding oder ist immer noch mit einem Ding in AWS IoT Core Verbindung gebracht. Anweisungen zum Löschen eines Objekts finden Sie unter [Löschen eines Objekts](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html#delete-thing) im *AWS IoT Core Entwicklerhandbuch*. ## Lösche ein Fahrzeug (Konsole) Sie können die AWS FleetWise IoT-Konsole verwenden, um ein Fahrzeug zu löschen. **Um ein Fahrzeug zu löschen** 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 auf der Seite **Fahrzeuge** die Schaltfläche neben dem Fahrzeug aus, das Sie löschen möchten. 1. Wählen Sie **Löschen** aus. 1. Geben **Sie **vehicle-name** unter Löschen** den Namen des Fahrzeugs ein und wählen Sie dann **Löschen**. ## Lösche ein Fahrzeug (AWS CLI) Sie können den [DeleteVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteVehicle.html)API-Vorgang verwenden, um ein Fahrzeug zu löschen. Das folgende Beispiel verwendet AWS CLI. Führen Sie den folgenden Befehl aus, um ein Fahrzeug zu löschen. *vehicle-name*Ersetzen Sie es durch die ID des Fahrzeugs, das Sie löschen möchten. ``` aws iotfleetwise delete-vehicle --vehicle-name vehicle-name ``` ### Überprüfen Sie das Löschen des Fahrzeugs Sie können den [ListVehicles](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehicles.html)API-Vorgang verwenden, um zu überprüfen, ob ein Fahrzeug gelöscht wurde. Das folgende Beispiel verwendet die AWS CLI. Führen Sie den folgenden Befehl aus, um eine paginierte Liste mit Zusammenfassungen aller Fahrzeuge abzurufen. ``` aws iotfleetwise list-vehicles ``` Wenn Sie die [Verschlüsselung mit einem vom Kunden verwalteten AWS KMS Schlüssel aktiviert](key-management.md) haben, fügen Sie die folgende Richtlinienerklärung bei, damit Ihre Rolle den `ListVehicles` API-Vorgang aufrufen kann. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "kms:Decrypt" ], "Resource": [ "arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID" ] } ] } ``` ------ # Holen Sie sich AWS FleetWise IoT-Fahrzeuginformationen **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 [GetVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetVehicle.html)API-Vorgang verwenden, um Fahrzeuginformationen abzurufen. Das folgende Beispiel verwendet die AWS CLI. Führen Sie den folgenden Befehl aus, um die Metadaten eines Fahrzeugs abzurufen. *vehicle-name*Ersetzen Sie es durch die ID des Fahrzeugs, das Sie abrufen möchten. ``` aws iotfleetwise get-vehicle --vehicle-name vehicle-name ``` **Anmerkung** Diese Operation ist [letztlich konsistent](https://web.stanford.edu/class/cs345d-01/rl/eventually-consistent.pdf). Mit anderen Worten, Änderungen am Fahrzeug werden möglicherweise nicht sofort übernommen. Sie können den [GetVehicleStatus](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetVehicleStatus.html)API-Vorgang verwenden, um den Status von Ressourcen abzurufen, die einem Fahrzeug zugeordnet sind. Das folgende Beispiel verwendet die AWS CLI. Führen Sie den folgenden Befehl aus, um den Status von Ressourcen abzurufen, die einem Fahrzeug zugeordnet sind. + *vehicle-name*Ersetzen Sie ihn durch die ID des Fahrzeugs, dem die Ressourcen zugeordnet sind. + *type*Ersetzen Sie durch den Typ der Ressource, deren Status Sie abrufen möchten. Gültige Werte für `type` sind `CAMPAIGN`, `STATE_TEMPLATE` und `DECODER`. ``` aws iotfleetwise get-vehicle-status --vehicle-name vehicle-name --type type ``` Wenn Sie die [Verschlüsselung mit einem vom Kunden verwalteten AWS KMS Schlüssel aktiviert](key-management.md) haben, fügen Sie die folgende Richtlinienerklärung bei, damit Ihre Rolle die `GetVehicle` `GetVehicleStatus` API-Operationen aufrufen kann. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "kms:Decrypt" ], "Resource": [ "arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID" ] } ] } ``` ------