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

# 在 中刪除資產 AWS IoT SiteWise
<a name="delete-assets"></a>

您可以使用 AWS IoT SiteWise 主控台或 API 來刪除環境中不再需要的資產。刪除資產模型也會刪除所有相關聯的資產和元件模型。不過，請務必注意，刪除資產或模型是永久動作，而且也會移除與已刪除資源相關聯的任何資料。刪除資產或模型之前，建議您檢閱任何可能受影響的相依性或整合，並確保您擁有任何重要資料的備份。

您必須先將資產與其子資產取消關聯，才能將其從其父資產中刪除。如需詳細資訊，請參閱[關聯和取消關聯資產](add-associated-assets.md)。如果您使用 AWS Command Line Interface (AWS CLI)，您可以使用 [ListAssociatedAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssociatedAssets.html) 操作來列出資產的子系。

刪除資產時，於變更傳播之前，其狀態會保持為 `DELETING`。如需詳細資訊，請參閱[資產和模型狀態](asset-and-model-states.md)。刪除資產後，您無法查詢該資產。如果您這樣做，API 會傳回 HTTP 404 回應。

**重要**  
AWS IoT SiteWise 會刪除已刪除資產的所有屬性資料。

**Topics**
+ [刪除資產 （主控台）](#delete-asset-console)
+ [刪除資產 (AWS CLI)](#delete-asset-cli)

## 刪除資產 （主控台）
<a name="delete-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. 選擇要刪除的資產。
**提示**  <a name="sitewise-expand-asset-hierarchy"></a>
您可以選擇箭頭圖示來展開資產階層，以尋找您的資產。

1. 如果資產有任何 **Associated assets (關聯的資產)**，請刪除每個資產。您可以選擇資產的名稱，以導覽至其頁面，您可以在其中刪除資產。

1. 在資產頁面上，選擇 **Delete (刪除)**。

1. 在**刪除資產**對話方塊中，執行下列動作：

   1. 輸入 **Delete** 以確認刪除。

   1. 選擇 **刪除**。

## 刪除資產 (AWS CLI)
<a name="delete-asset-cli"></a>

您可以使用 AWS Command Line Interface (AWS CLI) 來刪除資產。

使用 [DeleteAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DeleteAsset.html) 操作來刪除資產。指定下列參數：
+ `assetId` – 資產的 ID。這是 UUID 格式的實際 ID，`externalId:myExternalId`如果有的話，則為 。如需詳細資訊，請參閱《AWS IoT SiteWise 使用者指南》**中的 [參考具有外部 IDs物件](object-ids.md#external-id-references)。

**刪除資產 (AWS CLI)**

1. 執行下列命令來列出資產的階層。將 *asset-id* 取代為資產的 ID 或外部 ID：

   ```
   aws iotsitewise describe-asset --asset-id asset-id
   ```

   此操作會傳回包含資產詳細資料的回應。回應包含具有下列結構的`assetHierarchies`清單：

   ```
   {
     ...
     "assetHierarchies": [
       {
         "id": "String",
         "name": "String"
       }
     ],
     ...
   }
   ```

   如需詳細資訊，請參閱 [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) 操作。

1. 針對每個階層，執行下列命令來列出與該階層相關聯的資產子系。將 *asset-id* 取代為資產的 ID 或外部 ID，並將 *hierarchy-id* 取代為階層的 ID 或外部 ID。

   ```
   aws iotsitewise list-associated-assets \
     --asset-id asset-id \
     --hierarchy-id hierarchy-id
   ```

   如需詳細資訊，請參閱 [ListAssociatedAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssociatedAssets.html) 操作。

1. 執行下列命令來刪除每個關聯的資產，然後刪除資產。以*資產的 ID 或外部 ID 取代 asset-id*。

   ```
   aws iotsitewise delete-asset --asset-id asset-id
   ```