AWS IoT FleetWise 車両を作成する

重要

現在、特定の AWS IoT FleetWise 機能へのアクセスはゲートされています。詳細については、「AWSAWS IoT FleetWise でのリージョンと機能の可用性」を参照してください。

AWS IoT FleetWise コンソールまたは API を使用して車両を作成できます。

重要

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

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

車両の作成 (コンソール)

AWS IoT FleetWise コンソールを使用して車両を作成できます。

車両を作成するには

AWS IoT FleetWise コンソールを開きます。
ナビゲーションペインで、[車両] を選択します。
車両の概要ページで、[車両を作成] を選択し、以下の手順を実行します。

トピック

ステップ 1: 車両のプロパティを定義する
ステップ 2: 車両証明書を構成する
ステップ 3: 証明書にポリシーをアタッチする
ステップ 4: 確認して作成する

ステップ 1: 車両のプロパティを定義する

このステップでは、車両に名前を付け、モデルマニフェストとデコーダーマニフェストに関連付けます。

車両の一意の名前を入力します。

重要
車両は AWS IoT モノに対応します。同じ名前のモノが既に存在する場合は、[車両を IoT モノに関連付ける] を選択すると、その車両でモノが更新されます。または、別の車両名を選択すると、 AWS IoT FleetWise は自動的に車両用の新しいモノを作成します。
リストから車両モデル (モデルマニフェスト) を選択します。
リストからデコーダーマニフェストを選択します。デコーダーマニフェストが車両モデルに関連付けられます。
(オプション) 車両の属性を関連付けるには、[属性を追加] を選択します。このステップを省略した場合、車両をキャンペーンにデプロイできるようにするには、車両の作成後に属性を追加する必要があります。
(オプション) 車両にタグを関連付けるには、[新しいタグを追加] を選択します。車両の作成後にタグを追加することもできます。
[次へ] を選択します。

ステップ 2: 車両証明書を構成する

車両を AWS IoT モノとして使用するには、ポリシーがアタッチされた車両証明書を設定する必要があります。このステップを省略した場合、車両をキャンペーンにデプロイできるようにするには、車両の作成後に証明書を構成する必要があります。

[新しい証明書の自動生成 (推奨)] を選択します。
[Next (次へ)] を選択します。

ステップ 3: 証明書にポリシーをアタッチする

前のステップで構成した証明書にポリシーをアタッチします。

[ポリシー] に、既存のポリシー名を入力します。新しいポリシーを作成するには、[ポリシーを作成] を選択します。
[Next (次へ)] を選択します。

ステップ 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 が 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"
    }
}

例 – 状態テンプレートを車両に関連付ける

状態テンプレートを車両に関連付けると、 stateTemplatesフィールドを使用して、クラウド内の車両から状態更新を収集できます。

この例では、は次のいずれかstateTemplateUpdateStrategyになります。

periodic: では、エッジエージェントソフトウェアがシグナルの更新をクラウドに送信する固定レートを指定できます (エッジエージェントソフトウェアは、シグナル値が更新間で変更されていない場合でも更新を送信します）。
onChange: エッジエージェントソフトウェアは、シグナルが変更されるたびにシグナルの更新を送信します。


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 オペレーションを呼び出せるように、次のポリシーステートメントを含めます。


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

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

予約済みトピック

複数の車両を作成する