

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

# 删除中的资源和模型 AWS IoT SiteWise
<a name="delete-assets-and-models"></a>

当你使用完你的资源、资产模型、组件模型和接口 AWS IoT SiteWise 时，你可以将其删除。删除操作是异步的，需要一段时间才能传 AWS IoT SiteWise播。

**Topics**
+ [删除中的资产 AWS IoT SiteWise](delete-assets.md)
+ [删除中的资产模型、组件模型和接口 AWS IoT SiteWise](delete-asset-models.md)

# 删除中的资产 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>在导航窗格中，选择**资产**。

1. 选择要删除的资产。
**提示**  <a name="sitewise-expand-asset-hierarchy"></a>
您可以选择箭头图标来展开资产层次结构以查找资产。

1. 如果该资产具有任何 **关联的资产**，请删除每个资产。您可以选择资产的名称以导航到其页面，从中可以将其删除。

1. 在资产页面上，选择 **删除**。

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. 运行以下命令以删除每个关联的资产，然后删除该资产。*asset-id*替换为资产的 ID 或外部 ID。

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

# 删除中的资产模型、组件模型和接口 AWS IoT SiteWise
<a name="delete-asset-models"></a>

您可以使用 AWS IoT SiteWise 控制台或 API 删除资产模型、组件模型或接口。

您必须先从资产模型中删除创建的所有资产，然后才能删除资产模型。在删除接口之前，必须先取消其与实现该接口的所有资产模型的关联。

删除资源模型或接口时，其状态为`DELETING`直到更改传播为止。有关更多信息，请参阅 [资产和模型状态](asset-and-model-states.md)。删除资产模型或接口后，您将无法查询该资产模型或接口。如果查询，API 将返回 HTTP 404 响应。

**Topics**
+ [删除资产模型、组件模型或接口（控制台）](#delete-asset-model-console)
+ [删除资产模型、组件模型或接口 (AWS CLI)](#delete-asset-model-cli)

## 删除资产模型、组件模型或接口（控制台）
<a name="delete-asset-model-console"></a>

您可以使用 AWS IoT SiteWise 控制台删除资产模型、组件模型或接口。

**Topics**

**删除资产模型、组件模型或接口（控制台）**

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

1. <a name="sitewise-choose-models"></a>在导航窗格中，选择**模型**。

1. 选择要删除的资产模型、组件模型或接口。

1. 如果删除资产模型且该模型包含任何**资产**，请删除每项资产。选择资产的名称以导航到其页面，您可以从中将其删除。有关更多信息，请参阅 [删除资产（控制台）](delete-assets.md#delete-asset-console)。

1. 在模型页面上，选择 **删除**。

1. 在**删除模型**对话框中，执行以下操作：

   1. 输入 **Delete** 以确认删除。

   1. 选择**删除**。

## 删除资产模型、组件模型或接口 (AWS CLI)
<a name="delete-asset-model-cli"></a>

您可以使用 AWS Command Line Interface (AWS CLI) 删除资产模型、组件模型或接口。

使用[DeleteAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DeleteAssetModel.html)操作删除资产模型、组件模型或接口。指定以下参数：
+ `assetModelId` – 资产的 ID。这是 UUID 格式的实际 ID，或者 `externalId:myExternalId`（如果有）。有关更多信息，请参阅《AWS IoT SiteWise 用户指南》**中的 [使用外部引用对象 IDs](object-ids.md#external-id-references)。

**要删除资产模型（AWS CLI），请执行以下步骤：**

1. 运行以下命令以列出从模型创建的所有资产。*asset-model-id*替换为资产模型的 ID 或外部 ID。

   ```
   aws iotsitewise list-assets --asset-model-id asset-model-id
   ```

   有关更多信息，请参阅 [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html) 操作。

1. 如果上一命令返回模型中的任何资产，请删除每个资产。有关更多信息，请参阅 [删除资产（AWS CLI）](delete-assets.md#delete-asset-cli)。

1. 运行以下命令以删除资产模型。*asset-model-id*替换为资产模型的 ID 或外部 ID。

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

**重要**  
 为避免删除自上次读取操作以来同时更新的资产模型，您必须定义有条件删除请求。请参阅[对资产模型写入进行乐观锁定](opt-locking-for-model.md)。