状態テンプレートを使用して車両状態スナップショットを取得する - AWS IoT FleetWise

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

状態テンプレートを使用して車両状態スナップショットを取得する

重要

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

CreateCommand AWS IoT Core コントロールプレーン API オペレーションまたは AWS IoT FleetWise コンソールを使用して、車両の最後の既知の状態を取得できます。

重要

検証例外は、次のいずれかのシナリオで発生する可能性があります。

  • 車両ASSOCIATEDに付属していない状態テンプレートが提供されます。

  • 状態テンプレートをアクティブ化するリクエストは行われますが、車両DEPLOYEDにはありません。

  • 状態テンプレートに対するリクエストは行われますが、車両DELETED上にあります。

AWS IoT FleetWise コンソールを使用して、車両の最後の既知の状態を取得できます。 AWS IoT FleetWise は、データを取得するためのコマンドを作成します。

車両の状態を取得するには

  1. AWS IoT FleetWise コンソールを開きます。

  2. ナビゲーションペインで、[車両] を選択します。

  3. リストから車両を選択して、詳細ページを開きます。

  4. 状態テンプレートタブで、データの取得を選択します。

  5. コマンドを送信してデータを取得するアクセス許可を AWS IoT FleetWise に付与する IAM ロールを選択します。「アクセスの制御」を参照してください。

  6. 取得状態を選択します。

状態スナップショットを取得するには、まずコマンドリソースを作成します。その後、状態スナップショットを取得する車両に次のコマンドを送信できます。CreateCommand API とそのパラメータの使用の詳細については、「」を参照してくださいCreateCommand API を使用する場合。

  1. コマンドリソースを作成する

    次の例は、フェッチオペレーションを実行するコマンドリソースを作成する方法を示しています。コマンドを車両に送信するときに、必須パラメータの代替値を指定できます。詳細については、「コマンドリソースを作成する」を参照してください。

    aws iot create-command \
    --command-id <COMMAND_ID> \
    --display-name "FetchSnapshot State Template" \
    --namespace AWS-IoTFleetWise \
    --mandatory-parameters '[
      {
          "name": "$stateTemplate.name",
          "defaultValue": {"S": "ST123"}
      }, 
      {
          "name": "$stateTemplate.operation",
          "defaultValue": {"S": "fetchSnapshot"}
      }
    ]'

    レスポンス:

    { 
    "commandId": "<COMMAND_ID>",
    "commandArn": "arn:aws:iot:<REGION>:<ACCOUNT_ID>:command/<COMMAND_ID>"
}
  2. コマンド実行を開始して状態スナップショットを取得する

    コマンドを作成したら、コマンドを車両に送信します。コマンドリソースの作成時に必須パラメータの値を指定しなかった場合は、今すぐ指定する必要があります。詳細については、「コマンドを送信する (AWS CLI）」を参照してください。

    aws iot-jobs-data start-command-execution \
    --command-arn arn:aws:iot:<REGION>:<ACCOUNT_ID>:command/<COMMAND_ID> \
    --target-arn arn:aws:iot:<REGION>:<ACCOUNT_ID>:thing/<VEHICLE_NAME>

    レスポンス:

    {
    "executionId": "<UNIQUE_UUID>"
}

  3. 状態テンプレートオペレーションのステータスを取得する

    コマンドの実行を開始したら、 GetCommandExecution API を使用して状態テンプレートを取得できます。

    aws iot get-command-execution --execution-id <EXECUTION_ID>