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

# 從設備定義資料串流 （度量）
<a name="measurements"></a>

*測量*代表裝置的原始感應器資料串流，例如時間戳記溫度值或每分鐘時間戳記輪換 (RPM) 值。

**Topics**
+ [定義測量 （主控台）](#define-measurements-console)
+ [定義測量 (AWS CLI)](#define-measurements-cli)

## 定義測量 （主控台）
<a name="define-measurements-console"></a>

當您在 AWS IoT SiteWise 主控台中定義資產模型的測量時，您可以指定下列參數：
+ <a name="asset-property-name-console"></a>**名稱** – 屬性的名稱。
+ <a name="asset-property-unit-console"></a>**單位** – （選用） 屬性的科學單位，例如 mm 或 Celsius。
+ <a name="asset-property-data-type-console"></a>**資料類型** – 屬性的資料類型，其為下列其中一項：
  + **字串** – 最多 1024 個位元組的字串。
  + **整數** – 範圍為 【-2，147，483，648，2，147，483，647】 的帶正負號 32 位元整數。
  + **Double** – 範圍為 【-10^100、10^100】 和 IEEE 754 雙精度的浮點數。
  + **布林值** – `true`或 `false`。
+ **外部 ID** – （選用） 這是使用者定義的 ID。如需詳細資訊，請參閱《AWS IoT SiteWise 使用者指南》**中的 [參考具有外部 IDs物件](object-ids.md#external-id-references)。

如需詳細資訊，請參閱[建立資產模型 （主控台）](create-asset-models.md#create-asset-model-console)。

## 定義測量 (AWS CLI)
<a name="define-measurements-cli"></a>

當您使用 AWS IoT SiteWise API 定義資產模型的測量時，您可以指定下列參數：
+ <a name="asset-property-name-cli"></a>`name` – 屬性的名稱。
+ <a name="asset-property-data-type-cli"></a>`dataType` – 屬性的資料類型，其為下列其中一項：
  + `STRING` – 最多 1024 個位元組的字串。
  + `INTEGER` – 範圍為 【-2，147，483，648， 2，147，483，647】 的帶正負號 32 位元整數。
  + `DOUBLE` – 範圍為 【-10^100、10^100】 和 IEEE 754 雙精度的浮點數。
  + `BOOLEAN` – `true`或 `false`。
+ <a name="asset-property-unit-cli"></a>`unit` – （選用） 屬性的科學單位，例如 mm 或 Celsius。
+ `externalId` – （選用） 這是使用者定義的 ID。如需詳細資訊，請參閱《AWS IoT SiteWise 使用者指南》**中的 [參考具有外部 IDs物件](object-ids.md#external-id-references)。

**Example 範例衡量值定義**  
下列範例示範代表資產溫度感測器讀數的衡量值。此物件是包含[測量](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_Measurement.html)的 [AssetModelProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssetModelProperty.html) 範例。您可以將此物件指定為 [CreateAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModel.html) 請求承載的一部分，以建立測量屬性。如需詳細資訊，請參閱[建立資產模型 (AWS CLI)](create-asset-models.md#create-asset-model-cli)。  
當您定義資產模型時，[測量](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_Measurement.html)結構是空的結構，因為您稍後將每個資產設定為使用唯一的裝置資料串流。如需如何將資產的測量屬性連接至裝置感應器資料串流的詳細資訊，請參閱 [管理 的資料串流 AWS IoT SiteWise](manage-data-streams.md)。  

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