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

# 定義靜態資料 （屬性）
<a name="attributes"></a>

*資產屬性*代表通常為靜態的資訊，例如裝置製造商或地理位置。您從資產模型建立的每個資產，皆會包含該模型的屬性。

**Topics**
+ [定義屬性 （主控台）](#define-attributes-console)
+ [定義屬性 (AWS CLI)](#define-attributes-cli)

## 定義屬性 （主控台）
<a name="define-attributes-console"></a>

當您在 AWS IoT SiteWise 主控台中定義資產模型的屬性時，您可以指定下列參數：
+ <a name="asset-property-name-console"></a>**名稱** – 屬性的名稱。
+ **預設值** – （選用） 此屬性的預設值。從模型建立的資產具有 屬性的此值。對於從模型建立的資產，如需如何覆寫預設值的詳細資訊，請參閱 [更新屬性值](update-attribute-values.md)。
+ <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-attributes-cli"></a>

當您使用 AWS IoT SiteWise API 定義資產模型的屬性時，您可以指定下列參數：
+ <a name="asset-property-name-cli"></a>`name` – 屬性的名稱。
+ `defaultValue` – （選用） 此屬性的預設值。從模型建立的資產具有 屬性的此值。對於從模型建立的資產，如需如何覆寫預設值的詳細資訊，請參閱 [更新屬性值](update-attribute-values.md)。
+ <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`。
+ `externalId` – （選用） 這是使用者定義的 ID。如需詳細資訊，請參閱《AWS IoT SiteWise 使用者指南》**中的 [參考具有外部 IDs物件](object-ids.md#external-id-references)。

**Example 範例屬性定義**  
下列範例示範會將資產的模型編號以預設值呈現的屬性。此物件是包含 [屬性](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_Attribute.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)。  

```
{
...
"assetModelProperties": [
{
  "name": "Model number",
  "dataType": "STRING",
  "type": {
    "attribute": {
      "defaultValue": "BLT123"
    }
  }
}
],
...
}
```