终止支持通知：2026 年 10 月 7 日， AWS 将停止对的支持。 AWS IoT Greengrass Version 1 2026 年 10 月 7 日之后，您将无法再访问这些 AWS IoT Greengrass V1 资源。如需了解更多信息，请访问[迁移自 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)。 本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 物联网 SiteWise 连接器 物联网 SiteWise 连接器将本地设备和设备数据发送到中的资产属性 AWS IoT SiteWise。您可以使用此连接器从多台 OPC-UA 服务器收集数据并将其发布到 IoT。 SiteWise连接器将数据发送到当前 AWS 账户 和区域中的资产属性。 **注意** 物联网 SiteWise 是一项完全托管的服务，用于收集、处理和可视化来自工业设备和设备的数据。您可以配置资产属性，以处理从此连接器发送到资产的测量属性的原始数据。例如，您可以定义将设备的摄氏温度数据点转换为华氏度的转换属性，也可以定义计算平均每小时温度的指标属性。有关更多信息，请参阅《AWS IoT SiteWise 用户指南》**中的[什么是 AWS IoT SiteWise？](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/)。 连接器 SiteWise 使用从 OPC-UA 服务器发送的 OPC-UA 数据流路径向物联网发送数据。例如，数据流路径 `/company/windfarm/3/turbine/7/temperature` 可能表示风电场 \$13 中涡轮机 \$17 的温度传感器。如果内 AWS IoT Greengrass 核失去与互联网的连接，连接器会缓存数据，直到它能够成功连接到 AWS 云。您可以配置用于缓存数据的最大磁盘缓冲区大小。如果缓存大小超过最大磁盘缓冲区大小，则连接器会丢弃队列中最旧的数据。 [配置和部署 IoT SiteWise 连接器后，可以在物联网控制台中添加网关和 OPC-UA 源。 SiteWise ](https://console.aws.amazon.com/iotsitewise/)在控制台中配置源时，您可以筛选物联 SiteWise 网连接器发送的 OPC-UA 数据流路径或添加前缀。有关完成网关和来源设置的说明，请参阅《*AWS IoT SiteWise 用户指南*》中的[添加网关](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-gateway.html#add-gateway)。 IoT 仅从您映射到物联网 SiteWise 资产测量属性的数据流中 SiteWise 接收数据。要将数据流映射到资产属性，您可以将属性的别名设置为等效于 OPC-UA 数据流路径。要了解如何定义资产模型和创建资产，请参阅《*AWS IoT SiteWise 用户指南*》中的[工业资产建模](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/industrial-asset-models)。 **注意** 您可以使用流管理器将数据 SiteWise 从 OPC-UA 服务器以外的来源上传到 IoT。流管理器还为持久性和带宽管理提供可自定义的支持。有关更多信息，请参阅 [管理 AWS IoT Greengrass 核心上的数据流](stream-manager.md)。 此连接器在[无容器](lambda-group-config.md#no-container-mode)隔离模式下运行，因此，您可以将其部署到在 Docker 容器中运行的 Greengrass 组。 此连接器具有以下版本。 | 版本 | 进行筛选 | | --- | --- | | 12（推荐） | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/12` | | 11 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11` | | 10 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/10` | | 9 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/9` | | 8 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/8` | | 7 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/7` | | 6 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/6` | | 5 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/5` | | 4 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/4` | | 3 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/3` | | 2 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/2` | | 1 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/1` | 有关版本更改的信息，请参阅[更改日志](#iot-sitewise-connector-changelog)。 ## 要求 此连接器具有以下要求： ------ #### [ Version 9, 10, 11, and 12 ] **重要** [此版本引入了新的要求： AWS IoT Greengrass 核心软件 v1.10.2 和直播管理器。](stream-manager.md) + AWS IoT Greengrass 核心软件 v1.10.2。 + Greengrass 组上启用的[流管理器](stream-manager.md) 。 + Java 8 安装在核心设备上并已添加到 PATH 环境变量中。 + 此连接器只能在同时支持两者[AWS IoT Greengrass](https://docs.aws.amazon.com/general/latest/gr/greengrass.html)以及[物联 SiteWise](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html)网的 Amazon Web Services 区域中使用。 + 将 IAM policy 添加到 Greengrass 组角色。该角色允许 AWS IoT Greengrass 群组访问目标根资产及其子项的`iotsitewise:BatchPutAssetPropertyValue`操作，如以下示例所示。您可以`Condition`从策略中移除，以允许连接器访问您的所有 IoT SiteWise 资产。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] } ``` ------ 有关更多信息，请参阅 *IAM 用户指南*中的[添加和删除 IAM policy](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)。 ------ #### [ Versions 6, 7, and 8 ] **重要** [此版本引入了新的要求： AWS IoT Greengrass 核心软件 v1.10.0 和直播管理器。](stream-manager.md) + AWS IoT Greengrass 核心软件 v1.10.0。 + Greengrass 组上启用的[流管理器](stream-manager.md) 。 + Java 8 安装在核心设备上并已添加到 PATH 环境变量中。 + 此连接器只能在同时支持两者[AWS IoT Greengrass](https://docs.aws.amazon.com/general/latest/gr/greengrass.html)以及[物联 SiteWise](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html)网的 Amazon Web Services 区域中使用。 + 将 IAM policy 添加到 Greengrass 组角色。该角色允许 AWS IoT Greengrass 群组访问目标根资产及其子项的`iotsitewise:BatchPutAssetPropertyValue`操作，如以下示例所示。您可以`Condition`从策略中移除，以允许连接器访问您的所有 IoT SiteWise 资产。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] } ``` ------ 有关更多信息，请参阅 *IAM 用户指南*中的[添加和删除 IAM policy](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)。 ------ #### [ Version 5 ] + AWS IoT Greengrass 核心软件 v1.9.4。 + Java 8 安装在核心设备上并已添加到 PATH 环境变量中。 + 此连接器只能在同时支持两者[AWS IoT Greengrass](https://docs.aws.amazon.com/general/latest/gr/greengrass.html)以及[物联 SiteWise](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html)网的 Amazon Web Services 区域中使用。 + 将 IAM policy 添加到 Greengrass 组角色。该角色允许 AWS IoT Greengrass 群组访问目标根资产及其子项的`iotsitewise:BatchPutAssetPropertyValue`操作，如以下示例所示。您可以`Condition`从策略中移除，以允许连接器访问您的所有 IoT SiteWise 资产。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] } ``` ------ 有关更多信息，请参阅 *IAM 用户指南*中的[添加和删除 IAM policy](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)。 ------ #### [ Version 4 ] + AWS IoT Greengrass 核心软件 v1.10.0。 + Java 8 安装在核心设备上并已添加到 PATH 环境变量中。 + 此连接器只能在同时支持两者[AWS IoT Greengrass](https://docs.aws.amazon.com/general/latest/gr/greengrass.html)以及[物联 SiteWise](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html)网的 Amazon Web Services 区域中使用。 + 将 IAM policy 添加到 Greengrass 组角色。该角色允许 AWS IoT Greengrass 群组访问目标根资产及其子项的`iotsitewise:BatchPutAssetPropertyValue`操作，如以下示例所示。您可以`Condition`从策略中移除，以允许连接器访问您的所有 IoT SiteWise 资产。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] } ``` ------ 有关更多信息，请参阅 *IAM 用户指南*中的[添加和删除 IAM policy](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)。 ------ #### [ Version 3 ] + AWS IoT Greengrass 核心软件 v1.9.4。 + Java 8 安装在核心设备上并已添加到 PATH 环境变量中。 + 此连接器只能在同时支持两者[AWS IoT Greengrass](https://docs.aws.amazon.com/general/latest/gr/greengrass.html)以及[物联 SiteWise](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html)网的 Amazon Web Services 区域中使用。 + 将 IAM policy 添加到 Greengrass 组角色。该角色允许 AWS IoT Greengrass 群组访问目标根资产及其子项的`iotsitewise:BatchPutAssetPropertyValue`操作，如以下示例所示。您可以`Condition`从策略中移除，以允许连接器访问您的所有 IoT SiteWise 资产。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] } ``` ------ 有关更多信息，请参阅 *IAM 用户指南*中的[添加和删除 IAM policy](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)。 ------ #### [ Versions 1 and 2 ] + AWS IoT Greengrass 核心软件 v1.9.4。 + Java 8 安装在核心设备上并已添加到 PATH 环境变量中。 + 此连接器只能在同时支持两者[AWS IoT Greengrass](https://docs.aws.amazon.com/general/latest/gr/greengrass.html)以及[物联 SiteWise](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html)网的 Amazon Web Services 区域中使用。 + 已添加到 Greengrass 组角色的 IAM 策略，该策略 AWS IoT Core 允许访问目标根资产及其子项并`iotsitewise:BatchPutAssetPropertyValue`对其执行操作，如以下示例所示。您可以`Condition`从策略中移除，以允许连接器访问您的所有 IoT SiteWise 资产。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } }, { "Effect": "Allow", "Action": [ "iot:Connect", "iot:DescribeEndpoint", "iot:Publish", "iot:Receive", "iot:Subscribe" ], "Resource": "*" } ] } ``` ------ 有关更多信息，请参阅《 IAM 用户指南》**中的[添加和删​​除 IAM 身份权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)。 ------ ## Parameters ------ #### [ Versions 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, and 12 ] `SiteWiseLocalStoragePath` IoT SiteWise 连接器可以向其写入永久数据的 AWS IoT Greengrass 主机上的目录。默认值为 `/var/sitewise`。 AWS IoT 控制台中的显示名称：**本地存储路径** 必需：`false` 类型：`string` 有效模式：`^\s*$|\/.` `AWSSecretsArnList` 密钥列表，其中每个密钥都 AWS Secrets Manager 包含一个 OPC-UA 用户名和密码键值对。每个秘密都必须是密钥值对类型秘密。 在 AWS IoT 控制台中显示名称：**OPC- username/password U ARNs A 密钥列表** 必需：`false` 类型：`JsonArrayOfStrings` 有效模式：`\[( ?,? ?\"(arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+\/)*[a-zA-Z0-9\/_+=,.@\\-]+-[a-zA-Z0-9]+)*\")*\]` `MaximumBufferSize` 物联网 SiteWise 磁盘使用量的最大大小（以 GB 为单位）。默认值为 10GB。 AWS IoT 控制台中的显示名称：**最大磁盘缓冲区大小** 必需：`false` 类型：`string` 有效模式：`^\s*$|[0-9]+` ------ #### [ Version 1 ] `SiteWiseLocalStoragePath` IoT SiteWise 连接器可以向其写入永久数据的 AWS IoT Greengrass 主机上的目录。默认值为 `/var/sitewise`。 AWS IoT 控制台中的显示名称：**本地存储路径** 必需：`false` 类型：`string` 有效模式：`^\s*$|\/.` `SiteWiseOpcuaUserIdentityTokenSecretArn` 其中的密钥包 AWS Secrets Manager 含 OPC-UA 用户名和密码键值对。此密钥必须是密钥值对类型密钥。 AWS IoT 控制台中的显示名称：OPC-UA 密钥**的 ARN username/password ** 必需：`false` 类型：`string` 有效模式：`^$|arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+/)*[a-zA-Z0-9/_+=,.@\\-]+-[a-zA-Z0-9]+` `SiteWiseOpcuaUserIdentityTokenSecretArn-ResourceId` AWS IoT Greengrass 组中引用 OPC-UA 用户名和密码密钥的密钥资源。 AWS IoT 控制台中的显示名称：**OPC-UA 密钥资源 username/password ** 必需：`false` 类型：`string` 有效模式：`^$|.+` `MaximumBufferSize` 物联网 SiteWise 磁盘使用量的最大大小（以 GB 为单位）。默认值为 10GB。 AWS IoT 控制台中的显示名称：**最大磁盘缓冲区大小** 必需：`false` 类型：`string` 有效模式：`^\s*$|[0-9]+` ------ ### 创建连接器示例 (AWS CLI) 以下 AWS CLI 命令`ConnectorDefinition`使用包含 IoT SiteWise 连接器的初始版本创建一个。 ``` aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{ "Connectors": [ { "Id": "MyIoTSiteWiseConnector", "ConnectorArn": "arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11" } ] }' ``` **注意** 此连接器中的 Lambda 函数的生命周期[很长](lambda-functions.md#lambda-lifecycle)。 在 AWS IoT Greengrass 控制台中，您可以从群组的 “连接器” 页面添加**连接器**。有关更多信息，请参阅 [Greengrass 连接器入门（控制台）](connectors-console.md)。 ## 输入数据 该连接器不接受 MQTT 消息作为输入数据。 ## 输出数据 此连接器不发布 MQTT 消息作为输出数据。 ## 限制 此连接器受物联网施加的以下所有限制 SiteWise，包括以下限制。有关更多信息，请参阅 *AWS 一般参考* 中的 [AWS IoT SiteWise 端点和配额](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html)。 + 每个 AWS 账户的最大网关数量。 + 每个网关的 OPC-UA 源的最大数量。 + 存储的 timestamp-quality-value (TQV) 数据点的最大速率。 AWS 账户 + 每个资产属性存储的 TQV 数据点的最大速率。 ## 许可证 ------ #### [ Version 9, 10, 11, and 12 ] 物联网 SiteWise 连接器包括以下第三方软件/许可： + [MapDB](https://github.com/jankotek/mapdb/blob/master/LICENSE.txt) + [Elsa](https://github.com/jankotek/elsa/blob/master/LICENSE.txt) + [Eclipse Milo](https://github.com/eclipse/milo/blob/maintenance/0.2/LICENSE) 该连接器在 [Greengrass Core 软件许可协议](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)下发布。 ------ #### [ Versions 6, 7, and 8 ] 物联网 SiteWise 连接器包括以下第三方软件/许可： + [Milo](https://github.com/eclipse/milo/) / EDL 1.0 该连接器在 [Greengrass Core 软件许可协议](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)下发布。 ------ #### [ Versions 1, 2, 3, 4, and 5 ] 物联网 SiteWise 连接器包括以下第三方软件/许可： + [Milo](https://github.com/eclipse/milo/) / EDL 1.0 + [Chronicle-Queue](https://github.com/OpenHFT/Chronicle-Queue) / Apache 许可证 2.0 该连接器在 [Greengrass Core 软件许可协议](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)下发布。 ------ ## 更改日志 下表介绍每个版本连接器的更改。 | 版本 | 更改 | 日期 | | --- | --- | --- | | 12 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/greengrass/v1/developerguide/iot-sitewise-connector.html) | 2021 年 12 月 22 日 | | 11 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/greengrass/v1/developerguide/iot-sitewise-connector.html) | 2021 年 3 月 24 日 | | 10 | 配置了 `StreamManager`，以改进源连接丢失并重新建立时的处理能力。当没有可用的 `SourceTimestamp` 时，此版本也接受 OPC-UA 值的 `ServerTimestamp`。 | 2021 年 1 月 22 日 | | 9 | 支持自定义 Greengrass `StreamManager` 流目标、OPC-UA 死区、自定义扫描模式和自定义扫描速率。还包括在从 IoT SiteWise 网关进行配置更新期间提高性能。 | 2020 年 12 月 15 日 | | 8 | 提高了连接器遇到间歇性网络连接时的稳定性。 | 2020 年 11 月 19 日 | | 7 | 修复了网关指标的问题。 | 2020 年 8 月 14 日 | | 6 | 增加了对 CloudWatch 指标和自动发现新 OPC-UA 标签的支持。此版本需要[直播管理器和](stream-manager.md) AWS IoT Greengrass 核心软件 v1.10.0 或更高版本。 | 2020 年 4 月 29 日 | | 5 | 修复了 AWS IoT Greengrass 核心软件 v1.9.4 的兼容性问题。 | 2020 年 2 月 12 日 | | 4 | 修复了 OPC-UA 服务器重新连接的问题。 | 2020 年 2 月 7 日 | | 3 | 已删除 `iot:*` 权限要求。 | 2019 年 12 月 17 日 | | 2 | 新增对多个 OPC-UA 秘密资源的支持。 | 2019 年 12 月 10 日 | | 1 | 初始版本。 | 2019 年 12 月 2 日 | Greengrass 组在一个时间上只能包含一个版本的连接器。有关升级连接器版本的信息，请参阅[升级连接器版本](connectors.md#upgrade-connector-versions)。 ## 另请参阅 + [使用 Greengrass 连接器与服务和协议集成](connectors.md) + [Greengrass 连接器入门（控制台）](connectors-console.md) + [Greengrass 连接器入门 (CLI)](connectors-cli.md) + 请参阅 *AWS IoT SiteWise 用户指南* 中的以下主题： + [什么是 AWS IoT SiteWise？](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/) + [使用网关](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateway-connector.html) + [网关 CloudWatch 指标](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-cloudwatch-metrics.html#gateway-metrics) + [对物联网网 SiteWise 关进行故障排除](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshooting.html#troubleshooting-gateway)