翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

モノのグループのインデックス作成の管理

AWS_ThingGroups は、すべてのモノのグループが含まれるインデックスです。このインデックスを使用して、グループ名、説明、属性、すべての親グループ名に基づいてグループを検索することができます。

モノのグループのインデックス作成の有効化

の thing-group-indexing-configuration設定を使用してAWS_ThingGroupsインデックスUpdateIndexingConfigurationAPIを作成し、その設定を制御できます。を使用してGetIndexingConfigurationAPI、現在のインデックス作成設定を取得できます。

モノのグループのインデックス作成設定を更新するには、 update-indexing-configuration CLI コマンドを実行します。

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

次のように、1 つのコマンドでモノとモノのグループのインデックス作成の両方の設定を更新することもできます。

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"
    }
}

グループインデックスの説明

AWS_ThingGroups インデックスの現在のステータスを取得するには、 describe-index 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*"

Authorization

次のように、 AWS IoT ポリシーアクションARNでモノのグループのインデックスをリソースとして指定できます。