要求參數輸入資料輸出資料限制授權變更記錄另請參閱

AWS IoT Greengrass Version 1 於 2023 年 6 月 30 日進入延長壽命階段。如需詳細資訊，請參閱 AWS IoT Greengrass V1 維護政策。在此日期之後， AWS IoT Greengrass V1 不會發佈提供功能、增強功能、錯誤修正或安全修補程式的更新。在上執行的裝置 AWS IoT Greengrass V1 不會中斷，並會繼續運作和連線至雲端。我們強烈建議您遷移至 AWS IoT Greengrass Version 2，這會新增重要的新功能，並支援其他平台。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

IoT SiteWise 接頭

IoT SiteWise 連接器會將本機裝置和設備資料傳送至中的資產屬性AWS IoT SiteWise。您可以使用此連接器從多個 OPC-UA 伺服器收集資料，並將其發佈到 IoT。 SiteWise連接器會將資料傳送至目前AWS 帳戶和區域中的資產屬性。

注意

IoT SiteWise 是一項全受管服務，可收集、處理和視覺化來自工業裝置和設備的資料。您可以設定資產屬性，以處理從此連接器傳送至資產測量內容的原始資料。例如，您可以定義一個將裝置的攝氏溫度資料點轉換為華氏溫度的轉換屬性，或者定義計算每小時平均溫度的指標屬性。如需詳細資訊，請參閱《AWS IoT SiteWise 使用者指南》中的什麼是 AWS IoT SiteWise？。

該連接器 SiteWise 使用從 OPC-UA 服務器發送的 OPC-UA 數據流路徑將數據發送到 IoT。例如，資料串流路徑 /company/windfarm/3/turbine/7/temperature 可能代表 3 號風力發電廠 7 號渦輪機的溫度感應器。如果AWS IoT Greengrass核心中斷與網際網路的連線，連接器會快取資料，直到它可以成功連線到AWS 雲端. 您可以設定用於快取資料的最大磁碟緩衝區大小。如果快取大小超過磁碟緩衝區大小上限，則連接器會捨棄佇列中最舊的資料。

設定並部署 IoT SiteWise 連接器之後，您可以在 IoT SiteWise 主控台中新增閘道和 OPC-UA 來源。在主控台中設定來源時，您可以篩選 IoT SiteWise 連接器傳送的 OPC-UA 資料串流路徑，或為其加上前綴。如需完成設定閘道和來源的指示，請參閱「AWS IoT SiteWise使用者指南」中的「新增閘道」。

IoT 只 SiteWise 會從已對應至 IoT 資產測量屬性的資料串流接收 SiteWise 資料。若要將資料串流對應至資產屬性，您可以將屬性的別名設定為和 OPC-UA 資料串流路徑相同。若要瞭解如何定義資產模型和建立資產，請參閱《AWS IoT SiteWise使用指南》中的〈塑型工業資產〉。

備註

