Gerenciamento da indexação de grupos de objetos

AWS_ThingGroups é o índice que contém todos os seus grupos de objetos. Você pode usar esse índice para pesquisar grupos com base no nome do grupo, na descrição, nos atributos e em todos os nomes de grupo pai.

Habilitar a indexação de grupos de objetos

Você pode usar a thing-group-indexing-configuration configuração na UpdateIndexingConfigurationAPI para criar o AWS_ThingGroups índice e controlar sua configuração. Você pode usar a GetIndexingConfigurationAPI para recuperar a configuração de indexação atual.

Use o comando update-indexing-configuration da CLI para atualizar as configurações da indexação de grupos de objetos:

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

Você também pode atualizar configurações para a indexação de objetos e grupos de objetos em um único comando, como mostrado a seguir:

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

Estes são valores válidos para thingGroupIndexingMode.

DESL.

Sem indexing/delete índice.

ON

Criar ou configurar o índice AWS_ThingGroups.

Para recuperar as configurações atuais de indexação de objetos e grupos de objetos, execute o comando get-indexing-configuration da CLI:

aws iot get-indexing-configuration

A resposta do comando é semelhante a:

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

Descrever índices de grupos

Para recuperar o status atual do índice AWS_ThingGroups, use o comando describe-index da CLI:

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

A resposta do comando é semelhante a:

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

AWS IoT cria seu índice na primeira vez que você indexa. Você não pode consultar o índice se o indexStatus é BUILDING.

Consultar um índice de grupos de objetos

Para consultar dados no índice, use o comando search-index da CLI:

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

Autorização

Você pode especificar o índice de grupos de coisas como um ARN de recurso em uma ação de AWS IoT política, da seguinte maneira.

Ação	Recurso
iot:SearchIndex	O ARN de um índice (por exemplo, arn:aws:iot:your-aws-region:index/AWS_ThingGroups).
iot:DescribeIndex	O ARN de um índice (por exemplo, arn:aws:iot:your-aws-region:index/AWS_ThingGroups).