Ein AWS FleetWise IoT-Fahrzeug aktualisieren - 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.

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.

Sie können den UpdateVehicleAPIVorgang 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.

Ersetzen file-name mit dem Namen der JSON-Datei, die die Konfiguration Ihres Fahrzeugs enthält.

aws iotfleetwise update-vehicle --cli-input-json file://file-name.json
Beispiel — Fahrzeugkonfiguration

  • Ersetzen vehicle-name mit der ID des Fahrzeugs, das Sie aktualisieren möchten.

  • (Optional) Ersetzen model-manifest-ARN durch das ARN Fahrzeugmodell (Modellmanifest), das Sie verwenden, um das verwendete Fahrzeugmodell zu ersetzen.

  • (Optional) Ersetzen decoder-manifest-ARN mit dem Decoder-Manifest, das dem ARN von Ihnen angegebenen neuen Fahrzeugmodell zugeordnet ist.

  • (Optional) Ersetzen attribute-update-mode mit Fahrzeugattributen.

    • 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 Sieattributes. 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 aufMerge.

    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"
         }         
}
Beispiel — 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 haben, fügen Sie die folgende Richtlinienerklärung bei, damit Ihre Rolle den UpdateVehicle API Vorgang aufrufen kann. 

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "kms:GenerateDataKey*",
        "kms:Decrypt"
      ],
      "Resource": [
        "arn:aws:kms:KMS_KEY_REGION:KMS_KEY_ACCOUNT_ID:key/KMS_KEY_ID"
      ]
    },
  ]
}