Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mempersiapkan pengindeksan armada
Dengan pengindeksan AWS IoT armada, Anda dapat mencari dan mengumpulkan data dengan menggunakan shadow (`$package`) yang dicadangkan. Anda juga dapat mengelompokkan AWS IoT hal-hal dengan menanyakan [Cadangan bernama bayangan](preparing-to-use-software-package-catalog.md#reserved-named-shadow) dan grup [https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html) benda dinamis. Misalnya, Anda dapat menemukan informasi tentang AWS IoT hal-hal yang menggunakan versi paket tertentu, tidak menginstal versi paket tertentu, atau tidak menginstal versi paket apa pun. Anda dapat memperoleh wawasan lebih lanjut dengan menggabungkan atribut. Misalnya, mengidentifikasi hal-hal yang memiliki versi tertentu dan jenis benda tertentu (seperti versi 1.0.0 dan tipe benda pump\_sensor). Untuk informasi selengkapnya, lihat Pengindeksan Ar [https://docs.aws.amazon.com/iot/latest/developerguide/iot-indexing.html](https://docs.aws.amazon.com/iot/latest/developerguide/iot-indexing.html) mada.
## Mengatur `bayangan` $package sebagai sumber data
Untuk menggunakan pengindeksan armada dengan Katalog Paket Perangkat Lunak, Anda harus mengaktifkan pengindeksan armada, menetapkan bayangan bernama sebagai sumber data, dan mendefinisikan `$package` sebagai filter bayangan bernama. Jika Anda belum mengaktifkan pengindeksan armada, Anda dapat mengaktifkannya dalam proses ini. Dari [AWS IoT Core](https://console.aws.amazon.com/iot/home) konsol, buka Peng ** aturan**, pilih ** Kelola pengindeksan**, lalu ** Tambahkan bayangan bernama**, ** Tambahkan paket dan versi perangkat lunak perangkat**, dan Per ** barui**. Untuk informasi selengkapnya, lihat Mengel [ ola pengindeksan benda](https://docs.aws.amazon.com/iot/latest/developerguide/managing-fleet-index.html#thing-index).
Sebagai alternatif, Anda dapat mengaktifkan pengindeksan armada saat membuat paket pertama Anda. Saat kotak ** dialog ** Aktifkan dependensi untuk manajemen paket muncul, pilih opsi untuk menambahkan paket perangkat lunak dan versi sebagai sumber data ke pengindeksan armada. Dengan memilih opsi ini, Anda juga mengaktifkan pengindeksan armada.
**catatan**
Mengaktifkan pengindeksan armada untuk Katalog Paket Perangkat Lunak menimbulkan biaya layanan standar. Untuk informasi lebih lanjut, lihat [AWS IoT Device Management, Harga](https://aws.amazon.com/iot-device-management/pricing/).
## Metrik ditampilkan di konsol
Pada halaman detail paket perangkat lunak AWS IoT konsol, ** panel ** Discovery menampilkan metrik standar yang dicerna melalui `$package` bayangan.
+ **Bagan distribusi versi ** saat ini menunjukkan jumlah perangkat dan persentase untuk 10 versi paket terbaru yang terkait dengan AWS IoT sesuatu dari semua perangkat yang terkait dengan paket perangkat lunak ini. **Catatan: ** Jika paket perangkat lunak memiliki lebih banyak versi paket daripada yang diberi label dalam bagan, Anda dapat menemukannya dikelompokkan dalam ** Lainnya**.
+ Bagan ** histor ** is menunjukkan jumlah perangkat yang terkait dengan versi paket yang dipilih selama periode waktu tertentu. Bagan awalnya kosong sampai Anda memilih hingga 5 versi paket dan menentukan rentang tanggal dan interval waktu. Untuk memilih parameter bagan, pilih Peng ** aturan**. Data yang ditampilkan di bagan ** Historis ** mungkin berbeda dari ** bagan distribusi versi ** saat ini karena perbedaan jumlah versi paket yang ditampilkan dan juga karena Anda dapat memilih versi paket mana yang akan dianalisis di bagan ** Historis**. **Catatan: ** Saat Anda memilih versi paket untuk divisualisasikan, itu dihitung terhadap jumlah maksimum batas metrik armada. Untuk informasi selengkapnya, lihat B [ atas dan kuota ](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits) pengindeksan Armada.
Untuk metode lain untuk mendapatkan wawasan tentang pengumpulan distribusi versi paket, lihat Meng [ umpulkan distribusi versi paket melalui `getBucketsAggregation`](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-fleet-indexing.html#package-version-distribution).
## Pola kueri
Pengindeksan armada dengan Katalog Paket Perangkat Lunak menggunakan sebagian besar fitur standar yang didukung (seperti istilah, frasa, dan bidang pencarian). Namun, operator perbandingan (misalnya, kurang dari `<` dan lebih besar dari`>`) dan `range` kueri tidak tersedia untuk `version` kunci bernama shadow (`$package`) yang dicadangkan. Kueri ini tersedia untuk `attributes` kunci. Untuk informasi selengkapnya, lihat Sintak [ s kueri](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html).
### Contoh data
**Catatan: ** untuk informasi tentang bayangan bernama cadangan dan strukturnya, lihat Cadangan [ bernama Cadangan](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-to-use-software-package-catalog.html#reserved-named-shadow).
Dalam contoh ini, perangkat pertama diberi nama `AnyThing` dan memiliki paket berikut yang diinstal:
+ Paket perangkat lunak: `SamplePackage`
Versi paket: `1.0.0`
Paket ID: `1111`
Bayangan terlihat sebagai berikut:
```
{
"state": {
"reported": {
"SamplePackage": {
"version": "1.0.0",
"attributes": {
"s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
"packageID": "1111"
}
}
}
}
}
```
Perangkat kedua diberi nama `AnotherThing` dan memiliki paket berikut yang diinstal:
+ Paket perangkat lunak: `SamplePackage`
Versi paket: `1.0.0`
Paket ID: `1111`
+ Paket perangkat lunak: `OtherPackage`
Versi paket: `1.2.5`
Paket ID: `2222`
Bayangan terlihat sebagai berikut:
```
{
"state": {
"reported": {
"SamplePackage": {
"version": "1.0.0",
"attributes": {
"s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
"packageID": "1111"
}
},
"OtherPackage": {
"version": "1.2.5",
"attributes": {
"s3UrlForOtherPackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile2",
"packageID": "2222"
}
},
}
}
}
```
### Kueri Sampel
Tabel berikut mencantumkan contoh kueri berdasarkan contoh bayangan perangkat untuk `AnyThing` dan`AnotherThing`. Untuk informasi selengkapnya, lihat [ Contoh kueri hal](https://docs.aws.amazon.com/iot/latest/developerguide/example-queries.html).
**Versi terbaru dari AWS IoT Device Tester untuk FreeRTOS**
| **Informasi yang diminta ** | **Kueri** | **Hasil ** |
| --- | --- | --- |
| Hal-hal yang memiliki versi paket tertentu yang diinstal | `shadow.name.$package.reported.SamplePackage.version:1.0.0` | `AnyThing`, `OtherThing` |
| Hal-hal yang tidak memiliki versi paket tertentu yang diinstal | `NOT shadow.name.$package.reported.OtherPackage.version:1.2.5` | `AnyThing` |
| Perangkat apa pun yang menggunakan versi paket yang ID paketnya lebih besar dari 1500 | `shadow.name.$package.reported.*.attributes.packageID>1500"` | `OtherThing` |
| Hal-hal yang memiliki paket tertentu diinstal dan memiliki lebih dari satu paket yang diinstal | `shadow.name.$package.reported.SamplePackage.version:1.0.0 AND shadow.name.$package.reported.totalCount:2` | `OtherThing` |
## Mengumpulkan distribusi versi paket melalui `get BucketsAggregation`
Selain ** panel ** Discovery di dalam AWS IoT konsol, Anda juga bisa mendapatkan informasi distribusi versi paket dengan menggunakan operasi [`GetBucketsAggregation`](https://docs.aws.amazon.com/iot/latest/apireference/API_GetBucketsAggregation.html) API. Untuk mendapatkan informasi distribusi versi paket, Anda harus melakukan hal berikut:
+ Tentukan bidang khusus dalam pengindeksan armada untuk setiap paket perangkat lunak. **Catatan: ** Membuat bidang khusus diperhitungkan dalam kuota [ layanan pengindeksan ](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits)AWS IoT armada.
+ Format bidang kustom sebagai berikut:
`shadow.name.$package.reported.{{}}.version`
Untuk informasi selengkapnya, lihat [ bagian Bid ](https://docs.aws.amazon.com/iot/latest/developerguide/managing-fleet-index.html#custom-field) ang kustom dalam pengindeksan AWS IoT armada.