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

È possibile utilizzare l'thing-group-indexing-configurationimpostazione in UpdateIndexingConfigurationAPIper creare l'AWS_ThingGroupsindice e controllarne la configurazione. È possibile utilizzare il GetIndexingConfigurationAPIper recuperare la configurazione di indicizzazione corrente.

Per aggiornare le configurazioni di indicizzazione dei gruppi di oggetti, esegui il comando: update-indexing-configuration CLI

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.

Per recuperare le configurazioni correnti di indicizzazione degli oggetti e dei gruppi di oggetti, esegui il comando: get-indexing-configuration CLI

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'AWS_ThingGroupsindice, usa il comando: describe-index CLI

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

Per interrogare i dati nell'indice, usa il comando: search-index CLI

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

Autorizzazione

È possibile specificare l'indice dei gruppi di oggetti come risorsa ARN 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).