

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Desasociación y eliminación de los recursos de imágenes personalizadas
<a name="studio-updated-byoi-how-to-detach-from-domain"></a>

En la siguiente página se proporcionan instrucciones sobre cómo separar las imágenes personalizadas y limpiar los recursos relacionados mediante la consola Amazon SageMaker AI o el AWS Command Line Interface (AWS CLI). 

**importante**  
Primero debes separar la imagen personalizada de tu dominio antes de eliminarla del almacén de imágenes de SageMaker IA. De lo contrario, es posible que se produzcan errores al consultar la información de su dominio o al asociar nuevas imágenes personalizadas a su dominio.   
Si se produce un error al cargar una imagen personalizada, consulte [Error al cargar la imagen personalizada](studio-updated-troubleshooting.md#studio-updated-troubleshooting-custom-image). 

## Desasociación y eliminación de imágenes personalizadas (consola)
<a name="studio-updated-byoi-how-to-detach-from-domain-console"></a>

A continuación, se proporcionan instrucciones sobre cómo separar tus imágenes personalizadas de la SageMaker IA y limpiar tus recursos de imágenes personalizadas mediante la consola.

**Desasociación de la imagen personalizada de su dominio**

1. Abre la [consola de SageMaker IA.](https://console.aws.amazon.com/sagemaker)

1. Amplíe la sección **Configuraciones de administración**.

1. En **Configuraciones de administración**, elija **Dominios**.

1. En la lista de **dominios**, seleccione un dominio.

1. Abra la pestaña **Entorno**.

1. En el caso de **Imágenes personalizadas para aplicaciones de Studio personales**, seleccione las casillas de verificación de las imágenes que quiere desasociar.

1. Elija **Desasociar**.

1. Siga las instrucciones para desasociar.

**Eliminación de la imagen personalizada**

1. Abre la [consola de SageMaker IA](https://console.aws.amazon.com/sagemaker).

1. Expanda la sección **Configuraciones de administración**, si aún no lo ha hecho.

1. En **Configuraciones de administrador**, elija **Imágenes**.

1. En la lista de **imágenes**, seleccione la imagen que quiera eliminar.

1. Elija **Eliminar**.

1. Sigue las instrucciones para eliminar tu imagen y todas sus versiones de la SageMaker IA.

**Eliminación de las imágenes personalizadas y el repositorio de Amazon ECR**
**importante**  
De este modo, también se eliminarán todas las imágenes y artefactos del contenedor que se encuentren en ese repositorio.

1. Abra la [consola de Amazon ECR](https://console.aws.amazon.com/ecr).

1. Expanda el panel de navegación de la izquierda, si todavía no lo ha hecho.

1. En **Registro privado**, seleccione **Repositorios**.

1. Seleccione los repositorios que desea eliminar.

1. Elija **Eliminar**.

1. Siga las instrucciones para eliminar.

## Desasociación y eliminación de imágenes personalizadas (AWS CLI)
<a name="studio-updated-byoi-how-to-detach-from-domain-cli"></a>

En la siguiente sección se muestra un ejemplo de cómo desasociar las imágenes personalizadas desde la AWS CLI.

1. Primero configura tus variables para los AWS CLI comandos siguientes.

   ```
   ACCOUNT_ID=account-id
   REGION=aws-region
   APP_IMAGE_CONFIG=app-image-config
   SAGEMAKER_IMAGE_NAME=custom-image-name
   ```
   + `aws-region`es el Región de AWS de tu dominio de Amazon SageMaker AI. Puedes encontrarlo en la parte superior derecha de cualquier página de AWS consola. 
   + `app-image-config` es el nombre de la configuración de la imagen de su aplicación. Utilice el siguiente AWS CLI comando para enumerar las configuraciones de imagen de la aplicación en su Región de AWS.

     ```
     aws sagemaker list-app-image-configs \
            --region ${REGION}
     ```
   + `custom-image-name` es el nombre de la imagen personalizada. Utilice el siguiente AWS CLI comando para enumerar las imágenes de su Región de AWS.

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

1. Para desasociar la imagen y las versiones de la imagen de su dominio siguiendo estas instrucciones, tendrás que crear o actualizar un archivo json de configuración del dominio.
**nota**  
Si ha seguido las instrucciones que se indican en [Asociación de la imagen personalizada a su dominio](studio-updated-byoi-how-to-attach-to-domain.md), es posible que haya actualizado su dominio con el archivo denominado `update-domain.json`.   
Si no tiene ese archivo, puede crear un nuevo archivo json en su lugar.

   Cree un archivo denominado `update-domain.json` que utilizará para actualizar su dominio.

1. Para eliminar las imágenes personalizadas, tendrá que dejar `CustomImages` en blanco, como, por ejemplo, `"CustomImages": []`. Elija una de las siguientes opciones para ver ejemplos de archivos de configuración para Code Editor o JupyterLab.

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

   Ejemplo de archivo de configuración para Editor de código donde se utiliza [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 ]

   Un ejemplo de archivo de configuración para JupyterLab, utilizando [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` es el ID de dominio al que está asociada su imagen. Utilice el siguiente comando para enumerar sus dominios.

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

1. Guarde el archivo.

1. Llame al [dominio de actualización](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html) AWS CLI mediante el archivo de configuración del dominio de actualización,. `update-domain.json`
**nota**  
Para poder actualizar las imágenes personalizadas, primero debe eliminar todas las **aplicaciones** de su dominio. **No** necesita eliminar los perfiles de usuario ni los espacios compartidos. Para obtener instrucciones sobre cómo eliminar aplicaciones, elija una de las siguientes opciones.  
Si desea utilizar la consola de SageMaker IA, consulte. [Cierre los recursos de SageMaker IA de su dominio](sm-console-domain-resources-shut-down.md)
Si desea utilizar la AWS CLI, siga los pasos 1 a 3 de[Eliminar un dominio de 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. Elimine la configuración de imágenes de la aplicación.

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

1. Elimine la imagen personalizada. Esto también elimina todas las versiones de la imagen. Esto no elimina la imagen del contenedor de Amazon ECR ni las versiones de la imagen. Para ello, siga los pasos opcionales que se indican a continuación.

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

1. (Opcional) Elimine los recursos de Amazon ECR. La siguiente lista proporciona AWS CLI comandos para obtener la información de recursos de Amazon ECR para los pasos que se indican a continuación.

   1. Configure sus variables para los AWS CLI comandos siguientes.

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

      `ecr-repository-name` es el nombre de su repositorio de Amazon Elastic Container Registry. 

      Para obtener una lista de los detalles de sus repositorios, utilice el siguiente comando.

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

   1. Elimine su repositorio de Amazon ECR. 
**importante**  
De este modo, también se eliminarán todas las imágenes y artefactos del contenedor que se encuentren en ese repositorio.

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