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à.

Comandi, concetti e stato

Usa AWS IoT i comandi per inviare istruzioni dal cloud ai dispositivi connessi. Per utilizzare questa funzionalità:

Per ulteriori informazioni su questo flusso di lavoro, consulta Flusso di lavoro dei comandi di alto livello.

Comandi, concetti chiave

I seguenti concetti chiave aiutano a comprendere la funzionalità Comandi. I termini vengono utilizzati in modo coerente in tutta la presente documentazione:

Condizioni relative al valore dei parametri

Quando create comandi con modelli di payload, definite le condizioni di valore per convalidare i valori dei parametri prima dell'esecuzione. Le condizioni di valore garantiscono che i parametri soddisfino i requisiti, impedendo esecuzioni non valide.

Operatori supportati per tipo CommandParameterValue

Esempio: comando di controllo della temperatura

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

In questo esempio, il temperature parametro deve essere compreso tra 60 e 80 (inclusi). Le richieste di esecuzione con valori al di fuori di questo intervallo non vengono convalidate.

Valore dei parametri, priorità e valutazione

Quando si avviano le esecuzioni dei comandi con modelli di payload, i valori dei parametri vengono risolti utilizzando la seguente priorità:

Le condizioni di valore vengono valutate in base al valore finale del parametro derivato in precedenza, sulla priorità e prima della creazione dell'esecuzione. Se la convalida fallisce, la richiesta di esecuzione restituisce un errore.

Esempio: SetTemperature comando con defaultValue

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

All'avvio dell'esecuzione:

Stati dei comandi

I comandi Account AWS possono trovarsi in uno dei tre stati seguenti: Disponibile, Obsoleto o In attesa di eliminazione.

Stato di esecuzione del comando

Quando si avvia un'esecuzione su un dispositivo di destinazione, il dispositivo entra in CREATED stato e può passare ad altri stati in base ai report del dispositivo. È possibile recuperare informazioni sullo stato e tenere traccia delle esecuzioni.

La tabella seguente mostra gli stati di esecuzione e le relative transizioni in base all'avanzamento dell'esecuzione.

I dispositivi possono pubblicare aggiornamenti sullo stato e sui risultati in qualsiasi momento utilizzando i comandi riservati agli argomenti MQTT. Per fornire un contesto aggiuntivo, i dispositivi possono utilizzare reasonDescription i campi reasonCode e nell'statusReasonoggetto.

Il diagramma seguente mostra le transizioni dello stato di esecuzione.

Le sezioni seguenti descrivono le esecuzioni terminali e non terminali e i relativi stati.

Esecuzioni di comandi non terminali

Un'esecuzione non è terminale se può accettare aggiornamenti dai dispositivi. Le esecuzioni non terminali sono considerate attive. I seguenti stati non sono terminali:

Esecuzioni di comandi da terminale

Un'esecuzione diventa terminale quando non accetta più aggiornamenti dai dispositivi. I seguenti stati sono terminali. Le esecuzioni possono passare allo stato di terminale da qualsiasi stato non terminale:CREATED,, o. IN_PROGRESS TIMED_OUT