AWS A IoT não FleetWise estará mais aberta a novos clientes a partir de 30 de abril de 2026. Os FleetWise clientes de AWS IoT existentes podem continuar usando o serviço. O [Guia para Mobilidade Conectada AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/) fornece orientação sobre como desenvolver e implantar serviços modulares para soluções de mobilidade conectada que podem ser usadas para obter recursos equivalentes aos da AWS IoT FleetWise.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Obtenha um instantâneo do estado do veículo usando modelos de estado
<a name="on-demand-operations"></a>

**Importante**  
O acesso a determinados FleetWise recursos de AWS IoT está atualmente bloqueado. Para obter mais informações, consulte [AWS Disponibilidade de regiões e recursos na AWS IoT FleetWise](fleetwise-regions.md).

Você pode obter o último estado conhecido de um veículo usando a operação da API do plano de [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 controle ou o console de AWS FleetWise IoT.

**Importante**  
Uma exceção de validação pode ocorrer em qualquer um dos seguintes cenários:  
É fornecido um modelo de estado que não `ASSOCIATED` está em um veículo.
É feita uma solicitação para ativar um modelo de estado, mas ele não está `DEPLOYED` em um veículo.
Uma solicitação é feita para um modelo de estado, mas está `DELETED` em um veículo.

## Obter um instantâneo do estado do veículo (console)
<a name="fetch-state-console"></a>

Você pode usar o FleetWise console de AWS IoT para buscar o último estado conhecido de um veículo. AWS A IoT FleetWise criará um comando para você buscar dados.

**Para obter o estado de um veículo**

1. Abra o console [AWS de IoT. FleetWise ](https://console.aws.amazon.com/iotfleetwise)

1. No painel de navegação, selecione **Veículos**.

1. Escolha um veículo na lista para abrir sua página de detalhes.

1. Na guia **Modelos de estado**, escolha **Buscar dados**.

1. Selecione a função do IAM que concede FleetWise permissões de AWS IoT para enviar um comando e buscar dados. Consulte [Controle de acesso](https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/controlling-access.html#generate-command-payload).

1. Escolha **Buscar estado**.

## Obtenha um instantâneo do estado do veículo ()AWS CLI
<a name="fetch-state-cli"></a>

Para obter um instantâneo do estado, primeiro crie um recurso de comando. Em seguida, você pode enviar o seguinte comando para o veículo para o qual deseja obter o instantâneo do estado. Para obter mais informações sobre como usar a `CreateCommand` API e seus parâmetros, consulte[Usar a API `CreateCommand`](start-stop-data-ingestion.md#start-stop-ingestion-create-command).

1. 

**Criar um recurso de comando**

   O exemplo a seguir mostra como criar o recurso de comando para realizar a operação de busca. Você pode especificar valores alternativos para os parâmetros obrigatórios ao enviar o comando para o veículo. Para obter mais informações, consulte [Criar um recurso de comando](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"}
         }
       ]'
   ```

   Resposta:

   ```
   { 
       "commandId": "{{<COMMAND_ID>}}",
       "commandArn": "arn:aws:iot:{{<REGION>}}:{{111122223333}}:command/{{<COMMAND_ID>}}"
   }
   ```

1. 

**Inicie a execução do comando para obter um instantâneo do estado**

   Depois que o comando for criado, envie o comando para o veículo. Se você não especificou valores para os parâmetros obrigatórios ao criar o recurso de comando, você deve especificá-los agora. Para obter mais informações, consulte [Enviar um comando (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>}}
   ```

   Resposta:

   ```
   {
       "executionId": "{{<UNIQUE_UUID>}}"
   }
   ```

1. Recupere o status da operação do modelo de estado

   Depois de iniciar a execução do comando, você pode usar a `GetCommandExecution` API para recuperar o modelo de estado.

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