要求参数输入数据输出数据限制许可证更改日志另请参阅

IoT SiteWise 连接器

IoT SiteWise 连接器将本地设备和设备数据发送到Amazon IoT SiteWise. 您可以使用此连接器从多个 OPC-UA 服务器收集数据并将其发布到 IoT SiteWise。连接器将数据发送到当前的资产属性。Amazon Web Services 账户和区域。

注意

IoT SiteWise 是一项完全托管的服务，可收集、处理和可视化来自工业设备和装置的数据。您可以配置资产属性，以处理从此连接器发送到资产的测量属性的原始数据。例如，您可以定义将设备的摄氏温度数据点转换为华氏度的转换属性，也可以定义计算平均每小时温度的指标属性。有关更多信息，请参阅 Amazon IoT SiteWise 用户指南的什么是 Amazon IoT SiteWise？。

连接器将数据发送到 IoT SiteWise 使用从 OPC-UA 服务器发送的 OPC-UA 数据流路径。例如，数据流路径 /company/windfarm/3/turbine/7/temperature 可能表示风电场 #3 中涡轮机 #7 的温度传感器。如果Amazon IoT GreengrassCore 丢失与 Internet 的连接，连接器将缓存数据，直到它能够成功连接到Amazon Web Services 云. 您可以配置用于缓存数据的最大磁盘缓冲区大小。如果缓存大小超过最大磁盘缓冲区大小，则连接器会丢弃队列中最旧的数据。

配置和部署 IoT 后 SiteWise 连接器，您可以在IoT SiteWise 控制台. 在控制台中配置源时，可以筛选 IoT 发送的 OPC-UA 数据流路径或为其添加前缀。 SiteWise 连接器。有关完成设置网关和源的说明，请参阅。添加网关中的Amazon IoT SiteWise用户指南.

IoT SiteWise 仅接收来自已映射到 IoT 测量属性的数据流的数据。 SiteWise 资产。要将数据流映射到资产属性，您可以将属性的别名设置为等效于 OPC-UA 数据流路径。要了解如何定义资产模型和创建资产，请参阅工业资产建模中的Amazon IoT SiteWise用户指南.

注意

你可以使用直播管理器将数据上传到 IoT SiteWise 来自 OPC-UA 服务器以外的来源。Stream Manager 还为持久性和带宽管理提供可自定义的支持。有关更多信息，请参阅在 Amazon IoT Greengrass 核心上管理数据流。

此连接器运行于无容器隔离模式，因此，您可以将其部署到 Docker 容器中运行的 Greengrass 组。

此连接器具有以下版本。

