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

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

# 使用狀態範本擷取車輛狀態快照
<a name="on-demand-operations"></a>

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

您可以使用[https://docs.aws.amazon.com/iot/latest/apireference/API_CreateCommand.html](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateCommand.html) AWS IoT Core 控制平面 API 操作或 AWS IoT FleetWise 主控台擷取車輛的上次已知狀態。

**重要**  
驗證例外狀況可能發生在下列任一情況下：  
提供的狀態範本並非`ASSOCIATED`搭配 車輛使用。
提出啟用狀態範本的請求，但尚未`DEPLOYED`在車輛上。
系統會向狀態範本提出請求，但正在`DELETED`車輛上。

## 擷取車輛狀態快照 （主控台）
<a name="fetch-state-console"></a>

您可以使用 AWS IoT FleetWise 主控台來擷取車輛的上次已知狀態。 AWS IoT FleetWise 會為您建立命令來擷取資料。

**擷取車輛狀態**

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

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

1. 從清單中選擇車輛以開啟其詳細資訊頁面。

1. 在**狀態範本**索引標籤上，選擇**擷取資料**。

1. 選取授予 AWS IoT FleetWise 許可的 IAM 角色，以傳送命令並擷取資料。請參閱[控制存取](https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/controlling-access.html#generate-command-payload)。

1. 選擇**擷取狀態**。

## 擷取車輛狀態快照 (AWS CLI)
<a name="fetch-state-cli"></a>

若要擷取狀態快照，請先建立命令資源。然後，您可以將下列命令傳送至您要為其擷取狀態快照的車輛。如需使用 `CreateCommand` API 及其參數的詳細資訊，請參閱 [使用 `CreateCommand` API](start-stop-data-ingestion.md#start-stop-ingestion-create-command)。

1. 

**建立命令資源**

   下列範例示範如何建立命令資源來執行擷取操作。當您將命令傳送至車輛時，您可以指定強制參數的替代值。如需詳細資訊，請參閱[建立命令資源](create-manage-remote-command-cli.md#create-remote-command-cli)。

   ```
   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>}}"
   }
   ```

1. 

**開始命令執行以擷取狀態快照**

   建立命令後，將命令傳送至車輛。如果您在建立命令資源時未指定必要參數的值，您現在必須指定這些參數。如需詳細資訊，請參閱[傳送命令 (AWS CLI)](send-monitor-remote-command-cli.md#send-remote-command-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>}}"
   }
   ```

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

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

   ```
   aws iot get-command-execution --execution-id {{<EXECUTION_ID>}} 
   ```