View a markdown version of this page

Mengelola pengindeksan grup benda - AWS IoT Core

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

Mengelola pengindeksan grup benda

AWS_ThingGroupsadalah indeks yang berisi semua grup benda Anda. Anda dapat menggunakan indeks ini untuk mencari grup berdasarkan nama grup, deskripsi, atribut, dan semua nama grup induk.

Mengaktifkan pengindeksan grup benda

Anda dapat menggunakan thing-group-indexing-configuration pengaturan di UpdateIndexingConfiguration API untuk membuat AWS_ThingGroups indeks dan mengontrol konfigurasinya. Anda dapat menggunakan GetIndexingConfiguration API untuk mengambil konfigurasi pengindeksan saat ini.

Untuk memperbarui konfigurasi pengindeksan grup hal, jalankan perintah update-indexing-configuration CLI:

aws iot update-indexing-configuration --thing-group-indexing-configuration thingGroupIndexingMode=ON

Anda juga dapat memperbarui konfigurasi untuk pengindeksan grup benda dan benda dalam satu perintah, sebagai berikut:

aws iot update-indexing-configuration --thing-indexing-configuration thingIndexingMode=REGISTRY --thing-group-indexing-configuration thingGroupIndexingMode=ON

Berikut ini adalah nilai yang valid untukthingGroupIndexingMode.

MATI

Tidak ada indexing/delete indeks.

PADA

Buat atau konfigurasikan AWS_ThingGroups indeks.

Untuk mengambil konfigurasi pengindeksan grup benda dan hal saat ini, jalankan perintah get-indexing-configuration CLI:

aws iot get-indexing-configuration

Respons perintah terlihat seperti berikut:

{ "thingGroupIndexingConfiguration": { "thingGroupIndexingMode": "ON" } }

Menjelaskan indeks grup

Untuk mengambil status AWS_ThingGroups indeks saat ini, gunakan perintah describe-index CLI:

aws iot describe-index --index-name "AWS_ThingGroups"

Respons perintah terlihat seperti berikut:

{ "indexStatus": "ACTIVE", "indexName": "AWS_ThingGroups", "schema": "THING_GROUPS" }

AWS IoT membangun indeks Anda saat pertama kali Anda mengindeks. Anda tidak dapat menanyakan indeks jika indexStatus adaBUILDING.

Mengkueri indeks grup benda

Untuk menanyakan data dalam indeks, gunakan perintah search-index CLI:

aws iot search-index --index-name "AWS_ThingGroups" --query-string "thingGroupName:mythinggroup*"

Otorisasi

Anda dapat menentukan indeks kelompok hal sebagai ARN sumber daya dalam tindakan AWS IoT kebijakan, sebagai berikut.

Tindakan Sumber daya

iot:SearchIndex

Indeks ARN (misalnya,arn:aws:iot:your-aws-region:index/AWS_ThingGroups).

iot:DescribeIndex

Indeks ARN (misalnya,arn:aws:iot:your-aws-region:index/AWS_ThingGroups).