Obtenga una instantánea del estado del vehículo mediante plantillas de estado - AWS IoT FleetWise

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Obtenga una instantánea del estado del vehículo mediante plantillas de estado

importante

El acceso a ciertas FleetWise funciones de AWS IoT está actualmente restringido. Para obtener más información, consulte AWS Disponibilidad regional y de funciones en el AWS IoT FleetWise.

Puede obtener el último estado conocido de un vehículo mediante la operación de la API del plano de CreateCommand AWS IoT Core control o la FleetWise consola AWS IoT.

importante

Se puede producir una excepción de validación en cualquiera de los siguientes escenarios:

  • Se proporciona una plantilla de estado que no corresponde ASSOCIATED a un vehículo.

  • Se ha realizado una solicitud para activar una plantilla de estado, pero no ha estado DEPLOYED en un vehículo.

  • Se hace una solicitud a una plantilla de estado, pero se hace DELETED en un vehículo.

Puedes usar la FleetWise consola AWS IoT para buscar el último estado conocido de un vehículo. AWS IoT FleetWise creará un comando para que obtengas datos.

Para obtener el estado de un vehículo

  1. Abre la FleetWise consola AWS de IoT.

  2. En el panel de navegación, elija Vehículos.

  3. Elige un vehículo de la lista para abrir su página de detalles.

  4. En la pestaña Plantillas de estado, selecciona Obtener datos.

  5. Seleccione el rol de IAM que otorga FleetWise permisos de AWS IoT para enviar un comando y obtener datos. Consulte Controlar el acceso.

  6. Seleccione Fetch state.

Para obtener una instantánea de estado, primero cree un recurso de comando. A continuación, puede enviar el siguiente comando al vehículo del que quiere obtener la instantánea de estado. Para obtener más información sobre el uso de la CreateCommand API y sus parámetros, consulteMediante la API de CreateCommand.

  1. Cree un recurso de comandos

    El siguiente ejemplo muestra cómo crear el recurso de comandos para realizar la operación de recuperación. Puede especificar valores alternativos para los parámetros obligatorios al enviar el comando al vehículo. Para obtener más información, consulte Cree un recurso de comandos.

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

    Respuesta:

    { 
    "commandId": "<COMMAND_ID>",
    "commandArn": "arn:aws:iot:<REGION>:<ACCOUNT_ID>:command/<COMMAND_ID>"
}
  2. Inicie la ejecución del comando para obtener una instantánea del estado

    Una vez creado el comando, envíelo al vehículo. Si no especificó valores para los parámetros obligatorios al crear el recurso de comando, debe especificarlos ahora. Para obtener más información, consulte Envía 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>

    Respuesta:

    {
    "executionId": "<UNIQUE_UUID>"
}

  3. Recupera el estado de la operación de la plantilla de estado

    Tras iniciar la ejecución del comando, puede utilizar la GetCommandExecution API para recuperar la plantilla de estado.

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