本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

管理物件群組索引

AWS_ThingGroups 是包含所有物件群組的索引。您可以使用此索引，根據群組名稱、描述、屬性和所有父系群組名稱搜尋群組。

啟用物件群組索引

您可以使用 UpdateIndexingConfigurationAPI 中的thing-group-indexing-configuration設定來建立索AWS_ThingGroups引並控制其設定。您可以使用 GetIndexingConfigurationAPI 擷取目前的索引設定。

若要更新物件群組索引的組態，請執行 update-indexing-configuration CLI 命令：

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

您也能以如下命令更新物件和物件群組索引的組態：

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

以下是 thingGroupIndexingMode 的有效值。

若要擷取目前物件和物件群組索引組態，請執行 get-indexing-configuration CLI 命令：

aws iot get-indexing-configuration

命令的回應如下所示：

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

描述群組索引

若要擷取 describe-index 索引的目前狀態，請使用 AWS_ThingGroups CLI 命令：

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

命令的回應如下所示：

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

AWS IoT 第一次建立索引時建立索引。若 indexStatus 為 BUILDING，您無法在該索引內進行查詢。

查詢物件群組索引

若要查詢索引中的資料，請使用 search-index CLI 命令：

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

授權

您可以在 AWS IoT 原則動作中將物群組索引指定為資源 ARN，如下所示。