建立資產

您可以從資產模型建立資產。您必須先擁有資產模型，才能建立資產。若您尚未建立資產模型，請參閱 更新資產模型。

注意

您只能從 ACTIVE 模型建立資產。如果模型狀態不是 ACTIVE，您可能需要等待幾分鐘，才能從該模型建立資產。如需詳細資訊，請參閱 資產和模型狀態。

建立資產 (主控台)

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

建立資產 (主控台)

1. 導覽至 AWS IoT SiteWise 主控台。

2. 在導覽窗格中，選擇 Assets (資產)。

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

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

   1. 針對 Model (模型)，選擇要從中建立資產的資產模型。

      注意

      如果您的模型非 ACTIVE (作用中)，則必須等候模型處於作用中狀態，或如果模型為 FAILED (失敗)，則必須解決問題。

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

   3. (選用) 為您的資產新增標籤。如需詳細資訊，請參閱 標記您的 AWS IoT SiteWise 資源。

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

   建立資產時， AWS IoT SiteWise 主控台會導覽至新資產的頁面。在此頁面上，您可以看到資產的 Status (狀態)，最初為 CREATING (建立中)。此頁面會自動更新，因此您可以等候資產的狀態更新。

   注意

   資產建立程序可能需要一分鐘的時間。「狀態」 為「作用中」後，您可以對資產執行更新作業。如需詳細資訊，請參閱 資產和模型狀態。

建立資產後，請參閱 設定新資產。

建立資產 (AWS CLI)

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

您必須具有 assetModelId 才能建立資產。如果您已建立資產模型，但不知道該模型assetModelId，請使用 ListAssetModelsAPI 來檢視所有資產模型。

若要從資產模型建立資產，請使用具有下列參數的 CreateAssetAPI：

• assetName— 新資產的名稱。為您的資產命名，以協助您識別資產。

• assetModelId— 資產的 ID。這是 UUID 格式的實際 ID，或者externalId:myExternalId如果它有一個。如需詳細資訊，請參閱《AWS IoT SiteWise 使用者指南》中的 使用外部 ID 參考物件。

若要建立資產 (AWS CLI)

• 執行下列命令以建立資產。將資產名稱取代為資產的名稱，並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 的DescribeAsset作業做為assetId參數。資產state已存在之後ACTIVE，您可以對資產執行更新作業。如需詳細資訊，請參閱 資產和模型狀態。

建立資產後，請參閱 設定新資產。

設定新資產

使用下列任何選用動作來完成資產設定：

• 將工業資料串流對應到資產屬性 如果您的資產具有衡量值屬性。

• 更新屬性值 如果您的資產具有唯一的屬性值。

• 建立資產關聯及取消關聯 如果您的資產是父項資產。