車両の作成 (AWS CLI)

車両を作成するときは、デコーダーマニフェストに関連付けられた車両モデルを使用する必要があります。CreateVehicle API オペレーションを使用して車両を作成できます。次の例では AWS CLIを使用しています。

重要

開始する前に、次の点を確認してください。

• 車両モデルが用意されていて、その車両モデルのステータスが ACTIVE になっている必要があります。詳細については、「車両モデルの作成と管理」を参照してください。

• 車両モデルがデコーダーマニフェストに関連付けられていて、そのデコーダーマニフェストのステータスが ACTIVE になっている必要があります。詳細については、「デコーダーマニフェストの作成と管理」を参照してください。

車両を作成するには、次のコマンドを実行します。

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 モノがプロビジョニングされていることを確認します。詳細については、「車両のプロビジョニング」を参照してください。

• vehicle-name は、次のいずれかに置き換えます。

  • associationBehavior が に設定されている場合の AWS IoT モノの名前ValidateIotThingExists。

  • associationBehavior が CreateIotThing に設定されている場合は、作成する車両の ID。

    車両 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"
    }
}