As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Excluir um domínio da Amazon SageMaker AI
Esta página explica como excluir um domínio e os requisitos necessários. Um domínio consiste de uma lista de usuários autorizados, definições de configuração e um volume do Amazon Elastic File System (Amazon EFS). O volume do Amazon EFS contém dados para os usuários, incluindo cadernos, recursos e artefatos. Um usuário pode ter várias aplicações compatíveis com a experiência de leitura e execução dos cadernos, terminais e consoles do usuário. Você pode excluir seu domínio usando uma das formas a seguir:
+ AWS console
+ AWS Command Line Interface (AWS CLI)
+ SageMaker SDK
## Requisitos
Você deve atender aos seguintes requisitos para excluir um domínio:
+ Você deve ter permissão de administrador para excluir um domínio.
+ Você só pode excluir uma aplicação com o status `InService` exibido como **Pronto** no domínio. Uma aplicação cujo status seja `Failed` não precisa ser excluído para excluir o domínio que o contém. No domínio, a tentativa de excluir uma aplicação no estado com falha resulta em erro.
+ Para que um domínio possa ser excluído, ele não pode conter nenhum perfil de usuário ou espaços compartilhados. Para excluir um perfil de usuário ou um espaço compartilhado, o perfil ou o espaço compartilhado não pode conter nenhuma aplicação sem falha.
Quando você exclui esses recursos, ocorre o seguinte:
+ Aplicação: os dados (arquivos e cadernos) no diretório pessoal de um usuário são salvos. Os dados do caderno não salvos são perdidos.
+ Perfil de usuário: o usuário não pode mais fazer login no domínio. O usuário perde o acesso ao diretório inicial, mas os dados não são excluídos. Um administrador pode recuperar os dados do volume do Amazon EFS em que são armazenados sob a conta da Conta da AWS do usuário.
+ Para alternar os modos de autenticação do IAM para o Centro de Identidade do IAM, você precisa excluir o domínio.
## Arquivos EFS
Seus arquivos são mantidos em um volume do Amazon EFS como backup. Esse backup inclui os arquivos no diretório montado, que é `/home/sagemaker-user` para o Amazon SageMaker Studio Classic e `/root` para kernels.
Quando você exclui arquivos desses diretórios montados, o kernel ou a aplicação pode mover os arquivos excluídos para uma pasta de lixo oculta. Se a pasta de lixo estiver dentro do diretório montado, esses arquivos serão copiados para o volume do Amazon EFS e serão cobrados. Para evitar essas cobranças do Amazon EFS, você deve identificar e limpar a localização da pasta de lixo. A localização da pasta de lixo para aplicações e kernels padrão é `~/.local/`. Isso pode variar dependendo da distribuição Linux usada para aplicações ou kernels personalizados. Para obter mais informações sobre volume do Amazon EFS, consulte [Gerencie seu volume de armazenamento do Amazon EFS no Amazon SageMaker Studio Classic](studio-tasks-manage-storage.md).
Quando você usa o console de SageMaker IA para excluir o domínio, o volume do Amazon EFS é desanexado, mas não excluído. O mesmo comportamento ocorre por padrão quando você usa o SDK AWS CLI ou o SageMaker Python para excluir o domínio. No entanto, ao usar o SDK AWS CLI ou o SageMaker Python, você pode definir o. `RetentionPolicy` `HomeEfsFileSystem=Delete` Isso exclui o volume do Amazon EFS junto com o domínio.
## Excluir um domínio do Amazon SageMaker AI (console)
**Importante**
Quando um usuário, espaço ou domínio é excluído, o volume do Amazon EFS que contém os dados correspondentes é perdido. Isso inclui cadernos e outros artefatos.
**Como excluir um domínio**
1. Abra o [console de SageMaker IA](https://console.aws.amazon.com/sagemaker/).
1. No painel de navegação à esquerda, escolha **Configurações do administrador** para expandir as opções, se elas ainda não estiverem expandidas.
1. Em **Configurações do administrador**, escolha **Domínios**.
1. Selecione o domínio que deseja excluir.
1. Escolha a guia **Perfis de usuário**.
1. Repita as etapas a seguir para cada usuário na lista **Perfis de usuário**.
1. Selecione o link do nome de usuário.
1. Escolha a guia **Detalhes do usuário** se ainda não estiver selecionada.
1. Encontre quaisquer espaços e aplicações e escolha **Excluir** na coluna **Ação** correspondente.
1. Siga as instruções de exclusão.
1. Quando todos os espaços e aplicações tiverem o **status** **Excluído**, escolha **Excluir** no canto superior direito da página.
1. Siga as instruções de exclusão.
1. Quando todos os usuários forem excluídos, escolha a guia **Gerenciamento de espaço**.
1. Repita as etapas a seguir para cada espaço na lista **Espaços**.
1. Selecione a bolha correspondente ao espaço.
1. Escolha **Excluir**.
1. Siga as instruções de exclusão.
1. Quando todos os usuários e espaços forem excluídos, escolha a guia **Configurações do domínio**.
1. Encontre a seção **Excluir domínio**.
1. Escolha **Delete domain.** Se esse botão não estiver disponível, repita as etapas anteriores para excluir todos os espaços e usuários.
1. Siga as instruções de exclusão.
## Excluir um domínio do Amazon SageMaker AI (AWS CLI)
**Como excluir um domínio**
1. Recupere a lista de domínios na conta.
```
aws --region Region sagemaker list-domains
```
1. Recupere a lista de aplicações para o domínio a ser excluído.
```
aws --region Region sagemaker list-apps \
--domain-id-equals DomainId
```
1. Exclua cada aplicação da lista.
```
aws --region Region sagemaker delete-app \
--domain-id DomainId \
--app-name AppName \
--app-type AppType \
--user-profile-name UserProfileName
```
1. Recupere a lista de perfis de usuário no domínio.
```
aws --region Region sagemaker list-user-profiles \
--domain-id-equals DomainId
```
1. Exclua cada perfil de usuário da lista.
```
aws --region Region sagemaker delete-user-profile \
--domain-id DomainId \
--user-profile-name UserProfileName
```
1. Recupere a lista de espaços compartilhados no domínio.
```
aws --region Region sagemaker list-spaces \
--domain-id DomainId
```
1. Exclua cada espaço compartilhado na lista.
```
aws --region Region sagemaker delete-space \
--domain-id DomainId \
--space-name SpaceName
```
1. Exclua o domínio. Para também excluir o volume do Amazon EFS, especifique `HomeEfsFileSystem=Delete`.
```
aws --region Region sagemaker delete-domain \
--domain-id DomainId \
--retention-policy HomeEfsFileSystem=Retain
```