Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Administración de la indexación de grupos de objetos
<a name="thinggroup-index"></a>

`AWS_ThingGroups` es el índice que contiene todos sus grupos de objetos. Puede usar este índice para buscar grupos en función de su nombre, descripción, atributos y todos los nombres de grupos principales.

## Habilitación de la indexación de grupos de objetos
<a name="enable-group-index"></a>

Puede utilizar la `thing-group-indexing-configuration` configuración de la [UpdateIndexingConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateIndexingConfiguration.html)API para crear el `AWS_ThingGroups` índice y controlar su configuración. Puede usar la [GetIndexingConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_GetIndexingConfiguration.html)API para recuperar la configuración de indexación actual. 

Para actualizar las configuraciones de indexación del grupo de objetos, ejecute el comando de la CLI **update-indexing-configuration**:

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

También puede actualizar las configuraciones de la indexación de objetos y grupos de objetos en un único comando, como en el siguiente ejemplo.

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

Los siguientes valores son válidos para `thingGroupIndexingMode`.

OFF  
Sin indexing/delete índice.

ON  
Cree o configure el índice `AWS_ThingGroups`.

Para recuperar las configuraciones actuales de indexación de objetos y grupos de objetos, ejecute el comando de la CLI **get-indexing-configuration**:

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

La respuesta del comando tendrá un aspecto similar al siguiente:

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

## Descripción de índices de grupos
<a name="describe-group-index"></a>

Para recuperar el estado actual del índice `AWS_ThingGroups`, utilice el comando de la CLI **describe-index**:

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

La respuesta del comando tendrá un aspecto similar al siguiente:

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

 AWS IoT crea el índice la primera vez que indexa. No se puede consultar el índice si `indexStatus` es `BUILDING`.

## Consulta de un índice de grupo de objetos
<a name="search-group-index"></a>

Para consultar los datos del índice, utilice el comando de la CLI **search-index**:

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

## Autorización
<a name="query-thinggroup-auth"></a>

Puede especificar el índice de grupos de cosas como un ARN de recurso en una acción de AWS IoT política, de la siguiente manera.


****  

| Action | Recurso | 
| --- | --- | 
|  `iot:SearchIndex`  |  El ARN de un índice (por ejemplo, `arn:aws:iot:your-aws-region:index/AWS_ThingGroups`).  | 
|  `iot:DescribeIndex`  |  El ARN de un índice (por ejemplo, `arn:aws:iot:your-aws-region:index/AWS_ThingGroups`).  |