

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Scollegamento e pulizia delle risorse delle immagini personalizzate
<a name="studio-updated-byoi-how-to-detach-from-domain"></a>

La pagina seguente fornisce istruzioni su come scollegare le immagini personalizzate e ripulire le risorse correlate utilizzando la console Amazon SageMaker AI o il AWS Command Line Interface (AWS CLI). 

**Importante**  
Devi prima scollegare l'immagine personalizzata dal tuo dominio prima di eliminarla dall'archivio di immagini SageMaker AI. Se non lo fai, potrebbero verificarsi errori durante la visualizzazione delle informazioni sul dominio o il collegamento di nuove immagini personalizzate al dominio.   
Se riscontri un errore durante il caricamento di un’immagine personalizzata, consulta [Errore durante il caricamento dell’immagine personalizzata](studio-updated-troubleshooting.md#studio-updated-troubleshooting-custom-image). 

## Scollegamento ed eliminazione delle immagini personalizzate (console)
<a name="studio-updated-byoi-how-to-detach-from-domain-console"></a>

Di seguito vengono fornite istruzioni su come scollegare le immagini personalizzate dall' SageMaker intelligenza artificiale e ripulire le risorse di immagini personalizzate utilizzando la console.

**Scollegamento dell’immagine personalizzata dal dominio**

1. Apri la [console SageMaker AI](https://console.aws.amazon.com/sagemaker).

1. Espandi la sezione **Configurazioni di amministrazione**.

1. In **Configurazioni admin**, scegli **Domini**.

1. Scegli un dominio dall’elenco **Domini**.

1. Apri la scheda **Ambiente**.

1. In **Immagini personalizzate per app Studio personali**, seleziona le caselle di controllo relative alle immagini da scollegare.

1. Seleziona **Scollega**.

1. Segui le istruzioni per scollegare le immagini.

**Eliminazione dell’immagine personalizzata**

1. Apri la [console SageMaker AI](https://console.aws.amazon.com/sagemaker).

1. Espandi la sezione **Configurazioni di amministrazione**, se non l’hai già fatto.

1. In **Configurazioni admin**, scegli **Immagini**.

1. Seleziona l’immagine da eliminare dall’elenco **Immagini**.

1. Scegli **Elimina**.

1. Segui le istruzioni per eliminare la tua immagine e tutte le sue versioni dall' SageMaker IA.

**Eliminazione di immagini e repository personalizzati da Amazon ECR**
**Importante**  
Questa operazione eliminerà anche tutte le immagini e gli artefatti del container in questo repository.

1. Apri la [console di Amazon ECR](https://console.aws.amazon.com/ecr).

1. Se non l’hai ancora fatto, espandi il riquadro di navigazione a sinistra.

1. In **Registro privato**, scegli **Repository**.

1. Seleziona i repository da eliminare.

1. Scegli **Elimina**.

1. Segui le istruzioni per l’eliminazione.

## Scollega ed elimina immagini personalizzate (AWS CLI)
<a name="studio-updated-byoi-how-to-detach-from-domain-cli"></a>

La sezione seguente mostra un esempio di come scollegare le immagini personalizzate utilizzando la AWS CLI.

1. Per prima cosa imposta le variabili per i AWS CLI comandi che seguono.

   ```
   ACCOUNT_ID={{account-id}}
   REGION={{aws-region}}
   APP_IMAGE_CONFIG={{app-image-config}}
   SAGEMAKER_IMAGE_NAME={{custom-image-name}}
   ```
   + `{{aws-region}}`è il dominio Amazon SageMaker AI Regione AWS del tuo dominio Amazon. Puoi trovarlo in alto a destra in qualsiasi pagina della AWS console. 
   + `{{app-image-config}}` è il nome della configurazione dell’immagine dell’applicazione. Usa il seguente AWS CLI comando per elencare le configurazioni delle immagini dell'applicazione nel tuo Regione AWS.

     ```
     aws sagemaker list-app-image-configs \
            --region ${REGION}
     ```
   + `{{custom-image-name}}` è il nome dell’immagine personalizzata. Usa il seguente AWS CLI comando per elencare le immagini presenti nel tuo Regione AWS.

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

1. Per scollegare l’immagine e le versioni dell’immagine dal dominio utilizzando questa procedura, dovrai creare o aggiornare un file json per la configurazione del dominio.
**Nota**  
Se hai seguito le istruzioni riportate in [Collegamento dell’immagine personalizzata al dominio](studio-updated-byoi-how-to-attach-to-domain.md), è probabile che il dominio sia stato aggiornato con il file denominato `update-domain.json`.   
Se non hai questo file, puoi creare un nuovo file json.

   Crea un file denominato `update-domain.json` da utilizzare per aggiornare il dominio.

1. Per eliminare le immagini personalizzate, dovrai lasciare vuoto il campo `CustomImages`, ad esempio `"CustomImages": []`. Scegliete una delle seguenti opzioni per visualizzare file di configurazione di esempio per Code Editor o JupyterLab.

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

   Un file di configurazione di esempio per l’Editor di codice che utilizza [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 esempio di file di configurazione per JupyterLab, using [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}}` è l’ID dominio a cui è collegata l’immagine. Utilizza il comando seguente per elencare i tuoi domini.

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

1. Salvare il file.

1. Chiama il [dominio di aggiornamento](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html) AWS CLI utilizzando il file di configurazione del dominio di aggiornamento,. `update-domain.json`
**Nota**  
Prima di aggiornare le immagini personalizzate, devi eliminare tutte le **applicazioni** nel dominio. **Non** è necessario eliminare i profili utente o gli spazi condivisi. Per istruzioni sull’eliminazione delle applicazioni, scegli una delle opzioni seguenti.  
Se desideri utilizzare la console SageMaker AI, consulta. [Chiudi le risorse di SageMaker intelligenza artificiale nel tuo dominio](sm-console-domain-resources-shut-down.md)
Se desideri utilizzare il AWS CLI, segui i passaggi da 1 a 3 di[Eliminare un dominio 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. Elimina la configurazione dell'immagine dell'app.

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

1. Elimina l’immagine personalizzata. Questa operazione elimina anche tutte le versioni dell’immagine, ma non l’immagine e le versioni dell’immagine del container Amazon ECR. A tale scopo, utilizza le fasi facoltative riportate di seguito.

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

1. (Facoltativo) Elimina le risorse Amazon ECR. L'elenco seguente fornisce AWS CLI i comandi per ottenere informazioni sulle risorse Amazon ECR per i passaggi seguenti.

   1. Imposta le variabili per i AWS CLI comandi che seguono.

      ```
      ECR_REPO_NAME={{ecr-repository-name}}
      ```

      `{{ecr-repository-name}}` è il nome del repository Amazon Elastic Container Registry. 

      Per elencare i dettagli dei repository, utilizza il comando seguente.

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

   1. Elimina il repository da Amazon ECR. 
**Importante**  
Questa operazione eliminerà anche tutte le immagini e gli artefatti del container in questo repository.

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