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

# 定义来自设备的数据流（测量值）
<a name="measurements"></a>

*测量值*表示设备的原始传感器数据流，如带有时间戳的温度值或带有时间戳的每分钟转数 (RPM) 值。

**Topics**
+ [定义测量值（控制台）](#define-measurements-console)
+ [定义测量值（Amazon CLI）](#define-measurements-cli)

## 定义测量值（控制台）
<a name="define-measurements-console"></a>

在 Amazon IoT SiteWise 控制台中为资产模型定义测量值时，需要指定以下参数：
+ <a name="asset-property-name-console"></a>**名称** – 属性的名称。
+ <a name="asset-property-unit-console"></a>**单位** – （可选）属性的科学单位，例如毫米或摄氏度。
+ <a name="asset-property-data-type-console"></a>**数据类型** – 属性的数据类型，如以下类型之一：
  + **字符串** – 最多 1024 字节的字符串。
  + **整数** – 有符号的 32 位整数，范围是 [-2,147,483,648, 2,147,483,647]。
  + **双精度** – 具有 [-10^100, 10^100] 范围和 IEEE 754 双精度的浮点数。
  + **布尔值** – `true` 或 `false`。
+ **外部 ID** -（可选）这是用户定义的 ID。有关更多信息，请参阅《Amazon IoT SiteWise 用户指南》**中的 [使用外部引用对象 IDs](object-ids.md#external-id-references)。

有关更多信息，请参阅 [创建资产模型（控制台）](create-asset-models.md#create-asset-model-console)。

## 定义测量值（Amazon CLI）
<a name="define-measurements-cli"></a>

使用 Amazon IoT SiteWise API 定义资产模型的衡量标准时，需要指定以下参数：
+ <a name="asset-property-name-cli"></a>`name` – 属性的名称。
+ <a name="asset-property-data-type-cli"></a>`dataType` – 属性的数据类型，如以下类型之一：
  + `STRING` – 最多 1024 字节的字符串。
  + `INTEGER` – 有符号的 32 位整数，范围是 [-2,147,483,648, 2,147,483,647]。
  + `DOUBLE` – 具有 [-10^100, 10^100] 范围和 IEEE 754 双精度的浮点数。
  + `BOOLEAN` – `true` 或 `false`。
+ <a name="asset-property-unit-cli"></a>`unit` – （可选）属性的科学单位，例如毫米或摄氏度。
+ `externalId` -（可选）这是用户定义的 ID。有关更多信息，请参阅《Amazon IoT SiteWise 用户指南》**中的 [使用外部引用对象 IDs](object-ids.md#external-id-references)。

**Example 测量值定义示例**  
以下示例演示一个表示资产温度传感器读数的测量值。此对象是包含[测量值[AssetModelProperty](https://docs.amazonaws.cn/iot-sitewise/latest/APIReference/API_AssetModelProperty.html)](https://docs.amazonaws.cn/iot-sitewise/latest/APIReference/API_Measurement.html)的示例。您可以将此对象指定为 [CreateAssetModel](https://docs.amazonaws.cn/iot-sitewise/latest/APIReference/API_CreateAssetModel.html) 请求负载的一部分，以创建测量值属性。有关更多信息，请参阅 [创建资产模型（Amazon CLI）](create-asset-models.md#create-asset-model-cli)。  
在定义资产模型时，[测量值](https://docs.amazonaws.cn/iot-sitewise/latest/APIReference/API_Measurement.html)结构为空结构，因为您以后将每个资产配置为使用唯一的设备数据流。有关如何将资产的测量值属性连接到设备的传感器数据流的更多信息，请参阅[管理数据流 Amazon IoT SiteWise](manage-data-streams.md)。  

```
{
      ...
      "assetModelProperties": [
      {
          "name": "Temperature C",
          "dataType": "DOUBLE",
          "type": {
              "measurement": {}
          },
          "unit": "Celsius"
      }
  ],
      ...
}
```