本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定閒置關閉
<a name="studio-updated-idle-shutdown-setup"></a>

 下列各節說明如何從主控台或使用 AWS CLI設定閒置關閉。閒置關閉可以在網域或使用者設定檔層級設定。

## 先決條件
<a name="studio-updated-idle-shutdown-setup-prereq"></a>

 若要搭配應用程式使用閒置關閉，您必須完成下列先決條件。
+ 確保您的應用程式正在使用 SageMaker Distribution (SMD) 2.0 版。您可以在應用程式建立期間選取此版本，或在建立之後更新應用程式的映像版本。如需詳細資訊，請參閱 [更新 SageMaker Distribution 映像](studio-updated-jl-update-distribution-image.md)。
+ 對於使用自訂映像建置的應用程式，如果您的自訂映像是使用 SageMaker Distribution (SMD) 2.0 版或更新版本做為基礎映像建立的，則支援閒置關閉。如果使用不同的基礎映像建立自訂映像，則您必須在映像上安裝 [jupyter-activity-monitor-extension >= 0.3.1](https://anaconda.org/conda-forge/jupyter-activity-monitor-extension) 延伸模組，並將該映像連接至 JupyterLab 應用程式的 Amazon SageMaker AI 網域。如需自訂映像的詳細資訊，請參閱[自帶映像 (BYOI)](studio-updated-byoi.md)。

## 從主控台
<a name="studio-updated-idle-shutdown-setup-console"></a>

 下列各節說明如何從主控台啟用閒置關閉。

### 在建立新網域時新增
<a name="studio-updated-idle-shutdown-setup-console-new-domain"></a>

1. 遵循 [使用 Amazon SageMaker AI 的自訂設定](onboard-custom.md) 中的步驟建立網域。

1.  在網域中設定應用程式設定時，導覽至程式碼編輯器或 JupyterLab 區段。  

1.  選取**啟用閒置關閉**。

1.  輸入預設閒置關閉時間，以分鐘為單位。如果未輸入任何值，則此值預設為 `10,080`。

1.  (選用) 選取**允許使用者設定自訂閒置關閉時間**，以允許使用者修改閒置關閉時間。
   +  輸入使用者可以設定預設閒置關閉時間的上限值。您必須輸入上限值。下限值由 Amazon SageMaker AI 設定，且必須為 `60`。

### 新增至現有網域
<a name="studio-updated-idle-shutdown-setup-console-existing-domain"></a>

**注意**  
如果在應用程式執行時設定閒置關閉，則必須重新啟動它們，閒置關閉設定才會生效。

1.  導覽至網域。

1.  選擇**應用程式組態**索引標籤。

1.  從**應用程式組態**索引標籤中，導覽至程式碼編輯器或 JupyterLab 區段。

1.  選擇 **Edit** (編輯)。

1.  選取**啟用閒置關閉**。

1.  輸入預設閒置關閉時間，以分鐘為單位。如果未輸入任何值，則此值預設為 `10,080`。

1.  (選用) 選取**允許使用者設定自訂閒置關閉時間**，以允許使用者修改閒置關閉時間。
   +  輸入使用者可以設定預設閒置關閉時間的上限值。您必須輸入上限值。下限值由 Amazon SageMaker AI 設定，且必須為 `60`。

1.  選取**提交**。

### 建立新使用者設定檔時新增
<a name="studio-updated-idle-shutdown-setup-console-new-userprofile"></a>

1. 遵循[新增使用者設定檔](domain-user-profile-add.md)中的步驟新增使用者設定檔 

1.  設定使用者設定檔的應用程式設定時，請導覽至程式碼編輯器或 JupyterLab 區段。

1.  選取**啟用閒置關閉**。

1.  輸入預設閒置關閉時間，以分鐘為單位。如果未輸入任何值，則此值預設為 `10,080`。

1.  (選用) 選取**允許使用者設定自訂閒置關閉時間**，以允許使用者修改閒置關閉時間。
   +  輸入使用者可以設定預設閒置關閉時間的上限值。您必須輸入上限值。下限值由 Amazon SageMaker AI 設定，且必須為 `60`。

1.  選取「儲存變更」。

### 新增至現有的使用者設定檔
<a name="studio-updated-idle-shutdown-setup-console-existing-userprofile"></a>

 注意：如果在應用程式執行時設定閒置關閉，則必須重新啟動它們，閒置關閉設定才會生效。

1.  導覽至使用者設定檔。

1.  選擇**應用程式組態**索引標籤。

1.  從****應用程式組態****索引標籤中，導覽至程式碼編輯器或 JupyterLab 區段。  

1.  選擇 **Edit** (編輯)。

1.  若是針對網域設定的，閒置關閉設定預設會顯示網域設定。

1.  選取**啟用閒置關閉**。

1.  輸入預設閒置關閉時間，以分鐘為單位。如果未輸入任何值，則此值預設為 `10,080`。

1.  (選用) 選取**允許使用者設定自訂閒置關閉時間**，以允許使用者修改閒置關閉時間。
   +  輸入使用者可以設定預設閒置關閉時間的上限值。您必須輸入上限值。下限值由 Amazon SageMaker AI 設定，且必須為 `60`。

1.  選取 **Save Changes** (儲存變更)。

## 從 AWS CLI
<a name="studio-updated-idle-shutdown-setup-cli"></a>

 下列各節說明如何使用 AWS CLI啟用閒置關閉。

**注意**  
若要從 強制執行特定逾時值 AWS CLI，您必須`MinIdleTimeoutInMinutes`將 `IdleTimeoutInMinutes`、 `MaxIdleTimeoutInMinutes`和 設定為相同的值。

### 網域
<a name="studio-updated-idle-shutdown-setup-cli-domain"></a>

 下列命令顯示如何在更新現有網域時啟用閒置關閉。若要為新網域新增閒置關閉，請改用 `create-domain` 命令。

**注意**  
如果在應用程式執行時設定閒置關閉，則必須重新啟動它們，閒置關閉設定才會生效。

```
aws sagemaker update-domain --region region --domain-id domain-id \
--default-user-settings file://default-user-settings.json

## default-user-settings.json example for enforcing the default timeout
{
    "JupyterLabAppSettings": {
        "AppLifecycleManagement": {
            "IdleSettings": {
                "LifecycleManagement": "ENABLED",
                "IdleTimeoutInMinutes": 120,
                "MaxIdleTimeoutInMinutes": 120,
                "MinIdleTimeoutInMinutes": 120
        }
    }
}

## default-user-settings.json example for letting users customize the default timeout, between 2-5 hours
{
    "JupyterLabAppSettings": {
        "AppLifecycleManagement": {
            "IdleSettings": {
                "LifecycleManagement": "ENABLED",
                "IdleTimeoutInMinutes": 120,
                "MinIdleTimeoutInMinutes": 120,
                "MaxIdleTimeoutInMinutes": 300
        }
    }
}
```

### 使用者設定檔
<a name="studio-updated-idle-shutdown-setup-cli-userprofile"></a>

 下列命令顯示如何在更新現有使用者設定檔時啟用閒置關閉。若要為新的使用者設定檔新增閒置關閉，請改用 `create-user-profile` 命令。

**注意**  
如果在應用程式執行時設定閒置關閉，則必須重新啟動它們，閒置關閉設定才會生效。

```
aws sagemaker update-user-profile --region region --domain-id domain-id \
--user-profile-name user-profile-name --user-settings file://user-settings.json

## user-settings.json example for enforcing the default timeout
{
    "JupyterLabAppSettings": {
        "AppLifecycleManagement": {
            "IdleSettings": {
                "LifecycleManagement": "ENABLED",
                "IdleTimeoutInMinutes": 120,
                "MaxIdleTimeoutInMinutes": 120,
                "MinIdleTimeoutInMinutes": 120
        }
    }
}

## user-settings.json example for letting users customize the default timeout, between 2-5 hours
{
    "JupyterLabAppSettings": {
        "AppLifecycleManagement": {
            "IdleSettings": {
                "LifecycleManagement": "ENABLED",
                "IdleTimeoutInMinutes": 120,
                "MinIdleTimeoutInMinutes": 120,
                "MaxIdleTimeoutInMinutes": 300
        }
    }
}
```