Kelola pengindeksan grup hal

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

Mengaktifkan pengindeksan grup hal

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

Untuk memperbarui konfigurasi pengindeksan grup benda, jalankan perintah CLIupdate-indexing-configuration:

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 indeks pengindeks/hapus.

PADA

Buat atau konfigurasikan AWS_ThingGroups indeks.

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

aws iot get-indexing-configuration

Respons perintah terlihat seperti berikut:

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

Menggambarkan 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.

Menanyakan indeks grup benda

Untuk kueri 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 grup benda 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).