As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Gerenciamento da indexação de grupos de objetos
<a name="thinggroup-index"></a>

`AWS_ThingGroups` é o índice que contém todos os seus grupos de objetos. Você pode usar esse índice para pesquisar grupos com base no nome do grupo, na descrição, nos atributos e em todos os nomes de grupo pai.

## Habilitar a indexação de grupos de objetos
<a name="enable-group-index"></a>

Você pode usar a `thing-group-indexing-configuration` configuração na [UpdateIndexingConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateIndexingConfiguration.html)API para criar o `AWS_ThingGroups` índice e controlar sua configuração. Você pode usar a [GetIndexingConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_GetIndexingConfiguration.html)API para recuperar a configuração de indexação atual. 

Use o comando **update-indexing-configuration** da CLI para atualizar as configurações da indexação de grupos de objetos:

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

Você também pode atualizar configurações para a indexação de objetos e grupos de objetos em um único comando, como mostrado a seguir:

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

Estes são valores válidos para `thingGroupIndexingMode`.

DESL.  
Sem indexing/delete índice.

ON  
Criar ou configurar o índice `AWS_ThingGroups`.

Para recuperar as configurações atuais de indexação de objetos e grupos de objetos, execute o comando **get-indexing-configuration** da CLI:

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

A resposta do comando é semelhante a:

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

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

Para recuperar o status atual do índice `AWS_ThingGroups`, use o comando **describe-index** da CLI:

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

A resposta do comando é semelhante a:

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

 AWS IoT cria seu índice na primeira vez que você indexa. Você não pode consultar o índice se o `indexStatus` é `BUILDING`.

## Consultar um índice de grupos de objetos
<a name="search-group-index"></a>

Para consultar dados no índice, use o comando **search-index** da CLI:

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

## Autorização
<a name="query-thinggroup-auth"></a>

Você pode especificar o índice de grupos de coisas como um ARN de recurso em uma ação de AWS IoT política, da seguinte maneira.


****  

| Ação | Recurso | 
| --- | --- | 
|  `iot:SearchIndex`  |  O ARN de um índice (por exemplo, `arn:aws:iot:your-aws-region:index/AWS_ThingGroups`).  | 
|  `iot:DescribeIndex`  |  O ARN de um índice (por exemplo, `arn:aws:iot:your-aws-region:index/AWS_ThingGroups`).  |