

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Trennen und Bereinigen von benutzerdefinierten Image-Ressourcen
<a name="studio-updated-byoi-how-to-detach-from-domain"></a>

Auf der folgenden Seite finden Sie Anweisungen zum Trennen Ihrer benutzerdefinierten Bilder und zum Bereinigen der zugehörigen Ressourcen mithilfe der Amazon SageMaker AI-Konsole oder der AWS Command Line Interface (AWS CLI). 

**Wichtig**  
Sie müssen zuerst Ihr benutzerdefiniertes Bild von Ihrer Domain trennen, bevor Sie das Bild aus dem SageMaker AI-Image-Speicher löschen können. Andernfalls können beim Anzeigen Ihrer Domain-Informationen oder beim Anfügen neuer benutzerdefinierter Images an Ihre Domain Fehler auftreten.   
Falls beim Laden eines benutzerdefinierten Images ein Fehler auftritt, finden Sie weitere Informationen unter [Benutzerdefiniertes Image konnte nicht geladen werden](studio-updated-troubleshooting.md#studio-updated-troubleshooting-custom-image). 

## Trennen und Löschen benutzerdefinierter Images (Konsole)
<a name="studio-updated-byoi-how-to-detach-from-domain-console"></a>

Im Folgenden finden Sie Anweisungen, wie Sie Ihre benutzerdefinierten Bilder von SageMaker KI trennen und Ihre benutzerdefinierten Image-Ressourcen mithilfe der Konsole bereinigen können.

**Trennen des benutzerdefinierten Images von der Domain**

1. Öffnen Sie die [SageMaker AI-Konsole](https://console.aws.amazon.com/sagemaker).

1. Erweitern Sie den Abschnitt **Admin-Konfigurationen**.

1. Wählen Sie unter **Admin-Konfigurationen** **Domains** aus.

1. Wählen Sie aus der Liste der **Domains** eine Domain aus.

1. Öffnen Sie die Registerkarte **Umgebung**.

1. Aktivieren Sie für **Benutzerdefinierte Images für persönliche Studio-Apps** die Kontrollkästchen für die Images, die Sie trennen möchten.

1. Wählen Sie **Trennen** aus.

1. Befolgen Sie die Anweisungen zum Trennen.

**Löschen des benutzerdefinierten Images**

1. Öffnen Sie die [SageMaker AI-Konsole](https://console.aws.amazon.com/sagemaker).

1. Erweitern Sie den Abschnitt **Admin-Konfigurationen**, falls dies noch nicht geschehen ist.

1. Wählen Sie unter **Admin-Konfigurationen** die Option **Images**.

1. Wählen Sie aus der Liste der **Images** ein Image aus, das Sie löschen möchten.

1. Wählen Sie **Löschen** aus.

1. Folgen Sie den Anweisungen, um Ihr Bild und all seine Versionen aus SageMaker AI zu löschen.

**Löschen von benutzerdefinierten Images und Repository aus Amazon ECR**
**Wichtig**  
Dadurch werden auch alle Container-Images und Artefakte in diesem Repository gelöscht.

1. Öffnen Sie die [Amazon-ECR-Konsole](https://console.aws.amazon.com/ecr).

1. Erweitern Sie den linken Navigationsbereich, falls dies noch nicht der Fall ist.

1. Wählen Sie unter **Private Registrierung** die Option **Repositorys** aus.

1. Wählen Sie die Repositorys aus, die Sie löschen möchten.

1. Wählen Sie **Löschen** aus.

1. Befolgen Sie die Anweisungen zum Löschen.

## Trennen und Löschen benutzerdefinierter Images (AWS CLI)
<a name="studio-updated-byoi-how-to-detach-from-domain-cli"></a>

Der folgende Abschnitt zeigt ein Beispiel dafür, wie Sie Ihre benutzerdefinierten Images mit der AWS CLI trennen können.

1. Stellen Sie zunächst Ihre Variablen für die folgenden AWS CLI Befehle ein.

   ```
   ACCOUNT_ID=account-id
   REGION=aws-region
   APP_IMAGE_CONFIG=app-image-config
   SAGEMAKER_IMAGE_NAME=custom-image-name
   ```
   + `aws-region`ist die AWS-Region Ihrer Amazon SageMaker AI-Domain. Sie finden dies oben rechts auf jeder AWS Konsolenseite. 
   + `app-image-config` ist der Name Ihrer Anwendungs-Image-Konfiguration. Verwenden Sie den folgenden AWS CLI Befehl, um die Anwendungs-Image-Konfigurationen in Ihrem aufzulisten AWS-Region.

     ```
     aws sagemaker list-app-image-configs \
            --region ${REGION}
     ```
   + `custom-image-name` ist der Name des benutzerdefinierten Images. Verwenden Sie den folgenden AWS CLI Befehl, um die Bilder in Ihrem aufzulisten AWS-Region.

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

1. Um das Image und die Image-Versionen mithilfe dieser Anweisungen von Ihrer Domain zu trennen, müssen Sie eine JSON-Datei für die Domainkonfiguration erstellen oder aktualisieren.
**Anmerkung**  
Wenn Sie die Anweisungen unter [Anfügen Ihres benutzerdefinierten Images an Ihre Domain](studio-updated-byoi-how-to-attach-to-domain.md) befolgt haben, haben Sie Ihre Domain möglicherweise mithilfe der Datei `update-domain.json` aktualisiert.   
Wenn Sie diese Datei nicht haben, können Sie stattdessen eine neue JSON-Datei erstellen.

   Erstellen Sie eine Datei mit dem Namen `update-domain.json`, mit der Sie Ihre Domain aktualisieren.

1. Um die benutzerdefinierten Images zu löschen, müssen Sie `CustomImages` leer lassen, sodass es wie folgt aussieht: `"CustomImages": []` Wählen Sie eine der folgenden Optionen, um Beispielkonfigurationsdateien für den Code-Editor oder anzuzeigen JupyterLab.

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

   Ein Beispiel für eine Konfigurationsdatei für Code Editor, unter Verwendung von [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 ]

   Ein Beispiel für eine Konfigurationsdatei für JupyterLab die Verwendung von [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` ist die Domain-ID, an die Ihr Image angehängt ist. Verwenden Sie den folgenden Befehl, um die Domains aufzulisten.

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

1. Speichern Sie die Datei.

1. Rufen Sie die [Update-Domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html) AWS CLI mithilfe der Update-Domain-Konfigurationsdatei auf,. `update-domain.json`
**Anmerkung**  
Bevor Sie die benutzerdefinierten Images aktualisieren können, müssen Sie alle **Anwendungen** in Ihrer Domain löschen. Sie müssen **keine** Benutzerprofile oder gemeinsam genutzten Bereiche löschen. Wählen Sie für Anweisungen zum Löschen von Anwendungen eine der folgenden Optionen aus.  
Wenn Sie die SageMaker AI-Konsole verwenden möchten, finden Sie weitere Informationen unter. [Fahren Sie die SageMaker KI-Ressourcen in Ihrer Domain herunter](sm-console-domain-resources-shut-down.md)
Wenn Sie die verwenden möchten AWS CLI, verwenden Sie die Schritte 1 bis 3 von[Löschen Sie eine Amazon SageMaker AI-Domain (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. Löschen Sie die App-Image-Konfiguration.

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

1. Löschen Sie das benutzerdefinierte Image. Dadurch werden auch alle Image-Versionen gelöscht. Dadurch werden das Image und die Image-Versionen des Amazon-ECR-Containers nicht gelöscht. Führen Sie dazu die folgenden optionalen Schritte aus.

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

1. (Optional) Löschen Sie Ihre Amazon-ECR-Ressourcen. Die folgende Liste enthält AWS CLI Befehle zum Abrufen Ihrer Amazon ECR-Ressourceninformationen für die folgenden Schritte.

   1. Stellen Sie Ihre Variablen für die folgenden AWS CLI Befehle ein.

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

      `ecr-repository-name` ist der Name Ihres Repositorys von Amazon Elastic Container Registry. 

      Verwenden Sie den folgenden Befehl, um die Details Ihrer Repositorys aufzulisten.

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

   1. Löschen Sie das Repository aus Amazon ECR. 
**Wichtig**  
Dadurch werden auch alle Container-Images und Artefakte in diesem Repository gelöscht.

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