Verwalten der Objektgruppenindizierung - AWS IoT Core

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

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

Sie können die thing-group-indexing-configuration Einstellung in der UpdateIndexingConfigurationAPI verwenden, um den AWS_ThingGroups Index zu erstellen und seine Konfiguration zu steuern. Sie können die GetIndexingConfigurationAPI 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

Keine Indizierung/Index löschen

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

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 Indexierung. Es ist nicht möglich, den Index abzufragen, wenn indexStatus auf BUILDING eingestellt ist.

Abfragen eines Objektgruppenindex

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

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

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