Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Gestione dell'indicizzazione di gruppi di oggetti
<a name="thinggroup-index"></a>

`AWS_ThingGroups` è l'indice che contiene tutti i tuoi gruppi di oggetti. Questo indice consente di cercare gruppi in base al nome del gruppo, alla descrizione, agli attributi e a tutti i nomi del gruppo padre.

## Abilitazione dell'indicizzazione di gruppi di oggetti
<a name="enable-group-index"></a>

Puoi utilizzare l'`thing-group-indexing-configuration`impostazione nell'[UpdateIndexingConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateIndexingConfiguration.html)API per creare l'`AWS_ThingGroups`indice e controllarne la configurazione. È possibile utilizzare l'[GetIndexingConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_GetIndexingConfiguration.html)API per recuperare la configurazione di indicizzazione corrente. 

Per aggiornare le configurazioni dell'indicizzazione dei gruppi di oggetti, esegui il comando CLI **update-indexing-configuration**:

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

Puoi inoltre aggiornare le configurazioni per l'indicizzazione sia degli oggetti che dei gruppi di oggetti con un unico comando, come descritto di seguito:

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

Di seguito sono riportati i valori validi per `thingGroupIndexingMode`.

OFF  
Nessun indice. indexing/delete 

ATTIVATO  
Creazione o configurazione dell'indice `AWS_ThingGroups`.

Utilizzare il comando CLI **get-indexing-configuration** per recuperare l'attuale oggetto e le configurazioni di indicizzazione del gruppo di oggetti:

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

La risposta del comando è simile alla seguente:

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

## Descrizione degli indici di gruppi
<a name="describe-group-index"></a>

Per recuperare lo stato corrente dell'indice `AWS_ThingGroups`, utilizzare il comando CLI **describe-index**:

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

La risposta del comando è simile alla seguente:

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

 AWS IoT crea l'indice la prima volta che esegui l'indicizzazione. Non è possibile eseguire query dell'indice se `indexStatus` è `BUILDING`.

## Esecuzione di query su un indice di gruppi di oggetti
<a name="search-group-index"></a>

Utilizzare il comando CLI **search-index** per eseguire query dei dati nell'indice:

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

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

È possibile specificare l'indice dei gruppi di oggetti come ARN di risorse in un'azione AWS IoT politica, come segue.


****  

| Azione | Risorsa | 
| --- | --- | 
|  `iot:SearchIndex`  |  Un indice ARN (ad esempio, `arn:aws:iot:your-aws-region:index/AWS_ThingGroups`).  | 
|  `iot:DescribeIndex`  |  Un indice ARN (ad esempio, `arn:aws:iot:your-aws-region:index/AWS_ThingGroups`).  |