Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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 usar el thing-group-indexing-configuration ajuste de UpdateIndexingConfigurationAPIpara crear el AWS_ThingGroups índice y controlar su configuración. Puede utilizar el GetIndexingConfigurationAPIpara recuperar la configuración de indexación actual.

Para actualizar las configuraciones de indexación de los grupos de cosas, ejecute el update-indexing-configuration CLI comando:

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.

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

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 AWS_ThingGroups índice, utilice el describe-index CLI comando:

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, usa el search-index CLI comando:

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

Autorización

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