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

# 在中为资产模型创建资产 Amazon IoT SiteWise
<a name="create-assets"></a>

您可以从资产模型中创建资产。您必须具有资产模型，然后才能创建资产。如果您尚未创建资产模型，请参阅[在中创建资产模型 Amazon IoT SiteWise](create-asset-models.md)。

**注意**  
您只能从 `ACTIVE` 模型创建资产。如果模型的状态不是 `ACTIVE`，您可能需要等待几分钟（最长），然后才能从该模型创建资产。有关更多信息，请参阅 [资产和模型状态](asset-and-model-states.md)。

**Topics**
+ [创建资产（控制台）](#create-asset-console)
+ [创建资产（Amazon CLI）](#create-asset-cli)
+ [配置新资产](create-asset-next-steps.md)

## 创建资产（控制台）
<a name="create-asset-console"></a>

您可以使用 Amazon IoT SiteWise 控制台创建资产。

**创建资产（控制台）**

1. <a name="sitewise-open-console"></a>导航至 [Amazon IoT SiteWise 控制台](https://console.amazonaws.cn/iotsitewise/)。

1. <a name="sitewise-choose-assets"></a>在导航窗格中，选择**资产**。

1. 选择**创建资产**。

1. 在 **创建资产** 页上，执行以下操作：

   1. 对于 **模型**，选择要从中创建资产的资产模型。
**注意**  
如果您的模型状态不为 **活动**，则必须等待其变为活动状态，如果状态为 **失败**，则必须解决问题。

   1. 为资产输入 **名称**。

   1. （可选）为资产添加标签。有关更多信息，请参阅 [标记您的 Amazon IoT SiteWise 资源](tag-resources.md)。

   1. 选择**创建资产**。

   创建资产时， Amazon IoT SiteWise 控制台会导航到新资产的页面。在此页面上，您可以查看资产的 **状态**，最初为 **正在创建**。此页面会自动更新，因此您可以等待资产的状态更新。
**注意**  
资产创建流程最多可能需要一分钟。在**状态**为**活动**后，您可以对资产执行更新操作。有关更多信息，请参阅 [资产和模型状态](asset-and-model-states.md)。

创建资产后，请参阅[配置新资产](create-asset-next-steps.md)。

## 创建资产（Amazon CLI）
<a name="create-asset-cli"></a>

您可以使用 Amazon Command Line Interface (Amazon CLI) 根据资产模型创建资产。

您必须具有 `assetModelId` 才能创建资产。如果您创建了资产模型，但不知道该模型`assetModelId`，请使用 [ListAssetModels](https://docs.amazonaws.cn/iot-sitewise/latest/APIReference/API_ListAssetModels.html)API 查看所有资产模型。

要根据资产模型创建资产，请使用带有以下参数的 [CreateAsset](https://docs.amazonaws.cn/iot-sitewise/latest/APIReference/API_CreateAsset.html)API：
+ `assetName` – 新资产的名称。为资产命名，以帮助您识别它。
+ `assetModelId` – 资产的 ID。这是 UUID 格式的实际 ID，或者 `externalId:myExternalId`（如果有）。有关更多信息，请参阅《Amazon IoT SiteWise 用户指南》**中的 [使用外部引用对象 IDs](object-ids.md#external-id-references)。

**要创建资产（Amazon CLI），请执行以下步骤：**
+ 运行以下命令以创建资产。*asset-name*替换为资产的*asset-model-id*名称以及资产模型的 ID 或外部 ID。

  ```
  aws iotsitewise create-asset \
    --asset-name asset-name \
    --asset-model-id asset-model-id
  ```

  此操作将按以下格式返回包含新资产的详细信息和状态的响应。

  ```
  {
    "assetId": "String",
    "assetArn": "String",
    "assetStatus": {
      "state": "String",
      "error": {
        "code": "String",
        "message": "String"
      }
    }
  }
  ```

  资产的 `state` 为 `CREATING`，直至资产创建完毕。
**注意**  
资产创建流程最多可能需要一分钟。要检查资产的状态，请使用以您的资产 ID 作为`assetId`参数的[DescribeAsset](https://docs.amazonaws.cn/iot-sitewise/latest/APIReference/API_DescribeAsset.html)操作。资产的 `state` 为 `ACTIVE`后，您可以对资产执行更新操作。有关更多信息，请参阅 [资产和模型状态](asset-and-model-states.md)。

创建资产后，请参阅[配置新资产](create-asset-next-steps.md)。