As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Conceitos e status de comandos

Use AWS IoT Comandos para enviar instruções da nuvem para dispositivos conectados. Para usar esse atributo:

Para obter mais informações sobre esse fluxo de trabalho, consulte High-level fluxo de trabalho de comandos.

Conceitos de chaves de comandos

Os conceitos-chave a seguir ajudam você a entender o recurso Comandos. Os termos são usados de forma consistente em toda esta documentação:

Condições do valor do parâmetro

Ao criar comandos com modelos de carga útil, defina condições de valor para validar os valores dos parâmetros antes da execução. As condições de valor garantem que os parâmetros atendam aos requisitos, evitando execuções inválidas.

Operadores suportados por CommandParameterValue tipo

Exemplo: comando de controle 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"
            }
          }
        }
      ]
    }
  ]
}

Neste exemplo, o temperature parâmetro deve estar entre 60 e 80 (inclusive). Solicitações de execução com valores fora desse intervalo falham na validação.

Prioridade e avaliação do valor do parâmetro

Ao iniciar execuções de comandos com modelos de carga útil, os valores dos parâmetros são resolvidos usando a seguinte prioridade:

As condições de valor são avaliadas no valor final do parâmetro derivado acima na prioridade e antes da criação da execução. Se a validação falhar, a solicitação de execução retornará um erro.

Exemplo: SetTemperature comando com defaultValue

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

Ao iniciar a execução:

Estados de comando

Os comandos em seu Conta da AWS podem estar em um dos três estados: Disponível, Obsoleto ou Exclusão pendente.

Status de execução do comando

Quando você inicia uma execução em um dispositivo de destino, ele entra no CREATED status e pode fazer a transição para outros status com base nos relatórios do dispositivo. Você pode recuperar informações de status e acompanhar as execuções.

A tabela a seguir mostra os status de execução e suas transições com base no progresso da execução.

Os dispositivos podem publicar atualizações de status e resultados a qualquer momento usando comandos reservados para tópicos do MQTT. Para fornecer contexto adicional, os dispositivos podem usar reasonDescription campos reasonCode e no statusReason objeto.

O diagrama a seguir mostra as transições do status de execução.

As seções a seguir descrevem as execuções terminais e não terminais e seus status.

Non-terminal execuções de comandos

Uma execução não é terminal se puder aceitar atualizações de dispositivos. Non-terminal as execuções são consideradas ativas. Os seguintes status não são terminais:

Execuções de comandos terminais

Uma execução se torna terminal quando não aceita mais atualizações de dispositivos. Os status a seguir são terminais. As execuções podem passar para o status do terminal a partir de qualquer status não terminal:CREATED,, IN_PROGRESS ou. TIMED_OUT