本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 閒置關閉
Amazon SageMaker AI 支援關閉閒置資源，以管理成本並防止因閒置、可計費資源產生的成本而導致成本超支。它透過偵測應用程式的閒置狀態，並在符合閒置條件時執行應用程式關閉來完成此操作。
SageMaker AI 支援下列應用程式的閒置關閉。必須針對每個應用程式類型獨立設定閒置關閉。
+ JupyterLab
+ 程式碼編輯器，以 Code-OSS、Visual Studio Code - Open Source 為基礎
閒置關閉可以在網域或使用者設定檔層級設定。在網域層級設定閒置關閉時，閒置關閉設定適用於網域中建立的所有應用程式。在使用者設定檔層級設定時，閒置關閉設定僅適用於為其設定它們的特定使用者。使用者設定檔設定會覆寫網域設定。
**注意**
閒置關閉需要使用 v2.0 或更新版本的 `SageMaker-distribution` (SMD) 映像。使用較舊 SMD 版本的網域無法使用此功能。這些使用者必須改用 LCC 來管理自動關閉。
## 閒置的定義
閒置關閉設定僅適用於應用程式閒置且未執行任何任務的情況。SageMaker AI 不會啟動閒置關閉計時，直到執行個體變成閒置。閒置上的定義會根據應用程式類型是 JupyterLab 還是程式碼編輯器而有所不同。
若為 JupyterLab 應用程式，當符合下列條件時，執行個體會被視為閒置：
+ 沒有作用中的 Jupyter 核心工作階段
+ 沒有作用中的 Jupyter 終端工作階段
若為程式碼編輯器應用程式，當符合下列條件時，執行個體會被視為閒置：
+ 沒有文字檔案或筆記本變更
+ 沒有正在檢視的檔案
+ 與終端沒有互動
# 設定閒置關閉
下列各節說明如何從主控台或使用 AWS CLI設定閒置關閉。閒置關閉可以在網域或使用者設定檔層級設定。
## 先決條件
若要搭配應用程式使用閒置關閉，您必須完成下列先決條件。
+ 確保您的應用程式正在使用 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)。
## 從主控台
下列各節說明如何從主控台啟用閒置關閉。
### 在建立新網域時新增
1. 遵循 [使用 Amazon SageMaker AI 的自訂設定](onboard-custom.md) 中的步驟建立網域。
1. 在網域中設定應用程式設定時，導覽至程式碼編輯器或 JupyterLab 區段。
1. 選取**啟用閒置關閉**。
1. 輸入預設閒置關閉時間，以分鐘為單位。如果未輸入任何值，則此值預設為 `10,080`。
1. (選用) 選取**允許使用者設定自訂閒置關閉時間**，以允許使用者修改閒置關閉時間。
+ 輸入使用者可以設定預設閒置關閉時間的上限值。您必須輸入上限值。下限值由 Amazon SageMaker AI 設定，且必須為 `60`。
### 新增至現有網域
**注意**
如果在應用程式執行時設定閒置關閉，則必須重新啟動它們，閒置關閉設定才會生效。
1. 導覽至網域。
1. 選擇**應用程式組態**索引標籤。
1. 從**應用程式組態**索引標籤中，導覽至程式碼編輯器或 JupyterLab 區段。
1. 選擇 **Edit** (編輯)。
1. 選取**啟用閒置關閉**。
1. 輸入預設閒置關閉時間，以分鐘為單位。如果未輸入任何值，則此值預設為 `10,080`。
1. (選用) 選取**允許使用者設定自訂閒置關閉時間**，以允許使用者修改閒置關閉時間。
+ 輸入使用者可以設定預設閒置關閉時間的上限值。您必須輸入上限值。下限值由 Amazon SageMaker AI 設定，且必須為 `60`。
1. 選取**提交**。
### 建立新使用者設定檔時新增
1. 遵循[新增使用者設定檔](domain-user-profile-add.md)中的步驟新增使用者設定檔
1. 設定使用者設定檔的應用程式設定時，請導覽至程式碼編輯器或 JupyterLab 區段。
1. 選取**啟用閒置關閉**。
1. 輸入預設閒置關閉時間，以分鐘為單位。如果未輸入任何值，則此值預設為 `10,080`。
1. (選用) 選取**允許使用者設定自訂閒置關閉時間**，以允許使用者修改閒置關閉時間。
+ 輸入使用者可以設定預設閒置關閉時間的上限值。您必須輸入上限值。下限值由 Amazon SageMaker AI 設定，且必須為 `60`。
1. 選取「儲存變更」。
### 新增至現有的使用者設定檔
注意：如果在應用程式執行時設定閒置關閉，則必須重新啟動它們，閒置關閉設定才會生效。
1. 導覽至使用者設定檔。
1. 選擇**應用程式組態**索引標籤。
1. 從****應用程式組態****索引標籤中，導覽至程式碼編輯器或 JupyterLab 區段。
1. 選擇 **Edit** (編輯)。
1. 若是針對網域設定的，閒置關閉設定預設會顯示網域設定。
1. 選取**啟用閒置關閉**。
1. 輸入預設閒置關閉時間，以分鐘為單位。如果未輸入任何值，則此值預設為 `10,080`。
1. (選用) 選取**允許使用者設定自訂閒置關閉時間**，以允許使用者修改閒置關閉時間。
+ 輸入使用者可以設定預設閒置關閉時間的上限值。您必須輸入上限值。下限值由 Amazon SageMaker AI 設定，且必須為 `60`。
1. 選取 **Save Changes** (儲存變更)。
## 從 AWS CLI
下列各節說明如何使用 AWS CLI啟用閒置關閉。
**注意**
若要從 強制執行特定逾時值 AWS CLI，您必須`MinIdleTimeoutInMinutes`將 `IdleTimeoutInMinutes`、 `MaxIdleTimeoutInMinutes`和 設定為相同的值。
### 網域
下列命令顯示如何在更新現有網域時啟用閒置關閉。若要為新網域新增閒置關閉，請改用 `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
}
}
}
```
### 使用者設定檔
下列命令顯示如何在更新現有使用者設定檔時啟用閒置關閉。若要為新的使用者設定檔新增閒置關閉，請改用 `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
}
}
}
```
# 更新預設閒置關閉設定
您可以在網域或使用者設定檔層級更新預設閒置關閉設定。
**注意**
如果在應用程式執行時設定閒置關閉，則必須重新啟動它們，閒置關閉設定才會生效。
## 更新網域設定
1. 導覽至網域。
1. 選擇**應用程式組態**索引標籤。
1. 從**應用程式組態**索引標籤中，導覽至程式碼編輯器或 JupyterLab 區段。
1. 在您要修改其閒置關閉時間限制的應用程式區段中，選取**編輯**。
1. 更新網域的閒置關閉設定。
1. 選取 **Save Changes** (儲存變更)。
## 更新使用者設定檔設定
1. 導覽至網域。
1. 選擇**使用者設定檔**索引標籤。
1. 從**使用者設定檔**索引標籤中，選取要編輯的使用者設定檔。
1. 從**使用者設定檔**頁面中，選擇**應用程式**索引標籤。
1. 在**應用程式**索引標籤上，導覽至程式碼編輯器或 JupyterLab 區段。
1. 在您要修改其閒置關閉時間限制的應用程式區段中，選取**編輯**。
1. 更新使用者設定檔的閒置關閉設定。
1. 選取 **Save Changes** (儲存變更)。
# 修改您的閒置關閉時間限制
如果管理員在新增閒置關閉的支援時提供存取權，使用者可能可以修改閒置關閉時間限制。如果新增了閒置關閉的支援，則可能會有一個限制套用至閒置關閉的時間上限。使用者可以設定介於下限與上限之間的值。
1. 遵循[啟動 Amazon SageMaker Studio](studio-updated-launch.md) 中的步驟啟動 Amazon SageMaker Studio。
1. 從**應用程式**區段中，選取要更新其閒置關閉時間的應用程式類型。
1. 選取要更新的空間。
1. 使用所需的值更新**閒置關閉 (分鐘)**。
**注意**
如果在應用程式執行時設定閒置關閉，則必須重新啟動它們，閒置關閉設定才會生效。