配置阈值 (AWS CLI) - AWS IoT SiteWise

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

配置阈值 (AWS CLI)

您可以使用 AWS Command Line Interface (AWS CLI) 更新指定警报阈值的属性的值。

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

使用BatchPutAssetPropertyValue操作为您的资产分配属性值。您可以使用此操作一次设置多个属性。此操作的负载包含条目列表,每个条目都包含资产 ID、属性 ID 和属性值。

更新属性的值 (AWS CLI)
  1. 创建一个名为 batch-put-payload.json 的文件,并将以下 JSON 对象复制到该文件中。此示例负载演示如何设置风力涡轮机的纬度和经度。更新 ID、值和时间戳以修改用例的负载。

    { "entries": [ { "entryId": "windfarm3-turbine7-latitude", "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", "propertyValues": [ { "value": { "doubleValue": 47.6204 }, "timestamp": { "timeInSeconds": 1575691200 } } ] }, { "entryId": "windfarm3-turbine7-longitude", "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE", "propertyValues": [ { "value": { "doubleValue": 122.3491 }, "timestamp": { "timeInSeconds": 1575691200 } } ] } ] }
    • 负载中的每个条目都包含一个 entryId,您可以将其定义为任何唯一的字符串。如果任何请求条目失败,则每个错误都将包含相应请求的 entryId,以便您知道要重试的请求。

    • 要设置属性值,可以在每个属性属性的列表中包含一个 timestamp-quality-value (TQV) 结构。propertyValues此结构必须包含新的 value 和当前的 timestamp

      • value – 包含下列字段之一的结构,具体取决于要设置的属性的类型:

        • booleanValue

        • doubleValue

        • integerValue

        • stringValue

      • timestamp— 一种包含当前 Unix 纪元时间(以秒为单位)的结构,timeInSeconds。 AWS IoT SiteWise 拒绝任何时间戳在过去存在超过 7 天或将来超过 5 分钟的数据点。

    有关如何为其准备有效载荷的更多信息 BatchPutAssetPropertyValue,请参阅使用 API 摄取数据 AWS IoT SiteWise

  2. 运行以下命令将属性值发送到 AWS IoT SiteWise:

    aws iotsitewise batch-put-asset-property-value -\-cli-input-json file://batch-put-payload.json