기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

명령 개념 및 상태

AWS IoT 명령을 사용하여 클라우드에서 연결된 디바이스로 지침을 보냅니다. 이 특성을 사용하는 방법:

이 워크플로에 대한 자세한 내용은 상위 수준 명령 워크플로 섹션을 참조하세요.

명령 주요 개념

다음 주요 개념은 명령 기능을 이해하는 데 도움이 됩니다. 용어는이 설명서 전체에서 일관되게 사용됩니다.

파라미터 값 조건

페이로드 템플릿으로 명령을 생성할 때 실행 전에 파라미터 값을 검증하는 값 조건을 정의합니다. 값 조건은 파라미터가 요구 사항을 충족하도록 하여 잘못된 실행을 방지합니다.

CommandParameterValue 유형별로 지원되는 연산자

예: 온도 제어 명령

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

이 예제에서 temperature 파라미터는 60~80(포함)이어야 합니다. 이 범위를 벗어나는 값이 있는 실행 요청은 검증에 실패합니다.

파라미터 값 우선 순위 및 평가

페이로드 템플릿으로 명령 실행을 시작할 때 파라미터 값은 다음 우선 순위를 사용하여 확인됩니다.

값 조건은 실행 생성 전에 우선 순위에 대해 위에서 파생된 최종 파라미터 값에 대해 평가됩니다. 검증에 실패하면 실행 요청이 오류를 반환합니다.

예:를 사용한 SetTemperature 명령 defaultValue

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

실행을 시작할 때:

명령 상태

의 명령은 사용 가능, 사용 중단됨 또는 삭제 보류 중의 세 가지 상태 중 하나일 AWS 계정 수 있습니다.

명령 실행 상태

대상 디바이스에서 실행을 시작하면 CREATED 상태가 되고 디바이스 보고서에 따라 다른 상태로 전환할 수 있습니다. 상태 정보를 검색하고 실행을 추적할 수 있습니다.

다음 표에는 실행 진행 상황에 따른 실행 상태와 전환이 나와 있습니다.

디바이스는 명령 예약 MQTT 주제를 사용하여 언제든지 상태 및 결과 업데이트를 게시할 수 있습니다. 추가 컨텍스트를 제공하기 위해 디바이스는 statusReason 객체에서 reasonCode 및 reasonDescription 필드를 사용할 수 있습니다.

다음 다이어그램은 실행 상태 전환을 보여줍니다.

다음 섹션에서는 터미널 및 비터미널 실행과 해당 상태에 대해 설명합니다.

비터미널 명령 실행

디바이스의 업데이트를 수락할 수 있는 경우 실행은 비터미널입니다. 비터미널 실행은 활성으로 간주됩니다. 다음 상태는 비터미널 상태입니다.

터미널 명령 실행

디바이스의 업데이트를 더 이상 수락하지 않으면 실행이 터미널이 됩니다. 다음 상태는 터미널 상태입니다. 실행은 CREATED, IN_PROGRESS또는와 같은 비터미널 상태에서 터미널 상태로 전환할 수 있습니다TIMED_OUT.