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

# 刪除 Amazon SageMaker AI 網域
<a name="gs-studio-delete-domain"></a>

此頁面說明如何刪除網域和所需的要求。網域包含授權使用者清單、組態和 Amazon Elastic File System (Amazon EFS) 磁碟區。Amazon EFS 磁碟區包含使用者的資料，包括筆記本、資源和成品。使用者可以擁有多個應用程式 (app)，這些應用程式支援使用者的筆記本、終端機和主控台的讀取和執行體驗。您可以使用下列其中一個來刪除您的網域：
+ AWS 主控台
+ AWS Command Line Interface (AWS CLI)
+ SageMaker SDK

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

您必須滿足下列要求才能刪除網域。
+ 您必須具有管理員許可才能刪除網域。
+ 您只能刪除網域中狀態 `InService` 顯示為**備妥**的應用程式。若要刪除包含網域，您不需要刪除狀態為 `Failed` 的應用程式。在網域中，嘗試刪除處於失敗狀態的應用程式會產生錯誤。
+ 若要刪除網域，網域不能包含任何使用者設定檔或共用空間。若要刪除使用者設定檔或共用空間，使用者設定檔或共用空間不能包含任何非失敗的應用程式。

  當您刪除這些資源時會發生下列情況：
  + 應用程式 - 儲存使用者主目錄中的資料 (檔案和筆記本)。未儲存的筆記本資料會遺失。
  + 使用者設定檔 — 使用者再也無法登入網域。使用者無法存取其主目錄，但不會刪除資料。管理員可以從 Amazon EFS 磁碟區擷取使用者 AWS 帳戶下儲存的資料。
+ 若要將驗證模式從 IAM 切換到 IAM Identity Center，您必須刪除網域。

## EFS 檔案
<a name="gs-studio-delete-domain-efs"></a>

您的檔案會作為備份保存在 Amazon EFS 磁碟區中。此備份包括掛載目錄中的檔案，其中 `/home/sagemaker-user` 適用於 Amazon SageMaker Studio 和 `/root` 適用於您的核心。

當您從這些掛載的目錄中刪除文件時，內核或應用程式可能會將已刪除的文件移動到隱藏的垃圾文件夾中。如果垃圾桶資料夾位於掛接的目錄內，則這些檔案會複製到 Amazon EFS 磁碟區，並產生費用。若要避免這些 Amazon EFS 費用，您必須識別並清理垃圾桶資料夾位置。預設應用程式和核心的垃圾箱文件夾位置是`~/.local/`。這可能會根據用於自訂應用程式或內核的 Linux 發行版而有所不同。如需 Amazon EFS 磁碟區的詳細資訊，請參閱[在 Amazon SageMaker Studio Classic 中管理您的 Amazon EFS 儲存磁碟區](studio-tasks-manage-storage.md)。

當您使用 SageMaker AI 主控台刪除網域時，Amazon EFS 磁碟區會分離但不會刪除。依預設，當您使用 AWS CLI 或 SageMaker Python SDK 刪除網域時，會發生相同的行為。不過，當您使用 AWS CLI 或 SageMaker Python SDK 時，您可以將 `RetentionPolicy` 設定為 `HomeEfsFileSystem=Delete`。這會刪除 Amazon EFS 磁碟區與網域。

## 刪除 Amazon SageMaker AI 網域 (主控台)
<a name="gs-studio-delete-domain-studio"></a>

**重要**  
刪除使用者、空間或網域時，包含對應資料的 Amazon EFS 磁碟區將會遺失。這包括筆記本和其他成品。

**刪除網域**

1. 開啟 [SageMaker AI 主控台](https://console.aws.amazon.com/sagemaker/)。

1. 在左側導覽窗格上，選擇**管理員組態**以展開選項，如果尚未展開的話。

1. 在**管理員組態**下，選擇**網域**。

1. 選取您要刪除的網域名稱連結。

1. 選擇**使用者設定檔**索引標籤。

1. 針對**使用者設定檔**清單中的每個使用者，重複執行下列步驟。

   1. 選擇使用者名稱連結。

   1. 如果尚未選取，請選擇**使用者詳細資訊**索引標籤。

   1. 尋找任何應用程式和空間，然後在對應的**動作**欄下選擇**刪除**。

   1. 遵循刪除指示。

   1. 一旦所有應用程式和空間的**狀態**都為**已刪除**，請選擇頁面右上角的**刪除**。

   1. 遵循刪除指示。

1. 刪除所有使用者後，選擇**空間管理**標籤。

1. 針對**空間**清單中的每個空間重複下列步驟。

   1. 選取與空間對應的泡泡。

   1. 選擇 **刪除**。

   1. 遵循刪除指示。

1. 刪除所有使用者和空間後，請選擇**網域設定**索引標籤。

1. 尋找**刪除網域**區段。

1. 選擇**刪除網域**。如果此按鈕不可用，您必須重複上述步驟來刪除所有空間和使用者。

1. 遵循刪除指示。

## 刪除 Amazon SageMaker AI 網域 (AWS 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
   ```