Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Verwalten der Objektgruppenindizierung
<a name="thinggroup-index"></a>

`AWS_ThingGroups` ist der Index, die alle Ihre Objektgruppen enthält. Dieser Index ermöglicht Ihnen die Suche nach Gruppen basierend auf Gruppennamen, Beschreibung, Attributen und allen übergeordneten Gruppennamen.

## Aktivieren der Objektgruppenindizierung
<a name="enable-group-index"></a>

Sie können die `thing-group-indexing-configuration` Einstellung in der [UpdateIndexingConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateIndexingConfiguration.html)API verwenden, um den `AWS_ThingGroups` Index zu erstellen und seine Konfiguration zu steuern. Sie können die [GetIndexingConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_GetIndexingConfiguration.html)API verwenden, um die aktuelle Indexierungskonfiguration abzurufen. 

Mit dem CLI-Befehl **update-indexing-configuration** können Sie die Konfigurationen der Objektindizierung aktualisieren.

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

Sie können Konfigurationen für sowohl die Objekt- als auch die Objektgruppenindizierung wie folgt auch in einem einzigen Befehl aktualisieren.

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

Im Folgenden sehen Sie gültige Werte für `thingGroupIndexingMode`.

OFF  
Kein indexing/delete Index.

ON  
Den `AWS_ThingGroups`-Index erstellen oder konfigurieren.

Verwenden Sie den CLI-Befehl **get-indexing-configuration** zum Abrufen der aktuellen Indizierungskonfigurationen des Objekts und der Objektgruppe.

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

Die Ausgabe des Befehls sieht wie folgt aus:

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

## Beschreiben von Gruppenindizes
<a name="describe-group-index"></a>

Verwenden Sie den CLI-Befehl `AWS_ThingGroups` zum Abrufen des aktuellen Status des **describe-index**-Index.

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

Die Ausgabe des Befehls sieht wie folgt aus:

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

 AWS IoT erstellt Ihren Index bei der ersten Indizierung. Es ist nicht möglich, den Index abzufragen, wenn `indexStatus` auf `BUILDING` eingestellt ist.

## Abfragen eines Objektgruppenindex
<a name="search-group-index"></a>

Verwenden Sie den CLI-Befehl **search-index** zum Abfragen von Daten im Index:

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

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

Sie können den Index der Dinggruppen wie folgt als Ressourcen-ARN in einer AWS IoT Richtlinienaktion angeben.


****  

| Action | Ressource | 
| --- | --- | 
|  `iot:SearchIndex`  |  Ein Index-ARN (z. B. `arn:aws:iot:your-aws-region:index/AWS_ThingGroups`).  | 
|  `iot:DescribeIndex`  |  Ein Index-ARN (z. B. `arn:aws:iot:your-aws-region:index/AWS_ThingGroups`).  |