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

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

設定資料來源 (AWS CLI)

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

SiteWise 邊緣閘道功能具有下列元件:

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

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

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

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

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

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

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

使用下列作業查詢和更新 SiteWise Edge 閘道來源和功能組態:

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

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

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

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

    警告

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