Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Konsep dan status perintah

Gunakan AWS IoT Perintah untuk mengirim instruksi dari cloud ke perangkat yang terhubung. Untuk menggunakan fitur ini:

Untuk informasi selengkapnya tentang alur kerja ini, lihatHigh-level alur kerja perintah.

Konsep kunci perintah

Konsep kunci berikut membantu Anda memahami fitur Perintah. Istilah digunakan secara konsisten di seluruh dokumentasi ini:

Kondisi nilai parameter

Saat membuat perintah dengan templat payload, tentukan kondisi nilai untuk memvalidasi nilai parameter sebelum eksekusi. Kondisi nilai memastikan parameter memenuhi persyaratan, mencegah eksekusi yang tidak valid.

Operator yang didukung berdasarkan CommandParameterValue jenis

Contoh: Perintah kontrol suhu

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

Dalam contoh ini, temperature parameter harus antara 60 dan 80 (inklusif). Permintaan eksekusi dengan nilai di luar rentang ini gagal validasi.

Prioritas dan evaluasi nilai parameter

Saat memulai eksekusi perintah dengan template payload, nilai parameter diselesaikan menggunakan prioritas berikut:

Kondisi nilai dievaluasi pada nilai parameter akhir yang diturunkan di atas pada prioritas dan sebelum pembuatan eksekusi. Jika validasi gagal, permintaan eksekusi mengembalikan kesalahan.

Contoh: SetTemperature perintah dengan defaultValue

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

Saat memulai eksekusi:

Status perintah

Perintah di Anda Akun AWS dapat berada di salah satu dari tiga status: Tersedia, Tidak digunakan lagi , atau Penundaan penghapusan.

Status pelaksanaan perintah

Saat Anda memulai eksekusi pada perangkat target, perangkat tersebut memasuki CREATED status dan dapat beralih ke status lain berdasarkan laporan perangkat. Anda dapat mengambil informasi status dan melacak eksekusi.

Tabel berikut menunjukkan status eksekusi dan transisinya berdasarkan kemajuan eksekusi.

Perangkat dapat mempublikasikan pembaruan status dan hasil kapan saja menggunakan perintah yang disediakan topik MQTT. Untuk memberikan konteks tambahan, perangkat dapat menggunakan reasonCode dan reasonDescription bidang dalam statusReason objek.

Diagram berikut menunjukkan transisi status eksekusi.

Bagian berikut menjelaskan eksekusi terminal dan non-terminal serta statusnya.

Non-terminal eksekusi perintah

Eksekusi adalah non-terminal jika dapat menerima pembaruan dari perangkat. Non-terminal Eksekusi dianggap aktif. Status berikut adalah non-terminal:

Eksekusi perintah terminal

Eksekusi menjadi terminal ketika tidak lagi menerima pembaruan dari perangkat. Status berikut adalah terminal. Eksekusi dapat beralih ke status terminal dari status non-terminal apa pun:CREATED,, IN_PROGRESS atau. TIMED_OUT