View a markdown version of this page

建立 AWS IoT FleetWise 車輛 - AWS IoT FleetWise
建立 車輛 （主控台）建立 車輛 (AWS CLI)

AWS IoT FleetWise 自 2026 年 4 月 30 日起將不再向新客戶開放。現有的 AWS IoT FleetWise 客戶可以繼續使用 服務。上的連線行動性指南 AWS提供如何為連線行動解決方案開發和部署模組化服務的指引，這些解決方案可用於實現與 AWS IoT FleetWise 同等的功能。

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

建立 AWS IoT FleetWise 車輛

重要

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

您可以使用 AWS IoT FleetWise 主控台或 API 來建立車輛。

重要

開始之前，請檢查下列項目：

建立 車輛 （主控台）

您可以使用 AWS IoT FleetWise 主控台來建立車輛。

建立車輛

  1. 開啟 AWS IoT FleetWise 主控台。

  2. 在導覽窗格中，選擇 車輛。

  3. 在車輛摘要頁面上，選擇建立車輛，然後執行下列步驟。

步驟 1：定義車輛屬性

在此步驟中，您會命名車輛，並將其與模型資訊清單和解碼器資訊清單建立關聯。

  1. 輸入車輛的唯一名稱。

    重要

    車輛對應至 AWS IoT 物件。如果已存在使用該名稱的物件，請選擇將車輛與 IoT 物件建立關聯，以更新該物件與車輛。或者，選擇不同的車輛名稱， AWS IoT FleetWise 會自動為車輛建立新的物件。

  2. 從清單中選擇車輛模型 （模型資訊清單）。

  3. 從清單中選擇解碼器資訊清單。解碼器資訊清單與車輛模型相關聯。

  4. （選用） 若要關聯車輛屬性，請選擇新增屬性。如果您略過此步驟，您必須在建立車輛之後新增屬性，才能將其部署到行銷活動。

  5. （選用） 若要將標籤與車輛建立關聯，請選擇新增標籤。您也可以在建立車輛後新增標籤。

  6. 選擇下一步。

步驟 2：設定車輛憑證

若要使用 車輛做為 AWS IoT 物件，您必須設定具有連接政策的車輛憑證。如果您略過此步驟，您必須在建立車輛之後設定憑證，才能將其部署到行銷活動。

  1. 選擇自動產生新憑證 （建議）。

  2. 選擇下一步。

步驟 3：將政策連接至憑證

將政策連接至您在上一個步驟中設定的憑證。

  1. 在政策中，輸入現有的政策名稱。若要建立新的政策，請選擇建立政策。

  2. 選擇下一步。

步驟 4：檢閱和建立

驗證車輛的組態，然後選擇建立車輛。

重要

建立車輛後，您必須下載憑證和金鑰。您將使用憑證和私有金鑰，在 Edge Agent for AWS IoT FleetWise 軟體中連接車輛。

建立 車輛 (AWS CLI)

建立車輛時，您必須使用與解碼器資訊清單相關聯的車輛模型。您可以使用 CreateVehicle API 操作來建立車輛。下列為使用 AWS CLI的範例。

若要建立車輛，請執行下列命令。

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

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

  • （選用） associationBehavior值可以是下列其中一項：

    • CreateIotThing – 建立車輛時， AWS IoT FleetWise 會自動為車輛建立具有車輛 ID 名稱的 AWS IoT 物件。

    • ValidateIotThingExists – 使用現有 AWS IoT 物件來建立車輛。

      若要建立 AWS IoT 物件，請執行下列命令。將 thing-name 取代為您要建立的物件名稱。

      aws iot create-thing --thing-name thing-name

    如果未指定， AWS IoT FleetWise 會自動為您的車輛建立 AWS IoT 物件。

    重要

    請確定在建立車輛後佈建 AWS IoT 物件。如需詳細資訊，請參閱Provision AWS IoT FleetWise 車輛。

  • 以下列其中一項取代 vehicle-name。

    • 如果 associationBehavior設定為 ，您的 AWS IoT 物件名稱ValidateIotThingExists。

    • 如果 associationBehavior 設定為 ，則要建立的車輛 IDCreateIotThing。

      車輛 ID 可以有 1-100 個字元。有效字元：a–z、A–Z、0–9、破折號 (‐)、底線 (_) 和冒號 (：)。

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

  • 將 decoder-manifest-ARN 取代為與指定車輛模型相關聯之解碼器資訊清單的 ARN。

  • （選用） 您可以新增其他屬性，以區分此車輛與從相同車輛模型建立的其他車輛。例如，如果您有電動汽車，您可以為 屬性指定下列值：{"fuelType": "electric"}。

    重要

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

{
    "associationBehavior": "associationBehavior",
    "vehicleName": "vehicle-name", 
    "modelManifestArn": "model-manifest-ARN",
    "decoderManifestArn": "decoder-manifest-ARN",           
    "attributes": {
        "key": "value"
    }
}
範例– 將狀態範本與車輛建立關聯

您可以使用 stateTemplates 欄位，將狀態範本與車輛建立關聯，以允許從雲端中的車輛收集狀態更新。

在此範例中， stateTemplateUpdateStrategy 可以是下列其中一項：

  • periodic：可讓您指定 Edge Agent 軟體將訊號更新傳送到雲端的固定速率 （即使訊號值未在更新之間變更，Edge Agent 軟體也會傳送更新）。

  • onChange：Edge Agent 軟體會在訊號變更時傳送訊號更新。

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

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

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

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

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