Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Estado y conceptos de los comandos

Utilice AWS IoT los comandos para enviar instrucciones desde la nube a los dispositivos conectados. Para usar esta característica:

Para obtener más información acerca de este flujo de trabajo, consulte Flujo de trabajo de comandos de.

Conceptos clave de los comandos

Los siguientes conceptos clave le ayudan a entender la función de comandos. Los términos se utilizan de forma coherente en toda esta documentación:

Condiciones de valor de los parámetros

Al crear comandos con plantillas de carga útil, defina las condiciones de valor para validar los valores de los parámetros antes de la ejecución. Las condiciones de valor garantizan que los parámetros cumplan los requisitos, lo que evita las ejecuciones no válidas.

Operadores compatibles por CommandParameterValuetipo

Ejemplo: comando de control de 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"
            }
          }
        }
      ]
    }
  ]
}

En este ejemplo, el temperature parámetro debe estar entre 60 y 80 (ambos incluidos). Las solicitudes de ejecución con valores fuera de este rango no se validan.

Prioridad y evaluación del valor del parámetro

Al iniciar la ejecución de comandos con plantillas de carga útil, los valores de los parámetros se resuelven con la siguiente prioridad:

Las condiciones de valor se evalúan en función del valor final del parámetro obtenido anteriormente en función de la prioridad y antes de la creación de la ejecución. Si la validación falla, la solicitud de ejecución devuelve un error.

Ejemplo: SetTemperature comando con defaultValue

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

Al iniciar la ejecución:

Estados de comando

Los comandos de su Cuenta de AWS ordenador pueden estar en uno de estos tres estados: disponibles, obsoletos o pendientes de eliminación.

Estado de la ejecución del comando

Al iniciar una ejecución en un dispositivo de destino, entra en CREATED estado y puede pasar a otros estados en función de los informes del dispositivo. Puede recuperar la información de estado y realizar un seguimiento de las ejecuciones.

La siguiente tabla muestra los estados de ejecución y sus transiciones en función del progreso de la ejecución.

Los dispositivos pueden publicar actualizaciones de estado y resultados en cualquier momento mediante comandos reservados a los temas de MQTT. Para proporcionar un contexto adicional, los dispositivos pueden usar reasonCode reasonDescription campos del statusReason objeto.

El siguiente diagrama muestra las transiciones del estado de ejecución.

En las siguientes secciones se describen las ejecuciones terminales y no terminales y sus estados.

Ejecuciones de comandos no finales

Una ejecución no es terminal si puede aceptar actualizaciones de dispositivos. Las ejecuciones que no son terminales se consideran activas. Los siguientes estados no son terminales:

Ejecuciones de comandos finales

Una ejecución se convierte en terminal cuando ya no acepta actualizaciones de los dispositivos. Los siguientes estados son finales. Las ejecuciones pueden pasar a estados de terminal desde cualquier estado no terminal:CREATED,IN_PROGRESS, o. TIMED_OUT