從 設定預設值 AWS CLI - Amazon SageMaker
必要條件建立新資源時設定預設生命週期組態為現有資源設定預設生命週期組態

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

從 設定預設值 AWS CLI

重要

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

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

重要

截至 2023 年 11 月 30 日，先前的 Amazon SageMaker Studio 體驗現在已命名為 Amazon SageMaker Studio Classic。以下章節是使用 Studio Classic 應用程式的特定部分。如需使用更新 Studio 體驗的相關資訊，請參閱 Amazon SageMaker 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": "ml.t3.medium",
            "LifecycleConfigArn": "lifecycle-configuration-arn"
         },
    "LifecycleConfigArns": [lifecycle-configuration-arn-list]
  }
}'