AWS IoT FleetWise 自 2026 年 4 月 30 日起將不再向新客戶開放。現有的 AWS IoT FleetWise 客戶可以繼續使用 服務。[上的連線行動性指南 AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/)提供如何為連線行動解決方案開發和部署模組化服務的指引，這些解決方案可用於實現與 AWS IoT FleetWise 同等的功能。

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

# 建立 AWS IoT FleetWise 車輛
<a name="create-vehicle"></a>

**重要**  
對特定 AWS IoT FleetWise 功能的存取目前受到鎖定。如需詳細資訊，請參閱[AWS AWS IoT FleetWise 中的區域和功能可用性](fleetwise-regions.md)。

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

**重要**  
開始之前，請檢查下列項目：  
您必須擁有 車輛模型，且車輛模型的狀態必須為 `ACTIVE`。如需詳細資訊，請參閱[Manage AWS IoT FleetWise 車輛模型車輛模型](vehicle-models.md)。
您的 車輛模型必須與解碼器資訊清單相關聯，解碼器資訊清單的狀態必須為 `ACTIVE`。如需詳細資訊，請參閱[Manage AWS IoT FleetWise 解碼器資訊清單](decoder-manifests.md)。

**Topics**
+ [建立 車輛 （主控台）](#create-vehicle-console)
+ [建立 車輛 (AWS CLI)](#create-vehicle-cli)

## 建立 車輛 （主控台）
<a name="create-vehicle-console"></a>

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

**建立車輛**

1. 開啟 [AWS IoT FleetWise 主控台](https://console.aws.amazon.com/iotfleetwise)。

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

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

**Topics**
+ [步驟 1：定義車輛屬性](#define-vehicle-properties-console)
+ [步驟 2：設定車輛憑證](#define-vehicle-certificate-console)
+ [步驟 3：將政策連接至憑證](#attach-vehicle-policy-console)
+ [步驟 4：檢閱和建立](#review-and-create-vehicle-console)

### 步驟 1：定義車輛屬性
<a name="define-vehicle-properties-console"></a>

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

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

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

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

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

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

1. 選擇**下一步**。

### 步驟 2：設定車輛憑證
<a name="define-vehicle-certificate-console"></a>

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

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

1. 選擇**下一步**。

### 步驟 3：將政策連接至憑證
<a name="attach-vehicle-policy-console"></a>

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

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

1. 選擇**下一步**。

### 步驟 4：檢閱和建立
<a name="review-and-create-vehicle-console"></a>

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

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

## 建立 車輛 (AWS CLI)
<a name="create-vehicle-cli"></a>

建立車輛時，您必須使用與解碼器資訊清單相關聯的車輛模型。您可以使用 [CreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateVehicle.html) API 操作來建立車輛。下列為使用 AWS CLI的範例。

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

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

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

**Example – 車輛組態**  
+ （選用） `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 車輛](provision-vehicles.md)。
+ 以下列其中一項取代 *vehicle-name*。
  + 如果 `associationBehavior`設定為 ，您的 AWS IoT 物件名稱`ValidateIotThingExists`。
  + 如果 `associationBehavior` 設定為 ，則要建立的車輛 ID`CreateIotThing`。

    車輛 ID 可以有 1-100 個字元。有效字元：a–z、A–Z、0–9、破折號 (‐)、底線 (\$1) 和冒號 (：)。
+ 將 *model-manifest-ARN* 取代為您車輛模型的 ARN （模型資訊清單）。
+ 將 *decoder-manifest-ARN* 取代為與指定車輛模型相關聯之解碼器資訊清單的 ARN。
+ （選用） 您可以新增其他屬性，以區分此車輛與從相同車輛模型建立的其他車輛。例如，如果您有電動汽車，您可以為 屬性指定下列值：`{"fuelType": "electric"}`。
**重要**  <a name="update-attributes-requirement"></a>
屬性必須在相關聯的車輛模型中定義，才能將其新增至個別車輛。

```
{
    "associationBehavior": "associationBehavior",
    "vehicleName": "vehicle-name", 
    "modelManifestArn": "model-manifest-ARN",
    "decoderManifestArn": "decoder-manifest-ARN",           
    "attributes": {
        "key": "value"
    }
}
```

**Example – 將狀態範本與車輛建立關聯**  
您可以使用 `stateTemplates` 欄位，將[狀態範本](state-templates.md)與車輛建立關聯，以允許從雲端中的車輛收集狀態更新。  
在此範例中， `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 金鑰[啟用加密](key-management.md)，請包含下列政策陳述式，讓您的角色可以叫用 `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"
            ]
        }
    ]
}
```

------