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.

Concepts et statut des commandes

Utilisez AWS IoT les commandes pour envoyer des instructions depuis le cloud aux appareils connectés. Pour utiliser cette fonctionnalité :

Pour de plus amples informations sur le contournement, veuillez consulter Workflow de commandes de haut niveau.

Concepts clés des commandes

Les concepts clés suivants vous aident à comprendre la fonctionnalité Commandes. Les termes sont utilisés de manière cohérente dans cette documentation :

Conditions de valeur des paramètres

Lorsque vous créez des commandes avec des modèles de charge utile, définissez des conditions de valeur pour valider les valeurs des paramètres avant leur exécution. Les conditions de valeur garantissent que les paramètres répondent aux exigences, empêchant ainsi les exécutions non valides.

Opérateurs pris en charge par CommandParameterValuetype

Exemple : commande de contrôle de température

{
  "commandId": "SetTemperature",
  "namespace": "AWS-IoT",
  "payloadTemplate": "{\"temperature\": \"${aws:iot:commandexecution::parameter:temperature}\"}",
  "parameters": [
    {
      "name": "temperature",
      "type": "INTEGER",
      "valueConditions": [
        {
          "comparisonOperator": "IN_RANGE",
          "operand": {
            "numberRange": {
              "min": "60",
              "max": "80"
            }
          }
        }
      ]
    }
  ]
}

Dans cet exemple, le temperature paramètre doit être compris entre 60 et 80 (inclus). Les demandes d'exécution dont les valeurs se situent en dehors de cette plage échouent à la validation.

Priorité et évaluation des valeurs des paramètres

Lorsque vous lancez des exécutions de commandes avec des modèles de charge utile, les valeurs des paramètres sont résolues selon la priorité suivante :

Les conditions de valeur sont évaluées sur la base de la valeur finale du paramètre dérivée ci-dessus sur la priorité et avant la création de l'exécution. Si la validation échoue, la demande d'exécution renvoie une erreur.

Exemple : SetTemperature commande avec defaultValue

{
  "parameters": [
    {
      "name": "temperature",
      "type": "INTEGER",
      "defaultValue": {"I": 72},
      "valueConditions": [
        {
          "comparisonOperator": "IN_RANGE",
          "operand": {"numberRange": {"min": "60", "max": "80"}}
        }
      ]
    }
  ]
}

Au début de l'exécution :

États de commande

Les commandes que vous Compte AWS contiennent peuvent être dans l'un des trois états suivants : Disponible, Obsolète ou En attente de suppression.

Statut d’exécution de la commande

Lorsque vous lancez une exécution sur une machine cible, celle-ci entre dans un CREATED état et peut passer à d'autres statuts en fonction des rapports de l'appareil. Vous pouvez récupérer les informations d'état et suivre les exécutions.

Le tableau suivant indique les états d'exécution et leurs transitions en fonction de la progression de l'exécution.

Les appareils peuvent publier des mises à jour de statut et de résultats à tout moment à l'aide de commandes réservées aux sujets MQTT. Pour fournir un contexte supplémentaire, les appareils peuvent utiliser reasonDescription les champs reasonCode et de l'statusReasonobjet.

Le schéma suivant montre les transitions entre les états d'exécution.

Les sections suivantes décrivent les exécutions terminales et non terminales ainsi que leurs statuts.

Exécutions de commandes non terminales

Une exécution n'est pas terminale si elle peut accepter les mises à jour des appareils. Les exécutions non terminales sont considérées comme actives. Les statuts suivants ne sont pas terminaux :

Exécutions des commandes du terminal

Une exécution devient un terminal lorsqu'elle n'accepte plus les mises à jour des appareils. Les statuts suivants sont terminaux. Les exécutions peuvent passer aux statuts de terminal à partir de n'importe quel statut non terminal :CREATED,IN_PROGRESS, ou. TIMED_OUT