

AWS IoT FleetWise는 더 이상 신규 고객에게 공개되지 않습니다. 기존 AWS IoT FleetWise 고객은 서비스를 계속 사용할 수 있습니다. [의 Connected Mobility 지침은 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>}} 
   ```