Administración de la indexación de grupos de objetos

AWS_ThingGroups es el índice que contiene todos sus grupos de objetos. Puede usar este índice para buscar grupos en función de su nombre, descripción, atributos y todos los nombres de grupos principales.

Habilitación de la indexación de grupos de objetos

Puede utilizar la thing-group-indexing-configuration configuración de la UpdateIndexingConfigurationAPI para crear el AWS_ThingGroups índice y controlar su configuración. Puede usar la GetIndexingConfigurationAPI para recuperar la configuración de indexación actual.

Para actualizar las configuraciones de indexación del grupo de objetos, ejecute el comando de la CLI update-indexing-configuration:

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

También puede actualizar las configuraciones de la indexación de objetos y grupos de objetos en un único comando, como en el siguiente ejemplo.

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

Los siguientes valores son válidos para thingGroupIndexingMode.

OFF

Sin indexing/delete índice.

ON

Cree o configure el índice AWS_ThingGroups.

Para recuperar las configuraciones actuales de indexación de objetos y grupos de objetos, ejecute el comando de la CLI get-indexing-configuration:

aws iot get-indexing-configuration

La respuesta del comando tendrá un aspecto similar al siguiente:

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

Descripción de índices de grupos

Para recuperar el estado actual del índice AWS_ThingGroups, utilice el comando de la CLI describe-index:

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

La respuesta del comando tendrá un aspecto similar al siguiente:

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

AWS IoT crea el índice la primera vez que indexa. No se puede consultar el índice si indexStatus es BUILDING.

Consulta de un índice de grupo de objetos

Para consultar los datos del índice, utilice el comando de la CLI search-index:

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

Autorización

Puede especificar el índice de grupos de cosas como un ARN de recurso en una acción de AWS IoT política, de la siguiente manera.

Acción	Recurso
iot:SearchIndex	El ARN de un índice (por ejemplo, arn:aws:iot:your-aws-region:index/AWS_ThingGroups).
iot:DescribeIndex	El ARN de un índice (por ejemplo, arn:aws:iot:your-aws-region:index/AWS_ThingGroups).