更新 AWS IoT FleetWise 車輛 - AWS IoT FleetWise

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

更新 AWS IoT FleetWise 車輛

重要

存取特定 AWS IoT FleetWise 功能目前已封鎖。如需詳細資訊，請參閱AWSAWS IoT FleetWise 中的區域和功能可用性。

您可以使用 UpdateVehicle API 操作來更新現有車輛。下列為使用 AWS CLI的範例。

若要更新車輛，請執行下列命令。

將 file-name 取代為 .json 檔案的名稱，其中包含您車輛的組態。

aws iotfleetwise update-vehicle --cli-input-json file://file-name.json
範例 – 車輛組態

  • 將 vehicle-name 取代為您要更新的車輛 ID。

  • （選用） 將 model-manifest-ARN 取代為您用來取代使用中車輛模型 （模型資訊清單） 的 ARN。

  • （選用） 將 decoder-manifest-ARN 取代為您指定的新車輛模型相關聯的解碼器資訊清單 ARN。

  • （選用） 以車輛屬性取代 attribute-update-mode。

    • Merge – 使用新值更新現有屬性，並在屬性不存在時新增新屬性，以將新屬性合併到現有屬性中。

      例如，如果車輛具有下列屬性：{"color": "black", "fuelType": "electric"}，而您更新了具有下列屬性的車輛：{"color": "", "fuelType": "gasoline", "model": "x"}，則更新的車輛具有下列屬性：{"fuelType": "gasoline", "model": "x"}。

    • Overwrite – 將現有的屬性取代為新的屬性。

      例如，如果車輛具有下列屬性：{"color": "black", "fuelType": "electric"}，而您使用 {"model": "x"} 屬性更新車輛，則更新的 車輛具有 {"model": "x"} 屬性。

    如果輸入中存在屬性，則此為必要項目。

  • （選用） 若要新增屬性或使用新值更新現有屬性，請設定 attributes。例如，如果您有電動車，您可以為 屬性指定下列值：{"fuelType": "electric"}。

    若要刪除屬性，請將 attributeUpdateMode設定為 Merge。

    重要

    屬性必須在相關聯的車輛模型中定義，才能將其新增至個別車輛。

 { 
         "vehicleName": "vehicle-name",
         "modelManifestArn": "model-manifest-arn",
         "decoderManifestArn": "decoder-manifest-arn",
         "attributeUpdateMode": "attribute-update-mode"
         }         
}
範例 – 新增或移除與車輛相關聯的狀態範本

您可以使用下列欄位來建立其他狀態範本的關聯，或從車輛中移除現有的關聯：

  • stateTemplatesToAdd

  • stateTemplatesToRemove 

aws iotfleetwise update-vehicle --cli-input-json file://update-vehicle.json

update-vehicle.json 檔案包含的位置 （例如）：

{
    "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"]            
}

如果您使用客戶受管 AWS KMS 金鑰啟用加密，請包含下列政策陳述式，讓您的角色可以叫用 UpdateVehicle API 操作。

{
  "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"
      ]
    },
  ]
}