從 設定預設值 AWS CLI

重要

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

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

重要

截至 2023 年 11 月 30 日，先前的 Amazon SageMaker Studio 體驗現在已命名為 Amazon SageMaker Studio Classic。以下章節是使用 Studio Classic 應用程式的特定部分。如需使用更新 Studio 體驗的相關資訊，請參閱Amazon SageMaker Studio。

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

• 網域

• 使用者設定檔

• 共用空間

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

必要條件

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

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

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

• 依照中的步驟加入 SageMaker AI 網域Amazon SageMaker AI 網域概觀。

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

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

若要在建立新網域、使用者設定檔或空間時設定預設生命週期組態，請傳遞先前建立生命週期組態的 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": "system",
            "LifecycleConfigArn": "lifecycle-configuration-arn"
         },
    "LifecycleConfigArns": [lifecycle-configuration-arn-list]
  }
}'