Kueri status konektivitas perangkat - AWS IoT Core
Cara kerjanyaFiturManfaatPrasyaratContoh

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

Kueri status konektivitas perangkat

AWS IoT Fleet Indexing mendukung kueri konektivitas perangkat individual, memungkinkan Anda untuk secara efisien mengambil status konektivitas dan metadata terkait untuk perangkat tertentu. Fitur ini melengkapi kemampuan pengindeksan dan kueri di seluruh armada yang ada.

Cara kerjanya

Dukungan kueri konektivitas perangkat dapat digunakan untuk pengambilan status konektivitas perangkat tunggal yang dioptimalkan. API ini menyediakan latensi rendah, akses throughput tinggi ke informasi konektivitas khusus perangkat terbaru. Setelah Anda mengaktifkan pengindeksan konektivitas, Anda akan memiliki akses ke API kueri ini yang akan dikenakan biaya sebagai kueri standar. Untuk informasi selengkapnya, lihat Harga Manajemen AWS IoT Perangkat

Fitur

Dengan dukungan kueri konektivitas perangkat, Anda dapat:

  1. Kueri status konektivitas saat ini (terhubung atau terputus) untuk perangkat tertentu yang menggunakannya. thingName

  2. Ambil metadata konektivitas tambahan, termasuk:

    1. Putuskan alasan

    2. Stempel waktu untuk acara sambungkan atau putuskan sambungan terbaru.

catatan

Pengindeksan armada mengindeks status konektivitas untuk perangkat yang clientId koneksinya sama dengan hal thingName yang terdaftar di Registry.

Manfaat

  1. Latensi rendah: Mencerminkan status konektivitas perangkat terbaru dan menawarkan latensi rendah untuk mencerminkan perubahan status koneksi dari IoT Core. IoT Core menentukan perangkat sebagai terputus baik segera setelah menerima permintaan pemutusan dari perangkat atau jika perangkat terputus tanpa mengirim permintaan pemutusan sambungan. Inti IoT akan menunggu 1,5x dari waktu keep-alive yang dikonfigurasi sebelum klien ditentukan untuk terputus. Connectivity status API akan mencerminkan perubahan ini biasanya kurang dari satu detik setelah IoT Core menentukan perubahan status terhubung perangkat.

  2. Throughput tinggi: Mendukung 350 Transaksi Per Detik (TPS) secara default, dan dapat disesuaikan lebih tinggi berdasarkan permintaan.

  3. Retensi data: Menyimpan data peristiwa tanpa batas waktu saat ConnectivityIndexing mode Fleet Indexing (FI) diaktifkan dan masalahnya tidak dihapus. Jika Anda menonaktifkan Pengindeksan Konektivitas, catatan tidak akan disimpan.

catatan

Jika pengindeksan status konektivitas diaktifkan sebelum peluncuran API ini, Fleet Indexing mulai melacak perubahan status konektivitas setelah peluncuran API dan mencerminkan status yang diperbarui berdasarkan perubahan tersebut.

Prasyarat

Untuk menggunakan dukungan kueri konektivitas perangkat:

  1. Siapkan AWS akun

  2. Onboard dan daftarkan perangkat ke AWS IoT Core wilayah pilihan Anda

  3. Aktifkan Pengindeksan Armada dengan pengindeksan Konektivitas

catatan

Tidak diperlukan pengaturan tambahan jika Anda sudah mengaktifkan pengindeksan konektivitas

Untuk petunjuk penyiapan terperinci, lihat Panduan AWS IoT Pengembang

Contoh

aws iot get-thing-connectivity-data --thing-name myThingName

{
   "connected": true,
   "disconnectReason": "NONE",
   "thingName": "myThingName",
   "timestamp": "2024-12-19T10:00:00.000000-08:00"
}

  • thingName: Nama perangkat seperti yang ditunjukkan oleh permintaan. Ini juga cocok dengan clientID yang digunakan untuk terhubung. AWS IoT Core

  • disconnectReason: Alasan untuk memutuskan sambungan. Tidak akan ada untuk perangkat yang terhubung.

  • connected: Nilai boolean true yang menunjukkan perangkat ini saat ini terhubung.

  • timestamp: Stempel waktu yang mewakili pemutusan terbaru perangkat dalam milidetik.

aws iot get-thing-connectivity-data --thing-name myThingName

{
   "connected": false,
   "disconnectReason": "CLIENT_INITIATED_DISCONNECT",
   "thingName": "myThingName",
   "timestamp": "2024-12-19T10:30:00.000000-08:00"
}

  • thingName: Nama perangkat seperti yang ditunjukkan oleh permintaan. Ini juga cocok dengan clientID yang digunakan untuk terhubung. AWS IoT Core

  • disconnectReason: Alasan untuk memutuskan sambungan adalah CLIENT_INITIATED_DISCONNECT yang menunjukkan klien yang menunjukkan bahwa itu akan terputus. AWS IoT Core

  • connected: Nilai boolean false yang menunjukkan perangkat ini saat ini terputus.

  • timestamp: Stempel waktu yang mewakili pemutusan terbaru perangkat dalam milidetik.

aws iot get-thing-connectivity-data --thing-name neverConnectedThing

{
   "connected": false,
   "disconnectReason": "UNKNOWN",
   "thingName": "neverConnectedThing"
}

  • thingName: Nama perangkat seperti yang ditunjukkan oleh permintaan. Ini juga cocok dengan clientID yang digunakan untuk terhubung. AWS IoT Core

  • disconnectReason: Alasan untuk memutuskan sambungan. Akan menjadi “TIDAK DIKETAHUI” untuk perangkat yang belum pernah terhubung atau yang Pengindeksan Armada tidak memiliki alasan pemutusan terakhir yang disimpan.

  • connected: Nilai boolean false yang menunjukkan perangkat ini saat ini terputus.

  • timestamp: Stempel waktu tidak dikembalikan untuk perangkat yang belum pernah terhubung atau yang Pengindeksan Armada tidak menyimpan stempel waktu terakhir.