Obtenha um instantâneo do estado do veículo usando modelos de estado - 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

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.

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

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

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

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

  4. Na guia Modelos de estado, escolha Buscar dados.

  5. 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.

  6. Escolha Buscar estado.

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, consulteUso da API CreateCommand.

  1. Crie 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 Crie um recurso de comando.

    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>"
}
  2. 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).

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

  3. 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>