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

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

管理机群指标

本主题介绍如何使用 Amazon IoT 控制台和 Amazon CLI 来管理您的机群指标。

管理机群指标 (控制台)

以下部分介绍如何使用 Amazon IoT 控制台来管理您的实例集指标。在创建机群指标之前，请确保您已使用关联的数据源和配置启用了机群索引。

启用机群索引

如果您已经启用了机群索引，请跳过此部分。

如果还没有启用机群索引，请按照以下说明操作。

创建机群指标

成功创建后，机群指标页面会列出机群指标。

更新机群指标

删除机群指标

管理机群指标 (CLI)

以下部分介绍如何使用 Amazon CLI 来管理您的实例集指标。在创建机群指标之前，请确保您已使用关联的数据源和配置启用了机群索引。要为您的事物或事物组启用机群索引，请按照管理事物索引或管理事物组索引中的说明操作。

创建机群指标

您可以使用 create-fleet-metric CLI 命令创建实例集指标。

aws iot create-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 60 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum

此命令的输出包含机群指标的名称和 Amazon Resource Name (ARN)。输出内容如下所示：

{
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "metricName": "YourFleetMetricName"
}

列出机群指标

您可以使用 list-fleet-metric CLI 命令列出账户中的所有实例集指标。

aws iot list-fleet-metrics

此命令的输出包含所有机群指标。输出内容如下所示：

{
    "fleetMetrics": [
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric1", 
            "metricName": "YourFleetMetric1"
        }, 
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric2", 
            "metricName": "YourFleetMetric2"
        }
    ]
}

描述机群指标

您可以使用 describe-fleet-metric CLI 命令显示有关实例集指标的更详细信息。

aws iot describe-fleet-metric --metric-name "YourFleetMetricName"

此命令输出包含有关指定机群指标的详细信息。输出内容如下所示：

{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625790642.355, 
    "queryString": "*", 
    "period": 60, 
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "aggregationField": "registry.version", 
    "version": 1, 
    "aggregationType": {
        "values": [
            "sum"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625790642.355, 
    "metricName": "YourFleetMetricName"
}

更新机群指标

您可以使用 update-fleet-metric CLI 命令更新实例集指标。

aws iot update-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 120 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum,count --index-name AWS_Things

更新机群指标命令不会产生任何输出。您可以使用描述机群指标 CLI 命令查看结果。

{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625792300.881, 
    "queryString": "*", 
    "period": 120, 
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "aggregationField": "registry.version", 
    "version": 2, 
    "aggregationType": {
        "values": [
            "sum", 
            "count"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625792300.881, 
    "metricName": "YourFleetMetricName"
}

删除机群指标

使用 delete-fleet-metric CLI 命令删除实例集指标。

aws iot delete-fleet-metric --metric-name "YourFleetMetricName"

如果删除成功或者您指定的机群指标不存在，此命令将不产生任何输出。

有关更多信息，请参阅实例集指标故障排除。

授权对 IoT 资源进行标记

为了更好地控制您可以创建、修改或使用的实例集指标，可以在实例集指标上附加标签。

要标记使用 Amazon Web Services Management Console 或 Amazon CLI 创建的实例集指标，您必须在 IAM 策略中包含 iot:TagResource 操作以授予用户权限。如果您的 IAM 策略不包含 iot:TagResource，则创建带有标签的实例集指标的任何操作都将返回 AccessDeniedException 错误。

有关标记资源的更多一般信息，请参阅标记 Amazon IoT 资源。

IAM 策略示例

请参阅以下在创建实例集指标时授予标记权限的 IAM 策略示例：

{
	"Version": "2012-10-17",
	"Statement": [
		{
			"Action": [
				"iot:TagResource"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		},
		{
			"Action": [
				"iot:CreateFleetMetric"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:index/*",
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		}
	]
}

有关更多信息，请参阅用于 Amazon IoT 的操作、资源和条件键。