从 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 资源的权限。

Amazon SageMaker 的 AWS 托管式策略 授予创建 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]
  }
}'