

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á.

# Desanexar imagens personalizadas e limpar os recursos correspondentes
<a name="studio-updated-byoi-how-to-detach-from-domain"></a>

A página a seguir fornece instruções sobre como separar suas imagens personalizadas e limpar os recursos relacionados usando o console Amazon SageMaker AI ou o AWS Command Line Interface (AWS CLI). 

**Importante**  
Primeiro, você deve separar sua imagem personalizada do seu domínio antes de excluí-la do armazenamento de imagens de SageMaker IA. Do contrário, você poderá receber erros ao visualizar as informações do seu domínio ou anexar novas imagens personalizadas ao seu domínio.   
Se você estiver recebendo um erro ao carregar uma imagem personalizada, consulte [Falha ao carregar a imagem personalizada](studio-updated-troubleshooting.md#studio-updated-troubleshooting-custom-image). 

## Desanexar e excluir imagens personalizadas (console)
<a name="studio-updated-byoi-how-to-detach-from-domain-console"></a>

Veja a seguir instruções sobre como separar suas imagens personalizadas da SageMaker IA e limpar seus recursos de imagem personalizada usando o console.

**Desanexar uma imagem personalizada do seu domínio**

1. Abra o [console de SageMaker IA](https://console.aws.amazon.com/sagemaker).

1. Expanda a seção **Configurações do administrador**.

1. Em **Configurações do administrador**, escolha **Domínios**.

1. A partir da lista de **Domínios**, escolha um domínio.

1. Abra a página de **Ambiente**.

1. Em **Imagens personalizadas para aplicações pessoais do Studio**, marque as caixas de seleção das imagens que você deseja desanexar.

1. Escolha **Desassociar**.

1. Siga as instruções para desanexar.

**Excluir uma imagem personalizada**

1. Abra o [console de SageMaker IA](https://console.aws.amazon.com/sagemaker).

1. Expanda a seção **Configurações do administrador**, se ainda não tiver feito isso.

1. Em **Configurações do administrador**, escolha **Imagens**.

1. Na lista de **Imagens**, selecione a imagem que você gostaria de excluir.

1. Escolha **Excluir**.

1. Siga as instruções para excluir sua imagem e todas as suas versões da SageMaker IA.

**Excluir imagens personalizadas e o repositório do Amazon ECR**
**Importante**  
Isso também excluirá todos os artefatos e imagens do contêiner nesse repositório.

1. Abra o [console do Amazon ECR](https://console.aws.amazon.com/ecr).

1. Se ainda não tiver feito isso, expanda o painel de navegação à esquerda.

1. Em **Registro privado**, escolha **Repositórios**.

1. Selecione os repositórios que você deseja excluir.

1. Escolha **Excluir**.

1. Siga as instruções para excluir.

## Desanexar e excluir imagens personalizadas (AWS CLI)
<a name="studio-updated-byoi-how-to-detach-from-domain-cli"></a>

A seção a seguir mostra um exemplo de como desanexar suas imagens personalizadas usando a AWS CLI.

1. Primeiro, defina suas variáveis para os AWS CLI comandos a seguir.

   ```
   ACCOUNT_ID=account-id
   REGION=aws-region
   APP_IMAGE_CONFIG=app-image-config
   SAGEMAKER_IMAGE_NAME=custom-image-name
   ```
   + `aws-region`é o Região da AWS do seu domínio Amazon SageMaker AI. Você pode encontrar isso no canto superior direito de qualquer página AWS do console. 
   + `app-image-config` é o nome da configuração da imagem da aplicação. Use o AWS CLI comando a seguir para listar as configurações de imagem do aplicativo em seu Região da AWS.

     ```
     aws sagemaker list-app-image-configs \
            --region ${REGION}
     ```
   + `custom-image-name` é o nome da imagem personalizada. Use o AWS CLI comando a seguir para listar as imagens em seu Região da AWS.

     ```
     aws sagemaker list-images \
            --region ${REGION}
     ```

1. Para desanexar a imagem e as versões correspondentes em seu domínio usando estas instruções, você precisará criar ou atualizar um arquivo json de configuração de domínio.
**nota**  
Se você seguiu as instruções em [Anexar imagem personalizada ao seu domínio](studio-updated-byoi-how-to-attach-to-domain.md), talvez tenha atualizado seu domínio usando o arquivo chamado `update-domain.json`.   
Se você não tiver esse arquivo, poderá criar outro arquivo json em vez desse.

   Crie um arquivo chamado `update-domain.json`, que você usará para atualizar seu domínio.

1. Para excluir as imagens personalizadas, você precisará deixar `CustomImages` em branco, desta forma `"CustomImages": []`. Escolha uma das opções a seguir para ver exemplos de arquivos de configuração para o Editor de código ou JupyterLab.

------
#### [ Code Editor: update domain configuration file example ]

   Um exemplo de arquivo de configuração para o Editor de Código, usando [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CodeEditorAppSettings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CodeEditorAppSettings.html).

   ```
   {
       "DomainId": "domain-id",
       "DefaultUserSettings": {
           "CodeEditorAppSettings": {
               "CustomImages": [
               ]
           }
       }
   }
   ```

------
#### [ JupyterLab: update domain configuration file example ]

   Um exemplo de arquivo de configuração para JupyterLab, usando [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_JupyterLabAppSettings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_JupyterLabAppSettings.html).

   ```
   {
       "DomainId": "domain-id",
       "DefaultUserSettings": {
           "JupyterLabAppSettings": {
               "CustomImages": [
               ]
           }
       }
   }
   ```

------

   `domain-id` é o ID do domínio ao qual sua imagem está anexada. Use o comando a seguir para listar seus domínios.

   ```
   aws sagemaker list-domains \
         --region ${REGION}
   ```

1. Salve o arquivo.

1. Chame o [update-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html) AWS CLI usando o arquivo de configuração do domínio de atualização,. `update-domain.json`
**nota**  
Para atualizar as imagens personalizadas, é necessário excluir todas as **aplicações** em seu domínio. **Não** é necessário excluir perfis de usuário ou espaços compartilhados. Para obter instruções sobre como excluir aplicações, selecione uma das opções a seguir.  
Se você quiser usar o console de SageMaker IA, consulte[Encerre os recursos de SageMaker IA em seu domínio](sm-console-domain-resources-shut-down.md).
Se você quiser usar o AWS CLI, use as etapas 1 a 3 do[Excluir um domínio do Amazon SageMaker AI (AWS CLI)](gs-studio-delete-domain.md#gs-studio-delete-domain-cli).

   ```
   aws sagemaker update-domain \
       --cli-input-json file://update-domain.json \
       --region ${REGION}
   ```

1. Exclua a configuração da imagem da aplicação.

   ```
   aws sagemaker delete-app-image-config \
       --app-image-config-name ${APP_IMAGE_CONFIG}
   ```

1. Exclua a imagem personalizada. Isso também exclui todas as versões da imagem. Mas não exclui a imagem do contêiner do Amazon ECR e as versões correspondentes. Para isso, use as etapas opcionais abaixo.

   ```
   aws sagemaker delete-image \
       --image-name ${SAGEMAKER_IMAGE_NAME}
   ```

1. (Opcional) Exclua seus recursos do Amazon ECR. A lista a seguir fornece AWS CLI comandos para obter suas informações de recursos do Amazon ECR para as etapas abaixo.

   1. Defina suas variáveis para os AWS CLI comandos a seguir.

      ```
      ECR_REPO_NAME=ecr-repository-name
      ```

      `ecr-repository-name` é o nome do seu repositório do Amazon Elastic Container Registry. 

      Para listar os detalhes dos seus repositórios, use o comando a seguir.

      ```
      aws ecr describe-repositories \
              --region ${REGION}
      ```

   1. Exclua seu repositório do Amazon ECR. 
**Importante**  
Isso também excluirá todos os artefatos e imagens do contêiner nesse repositório.

      ```
      aws ecr delete-repository \
            --repository-name ${ECR_REPO_NAME} \
            --force \
            --region ${REGION}
      ```