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 High-level flux de travail des commandes.

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 relatives à la 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 CommandParameterValue type

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 ne sont pas comprises dans cette plage ne sont pas validées.

Priorité et évaluation des valeurs des paramètres

Lorsque vous démarrez 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 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émarrage de l'exécution :

États de commande

Les commandes que vous Compte AWS utilisez 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 démarrez une exécution sur une machine cible, celle-ci passe à un CREATED statut et peut passer à d'autres états en fonction des rapports de l'appareil. Vous pouvez récupérer des informations d'état et suivre les exécutions.

Le tableau suivant présente 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 des commandes réservées aux rubriques 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 d'état d'exécution.

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

Non-terminal exécutions de commandes

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

Exécutions de commandes dans le terminal

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