Recupera un'istantanea dello stato del veicolo utilizzando i modelli di stato - AWS IoT FleetWise

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Recupera un'istantanea dello stato del veicolo utilizzando i modelli di stato

Importante

L'accesso a determinate FleetWise funzionalità AWS IoT è attualmente limitato. Per ulteriori informazioni, consulta AWS Disponibilità di aree e funzionalità nell' AWS IoT FleetWise.

Puoi recuperare l'ultimo stato noto di un veicolo utilizzando l'operazione dell'API del piano di CreateCommand AWS IoT Core controllo o la FleetWise console AWS IoT.

Importante

Un'eccezione di convalida può verificarsi in uno dei seguenti scenari:

  • Viene fornito un modello di stato che non è ASSOCIATED abbinato a un veicolo.

  • Viene effettuata una richiesta per attivare un modello di stato, ma questo non è stato DEPLOYED installato su un veicolo.

  • Viene inviata una richiesta a un modello di stato ma si trova DELETED su un veicolo.

Puoi utilizzare la FleetWise console AWS IoT per recuperare l'ultimo stato noto di un veicolo. AWS IoT FleetWise creerà un comando per recuperare i dati.

Per recuperare lo stato di un veicolo

  1. Apri la FleetWise console AWS IoT.

  2. Nel pannello di navigazione, scegli Veicoli.

  3. Scegli un veicolo dall'elenco per aprirne la pagina dei dettagli.

  4. Nella scheda Modelli di stato, scegli Recupera dati.

  5. Seleziona il ruolo IAM che concede FleetWise le autorizzazioni AWS IoT per inviare un comando e recuperare dati. Vedi Controllo dell'accesso.

  6. Scegli Fetch state.

Per recuperare un'istantanea dello stato, crea prima una risorsa di comando. È quindi possibile inviare il seguente comando al veicolo per il quale si desidera recuperare l'istantanea dello stato. Per ulteriori informazioni sull'utilizzo dell'CreateCommandAPI e dei relativi parametri, consulta. Utilizzo dell'API CreateCommand

  1. Creare una risorsa di comando

    L'esempio seguente mostra come creare la risorsa di comando per eseguire l'operazione di recupero. È possibile specificare valori alternativi per i parametri obbligatori quando si invia il comando al veicolo. Per ulteriori informazioni, consulta Crea una risorsa di 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"}
      }
    ]'

    Risposta:

    { 
    "commandId": "<COMMAND_ID>",
    "commandArn": "arn:aws:iot:<REGION>:<ACCOUNT_ID>:command/<COMMAND_ID>"
}
  2. Avvia l'esecuzione del comando per recuperare l'istantanea dello stato

    Dopo aver creato il comando, invia il comando al veicolo. Se non hai specificato i valori per i parametri obbligatori quando hai creato la risorsa di comando, devi specificarli ora. Per ulteriori informazioni, consulta Invia un comando ()AWS CLI.

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

    Risposta:

    {
    "executionId": "<UNIQUE_UUID>"
}

  3. Recuperate lo stato dell'operazione del modello di stato

    Dopo aver avviato l'esecuzione del comando, puoi utilizzare l'GetCommandExecutionAPI per recuperare il modello di stato.

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