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 High-level flusso di lavoro dei comandi.

Concetti chiave dei comandi

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

Condizioni relative ai valori dei parametri

Quando crei comandi con modelli di payload, definisci le condizioni di valore per convalidare i valori dei parametri prima dell'esecuzione. Le condizioni di valore assicurano 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 superano la convalida.

Priorità e valutazione dei valori dei parametri

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 sopra, 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 in your Account AWS possono essere in uno dei tre stati: Disponibile, Obsoleto o In attesa di eliminazione.

Stato di esecuzione del comando

Quando si avvia un'esecuzione su un dispositivo di destinazione, questo 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 di stato e risultati in qualsiasi momento utilizzando comandi e argomenti MQTT riservati. Per fornire un contesto aggiuntivo, i dispositivi possono utilizzare i reasonDescription campi reasonCode e nell'oggetto. statusReason

Il diagramma seguente mostra le transizioni tra gli stati di esecuzione.

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

Non-terminal esecuzioni di comandi

Un'esecuzione non è terminale se può accettare aggiornamenti dai dispositivi. Non-terminal le esecuzioni 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 agli stati di terminale da qualsiasi stato non terminale:CREATED,, o. IN_PROGRESS TIMED_OUT