Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

准备实例集索引

使用 Amazon IoT 队列索引，您可以使用名为 shadow ($package) 的预留名称来搜索和聚合数据。您还可以通过查询预留命名影子和动态 Amazon IoT 事物组对事物进行分组。例如，您可以找到有关哪些 Amazon IoT 内容使用特定的软件包版本、未安装特定的软件包版本或未安装任何软件包版本的信息。您可以通过组合属性来获得进一步的见解。例如，识别具有特定版本且属于特定事物类型的事物（例如版本 1.0.0 和事物类型 pump_sensor）。有关更多信息，请参阅实例集索引。

将 $package 影子设置为数据来源

要在软件包目录中使用实例集索引，必须启用实例集索引，将命名影子设置为数据来源，并将 $package 定义为命名影子筛选条件。如果您尚未启用实例集索引，则可以在此过程中将其启用。从控制台中的 Amazon IoT Core，打开设置，选择管理索引，然后依次选择添加命名影子、添加设备软件包和版本和更新。有关更多信息，请参阅管理事物索引。

或者，您可以在创建第一个软件包时启用实例集索引。出现为软件包管理启用依赖项对话框时，选择将设备软件包和版本作为数据来源添加到实例集索引的选项。通过选择此选项，还可以启用实例集索引。

控制台中显示的指标

在 Amazon IoT 控制台软件包详细信息页面上，Discovery 面板显示通过$package阴影获取的标准指标。

有关深入了解收集软件包版本分发的另一种方法，请参阅通过 getBucketsAggregation 收集软件包版本分发。

查询模式

对软件包目录实施实例集索引将使用大多数支持的特征（例如，术语和短语以及搜索字段），这些特征是实例集索引的标准特征。例外情况是，comparison 和 range 查询不可用于预留命名影子（$package）version 键。但是，这些查询可用于 attributes 键。有关更多信息，请参阅查询语法。

示例数据

注意：有关预留命名影子及其结构的信息，请参阅预留命名影子。

在此示例中，第一台设备命名为 AnyThing 并安装了以下软件包：

影子如下所示：

{
    "state": {
        "reported": {
            "SamplePackage": {
                "version": "1.0.0",
                "attributes": {
                    "s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
                    "packageID": "1111"
                    }
            }
        }
    }
}

第二台设备命名为 AnotherThing 并安装了以下软件包：

影子如下所示：

{
    "state": {
        "reported": {
            "SamplePackage": {
                "version": "1.0.0",
                "attributes": {
                    "s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
                    "packageID": "1111"
                }
            },
            "OtherPackage": {
                "version": "1.2.5",
                "attributes": {
                    "s3UrlForOtherPackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile2",
                    "packageID": "2222"
                    }
            },
        }
    }
}

示例查询

下表根据 AnyThing 和 AnotherThing 的示例设备影子列出了查询示例。有关更多信息，请参阅示例事物查询。

通过 getBucketsAggregation 收集软件包版本分发

除了 Amazon IoT 控制台中的发现面板外，您还可以使用 GetBucketsAggregationAPI 操作获取软件包版本分发信息。要获取软件包版本分发信息，必须执行以下操作：

有关更多信息，请参阅 Amazon IoT 舰队索引中的 “自定义字段” 部分。