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

# 從 Amazon SageMaker Studio Classic AWS CLI 的 設定預設值
<a name="studio-lcc-defaults-cli"></a>

**重要**  
允許 Amazon SageMaker Studio 或 Amazon SageMaker Studio Classic 建立 Amazon SageMaker 資源的自訂 IAM 政策也必須授予許可，才能將標籤新增至這些資源。需要將標籤新增至資源的許可，因為 Studio 和 Studio Classic 會自動標記它們建立的任何資源。如果 IAM 政策允許 Studio 和 Studio Classic 建立資源，但不允許標記，則在嘗試建立資源時可能會發生 "AccessDenied" 錯誤。如需詳細資訊，請參閱[提供標記 SageMaker AI 資源的許可](security_iam_id-based-policy-examples.md#grant-tagging-permissions)。  
提供許可來建立 SageMaker 資源的 [AWS Amazon SageMaker AI 的 受管政策](security-iam-awsmanpol.md) 已包含建立這些資源時新增標籤的許可。

**重要**  
自 2023 年 11 月 30 日起，先前的 Amazon SageMaker Studio 體驗現在命名為 Amazon SageMaker Studio Classic。下節專門介紹如何使用 Studio Classic 應用程式。如需使用已更新 Studio 體驗的資訊，請參閱 [Amazon SageMaker Studio](studio-updated.md)。  
Studio Classic 仍會針對現有工作負載進行維護，但無法再用於加入。您只能停止或刪除現有的 Studio Classic 應用程式，而且無法建立新的應用程式。建議您[將工作負載遷移至新的 Studio 體驗](studio-updated-migrate.md)。

您可以從 AWS CLI 為下列資源設定預設生命週期組態指令碼：
+ 網域
+ 使用者設定檔
+ 共用空間

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

**Topics**
+ [先決條件](#studio-lcc-defaults-cli-prereq)
+ [建立新資源時設定預設生命週期組態](#studio-lcc-defaults-cli-new)
+ [為現有資源設定預設生命週期組態](#studio-lcc-defaults-cli-existing)

## 先決條件
<a name="studio-lcc-defaults-cli-prereq"></a>

開始之前，請先完成以下先決條件：
+  AWS CLI 依照[安裝目前 AWS CLI 版本](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv1.html#install-tool-bundled)中的步驟更新 。
+ 從您的本機機器，執行 `aws configure` 並提供您的 AWS 憑證。如需 AWS 登入資料的資訊，請參閱[了解並取得您的 AWS 登入](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html)資料。
+ 遵循[Amazon SageMaker AI 網域概觀](gs-studio-onboard.md)中的步驟加入 SageMaker AI 網域。
+ 依照[建立生命週期組態並將其與 Amazon SageMaker Studio Classic 建立關聯](studio-lcc-create.md)中的步驟在建立生命週期組態。

## 建立新資源時設定預設生命週期組態
<a name="studio-lcc-defaults-cli-new"></a>

若要在建立新網域、使用者設定檔或空間時設定預設生命週期組態，請傳遞先前建立生命週期組態的 ARN，做為下列其中一個 AWS CLI 命令的一部分：
+ [create-user-profile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/create-user-profile.html)
+ [create-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/opensearch/create-domain.html)
+ [create-space](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/create-space.html)

您必須在 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]
  }
}'
```

## 為現有資源設定預設生命週期組態
<a name="studio-lcc-defaults-cli-existing"></a>

若要設定或更新現有資源的預設生命週期組態，請傳遞先前建立生命週期組態的 ARN，做為下列其中一個 AWS CLI 命令的一部分：
+ [update-user-profile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-user-profile.html)
+ [update-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html)
+ [update-space](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-space.html)

您必須在 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]
  }
}'
```