您可以使用串流管理員將資料 SiteWise 從 OPC-UA 伺服器以外的來源上傳到 IoT。串流管理員還為持續性和頻寬管理提供可自訂的支援。如需詳細資訊，請參閱管理 AWS 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`

如需版本變更的詳細資訊，請參閱 Changelog。

要求

此連接器有下列要求：

Version 9, 10, 11, and 12

重要

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

AWS IoT Greengrass核心軟體
已在 Greengrass 群組上啟用串流管理員。
Java 8 已安裝在核心裝置上並已新增至 PATH 環境變數。
此連接器只能在同時支援AWS IoT Greengrass和 IoT 的 Amazon Web Services 區域中使 SiteWise用。

新增至 Greengrass 色群組角色的 IAM 政策。此角色允許 AWS IoT Greengrass 群組存取目標根資產及其子項上的 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

重要

此版本引進了新的要求：AWS IoT Greengrass Core 軟體 1.10.0 版和串流管理員。

AWS IoT Greengrass核心軟體
已在 Greengrass 群組上啟用串流管理員。
Java 8 已安裝在核心裝置上並已新增至 PATH 環境變數。
此連接器只能在同時支援AWS IoT Greengrass和 IoT 的 Amazon Web Services 區域中使 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

AWS IoT Greengrass核心軟體版本 1.9.4 版
Java 8 已安裝在核心裝置上並已新增至 PATH 環境變數。
此連接器只能在同時支援AWS IoT Greengrass和 IoT 的 Amazon Web Services 區域中使 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

AWS IoT Greengrass核心軟體
Java 8 已安裝在核心裝置上並已新增至 PATH 環境變數。
此連接器只能在同時支援AWS IoT Greengrass和 IoT 的 Amazon Web Services 區域中使 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

AWS IoT Greengrass核心軟體版本 1.9.4 版
Java 8 已安裝在核心裝置上並已新增至 PATH 環境變數。
此連接器只能在同時支援AWS IoT Greengrass和 IoT 的 Amazon Web Services 區域中使 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

AWS IoT Greengrass核心軟體版本 1.9.4 版
Java 8 已安裝在核心裝置上並已新增至 PATH 環境變數。
此連接器只能在同時支援AWS IoT Greengrass和 IoT 的 Amazon Web Services 區域中使 SiteWise用。

新增至 Greengrass 群組角色的 IAM 政策，允許對目標根資產AWS IoT Core及其子系進行存取及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/*"
                     ]
                 }
             }
        },
        {
            "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

IoT SiteWise 連接器可以寫入持續性資料的AWS IoT Greengrass主機上的目錄。預設為 /var/sitewise。

AWS IoT主控台中的顯示名稱：本機儲存區路徑

必要：false

類型：string

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

AWSSecretsArnList

AWS Secrets Manager 中的秘密清單，其中每個都包含 OPC-UA 使用者名稱和密碼金鑰/值對。每個秘密都必須是金鑰/值對類型的秘密。

AWS 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 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

必要：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 用戶名/密碼秘密資源

必要：false

類型：string

有效模式：^$|.+

MaximumBufferSize

IoT 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 函數具有較長的生命週期。

在AWS IoT Greengrass主控台中，您可以從群組的 [連接器] 頁面新增連接器。如需詳細資訊，請參閱 Greengrass 連接器入門 (主控台)。

輸入資料

此連接器不接受 MQTT 郵件作為輸入資料。

輸出資料

此連接器不會將 MQTT 郵件發佈為輸出資料。

限制

此連接器受到以下 IoT 施加的所有限制 SiteWise，包括以下內容。如需詳細資訊，AWS IoT SiteWise請參閱. AWS 一般參考

每個閘道的最大數目AWS 帳戶。
每個閘道的 OPC-UA 來源數目上限。
每個儲存的 timestamp-quality-value (TQV) 資料點的最大速率。AWS 帳戶
每個資產屬性儲存的 TQV 資料點最大速率。

授權

變更記錄

下表說明每個版本連接器的變更。

版本	改變	日期
12	此版本包含錯誤修復。	2021 年 12 月 22 日
11	Support 包含隱藏或不可打印字符的字符串。在字串傳送至之前，會自動移除隱藏和不可列印的AWS 雲端字元。修正造成 IoT SiteWise 閘道無限重試無效要求的問題。修正 IoT SiteWise 閘道連線至高頻率資料來源時造成檢查點損毀的問題。改善錯誤訊息，協助疑難排解閘道組態。	2021 年 3 月 24 日
10	設定`StreamManager`為改善來源連線遺失並重新建立時的處理。此版本也接受 OPC-UA 值，`ServerTimestamp`當沒有可用`SourceTimestamp`時。	2021 年 1 月 22 日
9	Support 自訂 Greengrass `StreamManager` 串流目的地、OPC-UA 結束、自訂掃描模式和自訂掃描速率。此外，還包括從 IoT SiteWise 閘道進行的組態更新期間提升的效能。	2020 年 12 月 15 日
8	改善連接器遇到間歇性網路連線時的穩定性。	2020 年 11 月 19 日
7	修正閘道指標的問題。	2020 年 8 月 14 日
6	添加了對 CloudWatch 指標的支持和新的 OPC-UA 標籤的自動發現。此版本需要使用串流管理員和 AWS IoT Greengrass Core 軟體 1.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 群組一次只能包含一個版本的連接器。若要取得有關升級連接器版本的資訊，請參閱升級連接器版本。

另請參閱

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

IoT 以太網 IP 協議適配器

Kinesis Firehose