版本	ARN
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`

有关版本更改的信息，请参阅更改日志。

要求

此连接器具有以下要求：

Version 9, 10, 11, and 12

重要

此版本引入了新的要求：Amazon IoT Greengrass核心软件 v1.10.2 和流管理器.

Amazon IoT Greengrass核心软件 v1.10.2。
Greengrass 组上启用的流管理器。
已安装在核心设备上并添加到 PATH 环境变量中。
此连接器只能在 Amazon Web Services 区域中使用。Amazon IoT Greengrass和IoT SiteWise支持。

将 IAM 策略添加到 Greengrass 组角色。此角色允许 Amazon IoT Greengrass 组对目标 root 资产及其子级执行 iotsitewise:BatchPutAssetPropertyValue 操作，如以下示例所示。您可以删除Condition从策略允许连接器访问您的所有 IoT SiteWise 资产。


{
    "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 用户指南.

Versions 6, 7, and 8

重要

此版本引入了新的要求：Amazon IoT Greengrass核心软件 v1.10.0 和流管理器.

Amazon IoT Greengrass核心软件 v1.10.0。
Greengrass 组上启用的流管理器。
已安装在核心设备上并添加到 PATH 环境变量中。
此连接器只能在 Amazon Web Services 区域中使用。Amazon IoT Greengrass和IoT SiteWise支持。


{
    "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 用户指南.

Version 5

Amazon IoT Greengrass核心软件 v1.9.4。
已安装在核心设备上并添加到 PATH 环境变量中。
此连接器只能在 Amazon Web Services 区域中使用。Amazon IoT Greengrass和IoT SiteWise支持。


{
    "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 用户指南.

Version 4

Amazon IoT Greengrass核心软件 v1.10.0。
已安装在核心设备上并添加到 PATH 环境变量中。
此连接器只能在 Amazon Web Services 区域中使用。Amazon IoT Greengrass和IoT SiteWise支持。


{
    "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 用户指南.

Version 3

Amazon IoT Greengrass核心软件 v1.9.4。
已安装在核心设备上并添加到 PATH 环境变量中。
此连接器只能在 Amazon Web Services 区域中使用。Amazon IoT Greengrass和IoT SiteWise支持。


{
    "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 用户指南.

Versions 1 and 2

Amazon IoT Greengrass核心软件 v1.9.4。
已安装在核心设备上并添加到 PATH 环境变量中。
此连接器只能在 Amazon Web Services 区域中使用。Amazon IoT Greengrass和IoT SiteWise支持。

添加到 Greengrass 组角色的 IAM 策略，允许访问Amazon IoT Core和iotsitewise:BatchPutAssetPropertyValue对目标 root 资产及其子级执行操作，如以下示例所示。您可以删除Condition从策略允许连接器访问您的所有 IoT SiteWise 资产。


{
    "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 用户指南.

参数

Versions 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, and 12

SiteWiseLocalStoragePath

上的目录Amazon IoT Greengrass主机那个 IoT SiteWise 连接器可以向写入持久性数据。默认值为 /var/sitewise。

在Amazon IoT控制台：本地存储路径

：必需false

类型：string

有效模式：^\s*$|\/.

AWSSecretsArnList

Amazon Secrets Manager 中的秘密列表，其中包含 OPC-UA 用户名和密码密钥值对。每个秘密都必须是密钥值对类型秘密。

在Amazon IoT控制台：OPC-UA 用户名/密码秘密的 ARN 列表

：必需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

IoT 的最大大小（以 GB 为单位） SiteWise 磁盘使用率。默认值为 10GB。

在Amazon IoT控制台：最大磁盘缓冲区大小

：必需false

类型：string

有效模式：^\s*$|[0-9]+

Version 1

SiteWiseLocalStoragePath

上的目录Amazon IoT Greengrass主机那个 IoT SiteWise 连接器可以向写入持久性数据。默认值为 /var/sitewise。

在Amazon IoT控制台：本地存储路径

：必需false

类型：string

有效模式：^\s*$|\/.

SiteWiseOpcuaUserIdentityTokenSecretArn

Amazon Secrets Manager 中的密钥，其中包含 OPC-UA 用户名和密码密钥值对。此密钥必须是密钥值对类型密钥。

在Amazon IoT控制台：：OPC-UA 用户名/密码密码密钥的 ARN

：必需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

Amazon IoT Greengrass 组中引用 OPC-UA 用户名和密码密钥的私有资源。

在Amazon IoT控制台：OPC-UA 用户名/密码密码密码资源

：必需false

类型：string

有效模式：^$|.+

MaximumBufferSize

IoT 的最大大小（以 GB 为单位） SiteWise 磁盘使用率。默认值为 10GB。

在Amazon IoT控制台：最大磁盘缓冲区大小

：必需false

类型：string

有效模式：^\s*$|[0-9]+

创建连接器示例 (Amazon CLI）

以下Amazon 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 函数有长时间生存生命周期。

在Amazon IoT Greengrass控制台，您可以从组中添加连接器连接器页. 有关更多信息，请参阅 Greengrass 连接器入门（控制台）。

输入数据

此连接器不接受 MQTT 消息作为输入数据。

输出数据

此连接器不会将 MQTT 消息作为输出数据发布。

限制

此连接器受 IoT SiteWise 施加的以下所有限制的约束，包括以下限制。有关更多信息，请参阅Amazon IoT SiteWise终端节点和配额中的Amazon一般参考.

每个最大网关数Amazon Web Services 账户.
每个网关的 OPC-UA 源的最大数量。
最大速率 timestamp-quality-value 每个存储的 (TQV) 数据点Amazon Web Services 账户.
每个资产属性存储的 TQV 数据点的最大速率。

许可证

更改日志

下表描述了连接器每一版的更改。

版本	更改	日期
12	此版本包含错误修复。	2021 年 12 月 22 日
11	Support 包含隐藏或不可打印字符的字符串。隐藏和不可打印的字符在将字符串发送到Amazon Web Services 云. 修复了导致 IoT 的问题 SiteWise 网关可无限重试无效请求。修复了在 IoT 时导致检查点损坏的问题 SiteWise 网关已连接到高频数据源。改进了错误消息以帮助排除网关配置故障。	2021 年 3 月 24 日
10	Configured`StreamManager`以改进源连接丢失并重新建立时的处理能力。此版本还接受 OPC-UA 值，带`ServerTimestamp`当不时`SourceTimestamp`可用。	2021 年 1 月 22 日
9	为自定义 Greengrass 启动了 Support`StreamManager`直播目标、OPC-UA 死带、自定义扫描模式和自定义扫描速率。还包括在 IoT 进行配置更新期间提高性能 SiteWise 网关。	2020 年 12 月 15 日
8	提高连接器遇到间歇性网络连接时的稳定性。	2020 年 11 月 19 日
7	修复了网关指标的问题。	2020 年 8 月 14 日
6	添加了对的支持 CloudWatch 指标和自动发现新 OPC-UA 标签。此版本需要流管理器和 Amazon IoT Greengrass Core 软件 v1.10.0 或更高版本。	2020 年 4 月 29 日
5	修复了与 Amazon IoT Greengrass Core 软件 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 组每次只能包含一个连接器。有关升级连接器版本的信息，请参阅升级连接器版本。

另请参阅

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

IoT 以太网 IP 协议适配器

Kinesis Firehose