翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# カスタムイメージのリソースをデタッチしてクリーンアップする
<a name="studio-updated-byoi-how-to-detach-from-domain"></a>

次のページでは、Amazon SageMaker AI コンソールまたは AWS Command Line Interface () を使用してカスタムイメージをデタッチし、関連リソースをクリーンアップする方法について説明しますAWS CLI。

**重要**  
SageMaker AI イメージストアからイメージを削除する前に、まずドメインからカスタムイメージをデタッチする必要があります。デタッチしないと、ドメイン情報の表示時やドメインへの新しいカスタムイメージのアタッチ時にエラーが発生する可能性があります。  
カスタムイメージのロード中でエラーが発生した場合は、「[カスタムイメージのロードに失敗しました](studio-updated-troubleshooting.md#studio-updated-troubleshooting-custom-image)」を参照してください。

## カスタムイメージをデタッチして削除する (コンソール）
<a name="studio-updated-byoi-how-to-detach-from-domain-console"></a>

コンソールを使用して、カスタムイメージを SageMaker AI からデタッチし、カスタムイメージのリソースをクリーンアップする方法について説明します。

**カスタムイメージをドメインからデタッチする**

1. [SageMaker AI コンソール](https://console.aws.amazon.com/sagemaker)を開きます。

1. **[管理者設定]** セクションを展開します。

1. **[管理設定]** で、**[ドメイン]** を選択します。

1. **[ドメイン]** リストで、ドメインを選択します。

1. **[環境]** タブを開きます。

1. **[パーソナル Studio アプリ用のカスタムイメージ]** の場合は、デタッチするイメージのチェックボックスをオンにします。

1. **[デタッチ]** を選択します。

1. デタッチする指示に従ってください。

**カスタムイメージを削除する**

1. [SageMaker AI コンソール](https://console.aws.amazon.com/sagemaker)を開きます。

1. **[管理者設定]** セクションが展開されていない場合は、展開します。

1. **[管理設定]** で **[イメージ]** を選択します。

1. **[イメージ]** のリストから、削除するイメージを選択します。

1. **[削除]** を選択します。

1. 指示に従って、SageMaker AI からイメージとイメージのすべてのバージョンを削除します。

**Amazon ECR リポジトリからカスタムイメージとリポジトリを削除する**
**重要**  
これにより、このリポジトリ内のコンテナイメージとアーティファクトもすべて削除されます。

1. [[Amazon ECR コンソール]](https://console.aws.amazon.com/ecr) を開きます。

1. まだ展開されていない場合は、左側のナビゲーションペインを展開します。

1. **[プライベートレジストリ]** で、**[リポジトリ]** をクリックします。

1. 削除するリポジトリを選択します。

1. **[削除]** を選択します。

1. 削除する指示に従ってください。

## カスタムイメージをデタッチして削除する (AWS CLI）
<a name="studio-updated-byoi-how-to-detach-from-domain-cli"></a>

次のセクションでは、 AWS CLIを使用してカスタムイメージをデタッチする方法の例を示します。

1. まず、以下の AWS CLI コマンドの変数を設定します。

   ```
   ACCOUNT_ID=account-id
   REGION=aws-region
   APP_IMAGE_CONFIG=app-image-config
   SAGEMAKER_IMAGE_NAME=custom-image-name
   ```
   + `aws-region` は、Amazon SageMaker AI ドメイン AWS リージョン の です。これは、任意の AWS コンソールページの右上にあります。
   + `app-image-config` は、アプリケーションイメージの設定の名前です。次の AWS CLI コマンドを使用して、 のアプリケーションイメージ設定を一覧表示します AWS リージョン。

     ```
     aws sagemaker list-app-image-configs \
            --region ${REGION}
     ```
   + `custom-image-name` は、カスタムイメージ名です。次の AWS CLI コマンドを使用して、 内のイメージを一覧表示します AWS リージョン。

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

1. これらの手順を使用して、イメージとイメージバージョンをドメインからデタッチするには、ドメイン設定の JSON ファイルを作成または更新する必要があります。
**注記**  
「[カスタムイメージをドメインにアタッチする](studio-updated-byoi-how-to-attach-to-domain.md)」の手順に従った場合、`update-domain.json` という名前のファイルを使用してドメインを更新した可能性があります。  
そのファイルがない場合は、代わりに新しい JSON ファイルを作成できます。

   ドメインの更新に使用する `update-domain.json` という名前のファイルを作成します。

1. カスタムイメージを削除するには、`CustomImages` を空白のままにして、例えば `"CustomImages": []` とする必要があります。Code Editor または JupyterLab の設定ファイルの例を表示するには、次のいずれかを選択します。

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

   [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CodeEditorAppSettings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CodeEditorAppSettings.html) を使用した Code Editor の設定ファイルの例。

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

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

   [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_JupyterLabAppSettings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_JupyterLabAppSettings.html) を使用した JupyterLab の設定ファイルの例。

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

------

   `domain-id` は、イメージがアタッチされているドメイン ID です。ドメインの一覧を表示するには、以下のコマンドを使用します。

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

1. ファイルを保存します。

1. [更新ドメイン設定ファイル を使用して update-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html) AWS CLI を呼び出します`update-domain.json`。
**注記**  
カスタムイメージを更新する前に、ドメイン内のすべての**アプリケーション**を削除する必要があります。ユーザープロファイルや共有スペースは、削除する必要は**ありません**。アプリケーションを削除する手順については、次のいずれかのオプションを選択します。  
SageMaker AI コンソールを使用する場合は、「[ドメイン内の SageMaker AI リソースをシャットダウンする](sm-console-domain-resources-shut-down.md)」を参照してください。
を使用する場合は AWS CLI、 のステップ 1～3 を使用します[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. アプリケーションイメージ構成を削除します。

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

1. カスタムイメージを削除します。これにより、すべてのイメージバージョンも削除されます。Amazon ECR コンテナイメージとイメージバージョンは削除されません。これを行うには、以下のオプションの手順を使用します。

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

1. (オプション) Amazon ECR リソースを削除します。次のリストは、以下の手順の Amazon ECR リソース情報を取得するための AWS CLI コマンドを示しています。

   1. 以下の AWS CLI コマンドの変数を設定します。

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

      `ecr-repository-name` は、Amazon Elastic Container Registry リポジトリの名前です。

      リポジトリの詳細を一覧表示するには、以下のコマンドを使用します。

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

   1. Amazon ECR からレポジトリを削除する 
**重要**  
これにより、このリポジトリ内のコンテナイメージとアーティファクトもすべて削除されます。

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