Gestione dell'indicizzazione di gruppi di oggetti - AWS IoT Core

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

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

Puoi utilizzare l'thing-group-indexing-configurationimpostazione nell'UpdateIndexingConfigurationAPI per creare l'AWS_ThingGroupsindice e controllarne la configurazione. È possibile utilizzare l'GetIndexingConfigurationAPI 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

Nessuna indicizzazione/eliminazione dell'indice.

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

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 il tuo 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

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

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