使用狀態範本擷取車輛狀態快照 - 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>:111122223333:command/<COMMAND_ID>"
}
  2. 開始命令執行以擷取狀態快照

    建立命令之後，請將命令傳送至車輛。如果您在建立命令資源時未指定必要參數的值，您現在必須指定這些參數。如需詳細資訊，請參閱傳送命令 (AWS CLI)。

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

    回應：

    {
    "executionId": "<UNIQUE_UUID>"
}

  3. 擷取狀態範本操作的狀態

    啟動命令執行後，您可以使用 GetCommandExecution API 來擷取狀態範本。

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