As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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 no UpdateIndexingConfigurationAPIpara criar o AWS_ThingGroups índice e controlar sua configuração. Você pode usar o GetIndexingConfigurationAPIpara recuperar a configuração de indexação atual.

Para atualizar as configurações de indexação de grupos de coisas, execute o update-indexing-configuration CLI comando:

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.

Para recuperar as configurações atuais de indexação de coisas e grupos de coisas, execute o comando: get-indexing-configuration 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 AWS_ThingGroups índice, use o describe-index CLI comando:

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

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 recurso ARN em uma ação AWS IoT política, da seguinte maneira.