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 Fluxo de trabalho de comandos de alto nível.

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 de 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 CommandParameterValuetipo

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 as 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 no 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, ela 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 aos tópicos do MQTT. Para fornecer contexto adicional, os dispositivos podem usar reasonCode reasonDescription campos no statusReason objeto.

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

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

Execuções de comandos não terminais

Uma execução não é terminal se puder aceitar atualizações de dispositivos. As execuções não terminais 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 fazer a transição para status de terminal a partir de qualquer status que não seja terminal:CREATED,, IN_PROGRESS ou. TIMED_OUT