設定資料來源 (AWS CLI) - AWS IoT SiteWise

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

設定資料來源 (AWS CLI)

您可以使用 AWS IoT SiteWise API 和 AWS Command Line Interface 將來源新增至閘道。您可以在閘道功能中定義來源。閘道功能代表在閘道上執行的軟體功能,例如從 OPC-UA 來源收集工業資料的能力。

閘道功能包含下列元件:

  • 配置 — 定義功能所有資料來源的 JSON 文件。

  • 命名空間 — 識別功能類型和版本的唯一字串。例如,OPC-UA 來源功能命名空間是 iotsitewise:opcuacollector:version,其中 version 是 OPC-UA 功能的版本。所有 OPC-UA 來源都在具有此命名空間的單一功能中定義。

  • 同步處理狀態 — 指出功能是否在AWS雲端和閘道之間同步處理的狀態。同步狀態可以是下列其中之一:

    • IN_SYNC— 閘道正在執行功能組態。

    • OUT_OF_SYNC— 閘道尚未收到功能設定。

    • SYNC_FAILED— 閘道拒絕功能組態。

    更新功能組態後,其同步狀態會是 OUT_OF_SYNC,直到閘道收到並套用或拒絕更新的組態為止。

使用下列操作來查詢並更新您的閘道來源和功能組態:

  • DescribeGateway— 擷取有關特定閘道的資訊。回應包含功能摘要的清單,包括功能命名空間。

  • DescribeGatewayCapabilityConfiguration— 擷取特定權能的組態。使用此操作可擷取要更新的功能組態。

  • ListGateways— 列出所有閘道的相關資訊。回應包含每個閘道的功能摘要清單,包括功能命名空間。

  • UpdateGatewayCapabilityConfiguration— 更新閘道功能組態或定義新的功能組態。此操作會依功能命名空間來識別功能。如果您提供已存在的命名空間,此操作會針對該命名空間更新功能。否則,此操作會建立新的功能。

    警告

    UpdateGatewayCapabilityConfiguration作業會以您在承載中提供的組態覆寫現有的能力組態。若要避免刪除功能的組態,您必須在更新功能時新增至現有的組態。