設定預設值 AWS CLI

重要

允許 Amazon SageMaker 工作室或 Amazon 工作 SageMaker 室經典版創建 Amazon SageMaker 資源的自定義 IAM 政策還必須授予許可才能向這些資源添加標籤。需要向資源添加標籤的權限，因為 Studio 和 Studio 經典版會自動標記它們創建的任何資源。如果 IAM 政策允許 Studio 和 Studio 經典版建立資源，但不允許標記，則在嘗試建立資源時可能會發生 AccessDenied "" 錯誤。如需詳細資訊，請參閱 提供標記資 SageMaker源的權限。

AWS Amazon 的受管政策 SageMaker授予建立 SageMaker 資源的權限，已包含在建立這些資源時新增標籤的權限。

重要

截至 2023 年 11 月 30 日，以前的 Amazon SageMaker 工作室體驗現在被命名為 Amazon SageMaker 工作室經典。下面的部分是特定於使用 Studio 傳統版應用程序。如需使用更新後的 Studio 體驗的相關資訊，請參閱Amazon SageMaker 一室。

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

• 網域

• 使用者設定檔

• 共用空間

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

必要條件

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

• AWS CLI 依照安裝目前 AWS CLI 版本中的步驟來更新。

• 從您的本機機器，執行 aws configure 並提供您的 AWS 憑證。如需 AWS 認證的相關資訊，請參閱瞭解並取得 AWS 認證。

• 按照中的步驟進入 SageMaker 網域Amazon SageMaker 域名概述。

• 依照建立並關聯生命週期組態中的步驟在建立生命週期組態。

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

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

• create-user-profile

• create-domain

• create-space

您必須針對 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 指令的一部分：

• update-user-profile

• update-domain

• update-space

您必須針對 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]
  }
}'