将工业数据流映射到资产属性 - Amazon IoT SiteWise
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

将工业数据流映射到资产属性

您可以为任何类型的资产属性定义属性别名。这有助于您在摄取或检索资产数据时识别资产属性。如果资产具有测量值属性,您可以定义属性别名来将数据流映射到这些测量值属性。

此过程要求您知道属性别名。

属性别名在区域和 Amazon 账户中必须是唯一的。如果您将属性别名设置为另一个资产属性中已经存在的别名,则 Amazon IoT SiteWise 将返回错误。

如果您有多个具有相同数据流路径的 OPC-UA 源,则可以向每个源的路径添加一个前缀以形成唯一别名。有关更多信息,请参见 配置数据源

设置属性别名(控制台)

您可以使用 Amazon IoT SiteWise 控制台为资产属性设置别名。

设置属性别名(控制台)
  1. 导航到 Amazon IoT SiteWise 控制台

  2. 在导航窗格中,选择 Assets (资产)

  3. 选择要为其设置属性别名的资产。

    提示

    您可以选择箭头图标来展开资产层次结构以查找资产。

  4. 选择编辑

  5. 查找要为其设置别名的属性,然后输入属性别名。

    
                        Amazon IoT SiteWise“编辑资产”页面屏幕截图,其中突出显示了属性别名。
  6. 选择保存

设置属性别名 (Amazon CLI)

您可以使用 Amazon Command Line Interface (Amazon CLI) 为资产属性设置别名。

您必须知道资产的 assetId 和属性的 propertyId 才能完成此过程。您也可以使用外部 ID。如果您创建了资产但不知道该资产assetId,请使用 ListAssetsAPI 查看特定模型的所有资产。然后,使用该DescribeAsset操作查看资产的属性,包括属性 ID。

要将数据流映射到资产的属性,请使用UpdateAssetProperty操作。指定以下参数:

  • assetId— 资产的 ID 或外部 ID。有关更多信息,请参阅《Amazon IoT SiteWise 用户指南》中的 使用外部 ID 引用对象

  • propertyId— 资产属性的 ID 或外部 ID。

  • propertyAlias – 数据流到属性别名的路径。

  • propertyNotificationState – 属性值通知状态:ENABLEDDISABLED。在更新属性别名时指定属性的现有通知状态。您可以通过DescribeAssetProperty操作检索现有的通知状态。

    如果省略此参数,则新通知状态为 DISABLED。有关属性通知的更多信息,请参阅与其他 Amazon 服务交互

要设置属性别名 (Amazon CLI)
  1. 运行以下命令以检索属性的当前通知状态。将 asset-idproperty-id 替换为资产属性的 ID。

    aws iotsitewise describe-asset-property \ --asset-id asset-id \ --property-id property-id

    此操作将按以下格式返回包含资产属性的详细信息的响应。属性通知状态位于 JSON 对象的 assetProperty.notification.state 中。

    { "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "assetName": "Wind Turbine 7", "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "assetProperty": { "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", "name": "Wind Speed", "notification": { "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", "state": "ENABLED" }, "dataType": "DOUBLE", "unit": "m/s", "type": { "measurement": {} } } }
  2. 运行以下命令以设置资产属性的别名。将 property-alias 替换为属性别名,将 notification-state 替换为通知状态,或者省略 --property-notification-state 以禁用通知。您可以选择使用新单位更新资产的单位,以及 --property-unit

    aws iotsitewise update-asset-property \ --asset-id asset-id \ --property-id property-id \ --property-alias property-alias \ --property-notification-state notification-state \ --property-unit unit
  3. 要验证是否已设置别名,请运行以下命令来检索属性的详细信息。将 asset-idproperty-id 替换为资产属性的 ID。

    aws iotsitewise describe-asset-property \ --asset-id asset-id \ --property-id property-id

    此操作将按以下格式返回包含资产属性的详细信息的响应。属性别名 assetProperty.alias 在 JSON 对象中,在本示例中设置为 myAlias

    { "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "assetName": "Wind Turbine 7", "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "assetProperty": { "alias": "myAlias", "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", "name": "Wind Speed", "notification": { "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", "state": "ENABLED" }, "dataType": "DOUBLE", "unit": "m/s", "type": { "measurement": {} } } }