Gestione dell'indicizzazione di gruppi di oggetti

AWS_ThingGroupsè l'indice che contiene tutti i gruppi di cose e i gruppi di fatturazione. 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 nell'API di UpdateIndexingconfigurazione per creare l'AWS_ThingGroupsindice e controllarne la configurazione. È possibile utilizzare l'API GetIndexingdi configurazione 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).