配置数据源 (Amazon CLI) - Amazon IoT SiteWise
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

配置数据源 (Amazon CLI)

可以使用 Amazon IoT SiteWise API 和 Amazon Command Line Interface 将源添加到网关。可以在网关功能中定义源。网关功能表示在网关上运行的软件功能,例如用于从 OPC-UA 源收集工业数据的功能。

网关功能具有以下组件:

  • 配置 — 定义某项功能的所有数据源的 JSON 文档。

  • 命名空间 — 标识功能的类型和版本的唯一字符串。例如,OPC-UA 源功能命名空间为 iotsitewise:opcuacollector:version,其中 version 是 OPC-UA 功能的版本。所有 OPC-UA 源都在具有此命名空间的某项功能中进行定义。

  • 同步状态 — 一种状态,用于指示Amazon云和网关之间是否同步了某项功能。同步状态可以是下列项之一:

    • IN_SYNC— 网关正在运行功能配置。

    • OUT_OF_SYNC— 网关尚未收到功能配置。

    • SYNC_FAILED— 网关拒绝功能配置。

    更新功能配置后,其同步状态为 OUT_OF_SYNC,直到网关收到并应用或拒绝更新的配置为止。

使用以下操作可查询和更新网关源和功能配置:

  • DescribeGateway— 检索有关特定网关的信息。响应包括功能摘要列表,其中包括功能命名空间。

  • DescribeGatewayCapabilityConfiguration— 检索特定功能的配置。使用此操作可检索要更新的功能配置。

  • ListGateways— 列出有关所有网关的信息。响应包括每个网关的功能摘要列表,其中包括功能命名空间。

  • UpdateGatewayCapabilityConfiguration— 更新网关功能配置或定义新的功能配置。此操作将按功能命名空间标识功能。如果提供的命名空间已存在,则此操作将更新该命名空间的功能。否则,此操作将创建新的功能。

    警告

    UpdateGatewayCapabilityConfiguration操作使用您在有效负载中提供的配置覆盖现有功能配置。要避免删除功能的配置,您必须在更新功能时将其配置添加到现有配置。