Récupérez un instantané de l'état du véhicule à l'aide de modèles d'état - AWS IoT FleetWise

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Récupérez un instantané de l'état du véhicule à l'aide de modèles d'état

Important

L'accès à certaines FleetWise fonctionnalités de AWS l'IoT est actuellement restreint. Pour de plus amples informations, veuillez consulter AWS Disponibilité des régions et des fonctionnalités dans AWS l'IoT FleetWise.

Vous pouvez récupérer le dernier état connu d'un véhicule à l'aide de l'API du plan de CreateCommand AWS IoT Core contrôle ou de la FleetWise console AWS IoT.

Important

Une exception de validation peut se produire dans l'un des scénarios suivants :

  • Un modèle d'état qui n'est pas fourni ASSOCIATED avec un véhicule est fourni.

  • Une demande est faite pour activer un modèle d'état mais celui-ci ne figurait pas DEPLOYED sur un véhicule.

  • Une demande est envoyée à un modèle d'État mais elle se trouve DELETED sur un véhicule.

Vous pouvez utiliser la FleetWise console AWS IoT pour récupérer le dernier état connu d'un véhicule. AWS L'IoT FleetWise créera une commande vous permettant de récupérer des données.

Pour récupérer l'état d'un véhicule

  1. Ouvrez la FleetWise console AWS IoT.

  2. Dans le volet de navigation, sélectionnez Véhicules.

  3. Choisissez un véhicule dans la liste pour ouvrir sa page de détails.

  4. Dans l'onglet Modèles d'état, choisissez Fetch data.

  5. Sélectionnez le rôle IAM qui autorise AWS l'IoT à FleetWise envoyer une commande et à récupérer des données. Consultez la section Contrôle de l'accès.

  6. Choisissez Fetch state.

Pour récupérer un instantané d'état, créez d'abord une ressource de commande. Vous pouvez ensuite envoyer la commande suivante au véhicule dont vous souhaitez récupérer le cliché d'état. Pour plus d'informations sur l'utilisation de l'CreateCommandAPI et de ses paramètres, consultezUtilisation de l'API CreateCommand.

  1. Création d'une ressource de commande

    L'exemple suivant montre comment créer la ressource de commande pour effectuer l'opération d'extraction. Vous pouvez spécifier des valeurs alternatives pour les paramètres obligatoires lorsque vous envoyez la commande au véhicule. Pour de plus amples informations, veuillez consulter Création d'une ressource de commande.

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

    Réponse :

    { 
    "commandId": "<COMMAND_ID>",
    "commandArn": "arn:aws:iot:<REGION>:<ACCOUNT_ID>:command/<COMMAND_ID>"
}
  2. Lancer l'exécution de la commande pour récupérer un instantané d'état

    Une fois la commande créée, envoyez-la au véhicule. Si vous n'avez pas spécifié de valeurs pour les paramètres obligatoires lors de la création de la ressource de commande, vous devez les spécifier maintenant. Pour de plus amples informations, veuillez consulter Envoyer une commande (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>

    Réponse :

    {
    "executionId": "<UNIQUE_UUID>"
}

  3. Récupère le statut de l'opération du modèle d'état

    Après avoir lancé l'exécution de la commande, vous pouvez utiliser l'GetCommandExecutionAPI pour récupérer le modèle d'état.

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