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

# Kelola pengindeksan grup hal
<a name="thinggroup-index"></a>

`AWS_ThingGroups`adalah indeks yang berisi semua kelompok hal Anda. Anda dapat menggunakan indeks ini untuk mencari grup berdasarkan nama grup, deskripsi, atribut, dan semua nama grup induk.

## Mengaktifkan pengindeksan grup hal
<a name="enable-group-index"></a>

Anda dapat menggunakan `thing-group-indexing-configuration` pengaturan di [UpdateIndexingConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateIndexingConfiguration.html)API untuk membuat `AWS_ThingGroups` indeks dan mengontrol konfigurasinya. Anda dapat menggunakan [GetIndexingConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_GetIndexingConfiguration.html)API untuk mengambil konfigurasi pengindeksan saat ini. 

Untuk memperbarui konfigurasi pengindeksan grup benda, jalankan perintah CLI**update-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 untuk`thingGroupIndexingMode`.

MATI  
Tidak ada indexing/delete indeks.

PADA  
Buat atau konfigurasikan `AWS_ThingGroups` indeks.

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

```
aws iot get-indexing-configuration
```

Respons perintah terlihat seperti berikut:

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

## Menggambarkan indeks grup
<a name="describe-group-index"></a>

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` ada`BUILDING`.

## Menanyakan indeks grup benda
<a name="search-group-index"></a>

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

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

## Otorisasi
<a name="query-thinggroup-auth"></a>

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`).  |