從 Amazon SageMaker Studio Classic AWS CLI 的 設定預設值 - Amazon SageMaker AI
先決條件建立新資源時設定預設生命週期組態為現有資源設定預設生命週期組態

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

從 Amazon SageMaker Studio Classic AWS CLI 的 設定預設值

重要

允許 Amazon SageMaker Studio 或 Amazon SageMaker Studio Classic 建立 Amazon SageMaker 資源的自訂 IAM 政策也必須授予許可，才能將標籤新增至這些資源。需要將標籤新增至資源的許可，因為 Studio 和 Studio Classic 會自動標記它們建立的任何資源。如果 IAM 政策允許 Studio 和 Studio Classic 建立資源，但不允許標記，則在嘗試建立資源時可能會發生 "AccessDenied" 錯誤。如需詳細資訊，請參閱提供標記 SageMaker AI 資源的許可。

提供許可來建立 SageMaker 資源的 AWS Amazon SageMaker AI 的 受管政策 已包含建立這些資源時新增標籤的許可。

重要

自 2023 年 11 月 30 日起，先前的 Amazon SageMaker Studio 體驗現在命名為 Amazon SageMaker Studio Classic。下節專門介紹如何使用 Studio Classic 應用程式。如需使用已更新 Studio 體驗的資訊，請參閱 Amazon SageMaker Studio。

Studio Classic 仍會針對現有工作負載進行維護，但無法再用於加入。您只能停止或刪除現有的 Studio Classic 應用程式，而且無法建立新的應用程式。我們建議您將工作負載遷移至新的 Studio 體驗。

您可以從 AWS CLI 為下列資源設定預設生命週期組態指令碼：

  • 網域

  • 使用者設定檔

  • 共用空間

以下各節說明如何從 AWS CLI設定預設生命週期組態指令碼。

先決條件

開始之前，請先完成以下先決條件：

建立新資源時設定預設生命週期組態

若要在建立新網域、使用者設定檔或空間時設定預設生命週期組態，請傳遞先前建立生命週期組態的 ARN，做為下列其中一個 AWS CLI 命令的一部分：

您必須在 KernelGateway 或 JupyterServer 預設設定中傳遞下列值的生命週期組態 ARN：

  • DefaultResourceSpec：LifecycleConfigArn - 這指定了應用程式類型的預設生命週期組態。

  • LifecycleConfigArns - 這是連接到應用程式類型的所有生命週期組態的清單。預設生命週期組態也必須是此清單的一部分。

例如，下列 API 呼叫會建立具有預設生命週期組態的新使用者設定檔。

aws sagemaker create-user-profile --domain-id domain-id \
--user-profile-name user-profile-name \
--region region \
--user-settings '{
"KernelGatewayAppSettings": {
    "DefaultResourceSpec": { 
            "InstanceType": "ml.t3.medium",
            "LifecycleConfigArn": "lifecycle-configuration-arn"
         },
    "LifecycleConfigArns": [lifecycle-configuration-arn-list]
  }
}'

為現有資源設定預設生命週期組態

若要設定或更新現有資源的預設生命週期組態，請傳遞先前建立生命週期組態的 ARN，做為下列其中一個 AWS CLI 命令的一部分：

您必須在 KernelGateway 或 JupyterServer 預設設定中傳遞下列值的生命週期組態 ARN：

  • DefaultResourceSpec：LifecycleConfigArn - 這指定了應用程式類型的預設生命週期組態。

  • LifecycleConfigArns - 這是連接到應用程式類型的所有生命週期組態的清單。預設生命週期組態也必須是此清單的一部分。

例如，下列 API 呼叫會以預設的生命週期組態更新使用者設定檔。

aws sagemaker update-user-profile --domain-id domain-id \
--user-profile-name user-profile-name \
--region region \
--user-settings '{
"KernelGatewayAppSettings": {
    "DefaultResourceSpec": {
            "InstanceType": "ml.t3.medium",
            "LifecycleConfigArn": "lifecycle-configuration-arn"
         },
    "LifecycleConfigArns": [lifecycle-configuration-arn-list]
  }
}'

下列 API 呼叫會更新網域，以設定新的預設生命週期組態。

aws sagemaker update-domain --domain-id domain-id \
--region region \
--default-user-settings '{
"JupyterServerAppSettings": {
    "DefaultResourceSpec": {
            "InstanceType": "system",
            "LifecycleConfigArn": "lifecycle-configuration-arn"
         },
    "LifecycleConfigArns": [lifecycle-configuration-arn-list]
  }
}'