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

# 在 中建立資產模型的資產 AWS IoT SiteWise
<a name="create-assets"></a>

您可以從資產模型建立資產。您必須先擁有資產模型，才能建立資產。若您尚未建立資產模型，請參閱 [在 中建立資產模型 AWS IoT SiteWise](create-asset-models.md)。

**注意**  
您只能從 `ACTIVE` 模型建立資產。如果模型狀態不是 `ACTIVE`，您可能需要等待幾分鐘，才能從該模型建立資產。如需詳細資訊，請參閱[資產和模型狀態](asset-and-model-states.md)。

**Topics**
+ [建立資產 （主控台）](#create-asset-console)
+ [建立資產 (AWS CLI)](#create-asset-cli)
+ [設定新的資產](create-asset-next-steps.md)

## 建立資產 （主控台）
<a name="create-asset-console"></a>

您可以使用 AWS IoT SiteWise 主控台來建立資產。

**建立資產 (主控台)**

1. <a name="sitewise-open-console"></a>導覽至 [AWS IoT SiteWise 主控台](https://console.aws.amazon.com/iotsitewise/)。

1. <a name="sitewise-choose-assets"></a>在導覽窗格中，選擇 **Assets (資產)**。

1. 選擇 **Create asset (建立資產)**。

1. 在 **Create asset (建立資產)** 頁面上，執行下列動作：

   1. 針對 **Model (模型)**，選擇要從中建立資產的資產模型。
**注意**  
如果您的模型非 **ACTIVE (作用中)**，則必須等候模型處於作用中狀態，或如果模型為 **FAILED (失敗)**，則必須解決問題。

   1. 輸入資產的 **Name (名稱)**。

   1. (選用) 為您的資產新增標籤。如需詳細資訊，請參閱[標記您的 AWS IoT SiteWise 資源](tag-resources.md)。

   1. 選擇 **Create asset (建立資產)**。

   當您建立資產時， AWS IoT SiteWise 主控台會導覽至新資產的頁面。在此頁面上，您可以看到資產的 **Status (狀態)**，最初為 **CREATING (建立中)**。此頁面會自動更新，因此您可以等候資產的狀態更新。
**注意**  
資產建立程序可能需要一分鐘的時間。**狀態**為 **ACTIVE** 之後，您可以對資產執行更新操作。如需詳細資訊，請參閱[資產和模型狀態](asset-and-model-states.md)。

建立資產後，請參閱 [設定新的資產](create-asset-next-steps.md)。

## 建立資產 (AWS CLI)
<a name="create-asset-cli"></a>

您可以使用 AWS Command Line Interface (AWS CLI) 從資產模型建立資產。

您必須具有 `assetModelId` 才能建立資產。如果您建立了資產模型，但不知道其 `assetModelId`，請使用 [ListAssetModels](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssetModels.html) API 來檢視所有資產模型。

若要從資產模型建立資產，請使用 [CreateAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAsset.html) API 搭配下列參數：
+ `assetName` – 新資產的名稱。為您的資產命名以協助您識別它。
+ `assetModelId` – 資產的 ID。這是 UUID 格式的實際 ID，`externalId:myExternalId`如果有的話，則為 。如需詳細資訊，請參閱《AWS IoT SiteWise 使用者指南》**中的 [參考具有外部 IDs物件](object-ids.md#external-id-references)。

**建立資產 (AWS 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`，直到資產建立為止。
**注意**  
資產建立程序可能需要一分鐘的時間。若要檢查資產的狀態，請使用 [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) 操作搭配資產的 ID 做為 `assetId` 參數。在資產的 `state`為 之後`ACTIVE`，您可以對資產執行更新操作。如需詳細資訊，請參閱[資產和模型狀態](asset-and-model-states.md)。

建立資產後，請參閱 [設定新的資產](create-asset-next-steps.md)。