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](https://aws.amazon.com/iot-device-management/pricing/#:~:text=Search%20queries%20(per%2010%2C000%20queries))
## Fitur
Dengan dukungan kueri konektivitas perangkat, Anda dapat:
1. Kueri status konektivitas saat ini (terhubung atau terputus) untuk perangkat tertentu yang menggunakannya. `thingName`
1. Ambil metadata konektivitas tambahan, termasuk:
1. Putuskan alasan
1. 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.](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html)
## 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.
1. **Throughput tinggi:** Mendukung 350 Transaksi Per Detik (TPS) secara default, dan dapat disesuaikan ke lebih tinggi berdasarkan permintaan.
1. **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](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html)
1. Onboard dan daftarkan perangkat ke AWS IoT Core wilayah pilihan Anda
1. [Aktifkan Pengindeksan Armada dengan pengindeksan](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html) Konektivitas
**catatan**
Tidak diperlukan pengaturan tambahan jika Anda sudah mengaktifkan pengindeksan konektivitas
Untuk petunjuk penyiapan terperinci, lihat [Panduan AWS IoT Pengembang](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html)
## 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\$1INITIATED\$1DISCONNECT 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.