

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

# 定义静态数据（属性）
<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 字节的字符串。
  + **整数** – 有符号的 32 位整数，范围是 [-2,147,483,648, 2,147,483,647]。
  + **双精度** – 具有 [-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` – 有符号的 32 位整数，范围是 [-2,147,483,648, 2,147,483,647]。
  + `DOUBLE` – 具有 [-10^100, 10^100] 范围和 IEEE 754 双精度的浮点数。
  + `BOOLEAN` – `true` 或 `false`。
+ `externalId` -（可选）这是用户定义的 ID。有关更多信息，请参阅《AWS IoT SiteWise 用户指南》**中的 [使用外部引用对象 IDs](object-ids.md#external-id-references)。

**Example 属性定义示例**  
以下示例演示一个表示具有默认值的资产型号的属性。此对象是包含[属[AssetModelProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssetModelProperty.html)](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_Attribute.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"
    }
  }
}
],
...
}
```