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

# 删除亚马逊 A SageMaker I 域名
<a name="gs-studio-delete-domain"></a>

本页介绍如何删除域以及所需的要求。域由授权用户列表、配置设置和 Amazon Elastic File System (Amazon EFS) 卷组成。Amazon EFS 卷包含用户的数据，包括笔记本、资源和构件。用户可以拥有多个应用程序（应用），这些应用程序支持用户的笔记本、终端和控制台的读取和执行体验。您可以使用以下方法之一删除域：
+ Amazon 控制台
+ Amazon Command Line Interface (Amazon CLI)
+ SageMaker SDK

## 要求
<a name="gs-studio-delete-domain-requirements"></a>

删除域必须满足以下要求。
+ 您必须具有管理员权限才能删除域。
+ 您只能删除域中状态 `InService` 显示为**就绪**的应用程序。要删除包含域的应用程序，无需删除状态为 `Failed` 的应用程序。在域中，尝试删除处于失败状态的应用程序会导致错误。
+ 要删除域，该域不能包含任何用户配置文件或共享空间。要删除用户配置文件或共享空间，则配置文件或共享空间中不能包含任何非失败应用程序。

  在删除这些资源时，会出现以下情况：
  + 应用程序 - 保存用户主目录中的数据（文件和笔记本）。未保存的笔记本数据将丢失。
  + 用户配置文件：用户无法再登录域。用户无法访问其主目录，但数据不会被删除。管理员可以从用户 Amazon Web Services 账户下用于存储数据的 Amazon EFS 卷中检索数据。

## EFS 文件
<a name="gs-studio-delete-domain-efs"></a>

您的文件作为备份保存在 Amazon EFS 卷中。此备份包括已安装目录中的文件，该目录`/home/sagemaker-user`适用于 Amazon SageMaker Studio Classic 和`/root`内核。

当您从这些挂载的目录中删除文件时，内核或应用程序可能会将已删除的文件移到隐藏的垃圾文件夹中。如果垃圾文件夹位于挂载的目录内，则这些文件将复制到 Amazon EFS 卷中并产生费用。为避免这些 Amazon EFS 费用，您必须识别并清理垃圾文件夹的位置。默认应用程序和内核的垃圾文件夹位置为 `~/.local/`。位置可能有所不同，具体取决于用于自定义应用程序或内核的 Linux 发行版。有关 Amazon EFS 卷的更多信息，请参阅[在 Amazon SageMaker Studio Classic 中管理您的亚马逊 EFS 存储卷](studio-tasks-manage-storage.md)。

当您使用 SageMaker AI 控制台删除域时，Amazon EFS 卷将被分离但不会被删除。默认情况下，当您使用 Amazon CLI 或 SageMaker Python SDK 删除域名时，也会出现同样的行为。但是，在使用 Amazon CLI 或 SageMaker Python 开发工具包时，可以将设置`RetentionPolicy`为`HomeEfsFileSystem=Delete`。这将连同域一起删除 Amazon EFS 卷。

## 删除 Amazon SageMaker AI 域名（控制台）
<a name="gs-studio-delete-domain-studio"></a>

**重要**  
删除用户、空间或域后，包含相应数据的 Amazon EFS 卷将丢失。这包括笔记本和其他构件。

**删除域**

1. 打开 A [SageMaker I 控制台](https://console.amazonaws.cn/sagemaker/)。

1. 在左侧导航窗格中，选择**管理员配置**以展开选项（如果尚未展开）。

1. 在**管理员配置**下，选择**域**。

1. 选择要删除的域名链接。

1. 选择**用户配置文件**选项卡。

1. 对**用户配置文件**列表中的每个用户重复以下步骤。

   1. 选择用户名链接。

   1. 如果尚未选择，请选择**用户详细信息**选项卡

   1. 找到所有应用程序和空间，然后在相应的**操作**列下选择**删除**。

   1. 按照删除说明操作。

   1. 当所有应用程序和空间的**状态**均为**已删除**后，选择页面右上角的**删除**。

   1. 按照删除说明操作。

1. 删除所有用户后，选择**空间管理**选项卡。

1. 对**空间**列表中的每个空间重复以下步骤。

   1. 选择与空间对应的气泡。

   1. 选择**删除**。

   1. 按照删除说明操作。

1. 删除所有用户和空间后，选择**域设置**选项卡。

1. 找到**删除域**部分。

1. 选择**删除域**。如果此按钮不可用，则必须重复前面的步骤以删除所有空间和用户。

1. 按照删除说明操作。

## 删除亚马逊 A SageMaker I 域名 (Amazon CLI)
<a name="gs-studio-delete-domain-cli"></a>

**删除域**

1. 检索您账户中的域列表。

   ```
   aws --region Region sagemaker list-domains
   ```

1. 检索要删除的域的应用程序列表。

   ```
   aws --region Region sagemaker list-apps \
       --domain-id-equals DomainId
   ```

1. 删除列表中的所有应用程序。

   ```
   aws --region Region sagemaker delete-app \
       --domain-id DomainId \
       --app-name AppName \
       --app-type AppType \
       --user-profile-name UserProfileName
   ```

1. 检索域中用户配置文件的列表。

   ```
   aws --region Region sagemaker list-user-profiles \
       --domain-id-equals DomainId
   ```

1. 删除列表中的所有用户配置文件。

   ```
   aws --region Region sagemaker delete-user-profile \
       --domain-id DomainId \
       --user-profile-name UserProfileName
   ```

1. 读取域中的共享空间列表。

   ```
   aws --region Region sagemaker list-spaces \
       --domain-id DomainId
   ```

1. 删除列表中的所有共享空间。

   ```
   aws --region Region sagemaker delete-space \
       --domain-id DomainId \
       --space-name SpaceName
   ```

1. 删除域。如果也要删除 Amazon EFS 卷，请指定 `HomeEfsFileSystem=Delete`。

   ```
   aws --region Region sagemaker delete-domain \
       --domain-id DomainId \
       --retention-policy HomeEfsFileSystem=Retain
   ```