创建共享空间 - Amazon SageMaker
为现有域添加共享空间支持创建共享空间
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

创建共享空间

重要

允许 Amazon SageMaker Studio 或 Amazon SageMaker Studio Classic 创建亚马逊 SageMaker资源的自定义 IAM 策略还必须授予向这些资源添加标签的权限。需要向资源添加标签的权限，因为 Studio 和 Studio Classic 会自动标记他们创建的任何资源。如果 IAM 策略允许 Studio 和 Studio Classic 创建资源但不允许标记，则在尝试创建资源时可能会出现 AccessDenied “” 错误。有关更多信息，请参阅 提供为资源添加标签 SageMaker的权限。

Amazon Amazon 托管政策 SageMaker授予创建 SageMaker 资源的权限已经包括在创建这些资源时添加标签的权限。

以下主题演示如何在现有 Amazon SageMaker 域中创建共享空间。如果您创建的域不支持共享空间，则必须先在现有域中添加对共享空间的支持，然后才能创建共享空间。

为现有域添加共享空间支持

您可以使用 SageMaker 控制台或将 Amazon CLI 对共享空间的支持添加到现有域中。如果域使用VPC only网络访问权限，则只能使用添加共享空间支持 Amazon CLI。

控制台

完成以下步骤，从 SageMaker 控制台向现有域添加对 Studio Classic 共享空间的支持。

  1. 打开亚马逊 SageMaker 控制台，网址为 https://console.aws.amazon.com/sagemaker/。

  2. 在左侧导航窗格中，选择管理员配置。

  3. 在管理员配置下，选择域。

  4. 从域名列表中，选择要为其打开域名设置页面的域名。

  5. 在域名详细信息页面上，选择域名设置选项卡。

  6. 选择编辑。

  7. 对于空间默认执行角色，设置一个 IAM 角色，该角色默认用于在域中创建的所有共享空间。

  8. 选择下一步。

  9. 选择下一步。

  10. 选择下一步。

  11. 选择提交。

Amazon CLI

Studio Classic

在本地计算机的终端上运行以下命令，将默认共享空间设置添加到来自的域中 Amazon CLI。如果您要向 Amazon VPC 内的域添加默认共享空间设置，则还必须包括安全组列表。Studio Classic 共享空间仅支持使用 JupyterLab 3 个图像 ARN。有关更多信息，请参阅 JupyterLab 版本控制。

# Public Internet domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn,JupyterServerAppSettings={DefaultResourceSpec={InstanceType=example-instance-type,SageMakerImageArn=sagemaker-image-arn}}"

# VPCOnly domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn,JupyterServerAppSettings={DefaultResourceSpec={InstanceType=system,SageMakerImageArn=sagemaker-image-arn}},SecurityGroups=[security-groups]"

使用以下命令验证共享空间的默认设置是否已更新。


aws --region region \
sagemaker describe-domain \
--domain-id domain-id
JupyterLab

在本地计算机的终端上运行以下命令，将默认共享空间设置添加到来自的域中 Amazon CLI。如果您要向 Amazon VPC 内的域添加默认共享空间设置，则还必须包括安全组列表。Studio Classic 共享空间仅支持使用 JupyterLab 4 个图像 ARN。有关更多信息，请参阅 JupyterLab 版本控制。

# Public Internet domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn", JupyterLabAppSettings={DefaultResourceSpec={InstanceType=example-instance-type,SageMakerImageArn=sagemaker-image-arn}}"

# VPCOnly domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn, SecurityGroups=[security-groups]"

使用以下命令验证共享空间的默认设置是否已更新。


aws --region region \
sagemaker describe-domain \
--domain-id domain-id

创建共享空间

以下各节演示如何通过亚马逊 SageMaker 控制台、Amazon SageMaker Studio 或创建共享空间 Amazon CLI。

使用以下过程在 Studio 的域中创建共享空间。

Studio Classic

  1. 按照中的步骤导航到 Studio 启动亚马逊 SageMaker Studio。

  2. 在 Studio 用户界面中，找到左侧的应用程序窗格。

  3. 在应用程序窗格中，选择 Studio Classic。

  4. 选择创建 Studio 经典空间

  5. 在弹出窗口中，输入空间的名称。

  6. 选择创建空间。

JupyterLab

  1. 按照中的步骤导航到 Studio 启动亚马逊 SageMaker Studio。

  2. 在 Studio 用户界面中，找到左侧的应用程序窗格。

  3. 在应用程序窗格中，选择JupyterLab。

  4. 选择创建 JupyterLab 空间

  5. 在弹出窗口中，输入空间的名称。

  6. 选择创建空间。

完成以下步骤，通过 SageMaker 控制台在域中创建共享空间。

  1. 打开亚马逊 SageMaker 控制台，网址为 https://console.aws.amazon.com/sagemaker/。

  2. 在左侧导航窗格中，选择管理员配置。

  3. 在管理员配置下，选择域。

  4. 从域列表中，选择要为其创建共享空间的域。

  5. 在域名详细信息页面上，选择空间管理选项卡。

  6. 选择创建。

  7. 输入共享空间的名称。域内的共享空间名称必须是唯一的。共享空间的执行角色设置为域 IAM 执行角色。

本部分将介绍如何从 Amazon CLI创建共享空间。

创建或更新共享空间时，无法设置其执行角色。DefaultDomainExecRole只能在创建或更新域时设置。共享空间仅支持使用 JupyterLab 3 个图像 ARN。有关更多信息，请参阅 JupyterLab 版本控制。

要从创建共享空间 Amazon CLI，请在本地计算机的终端上运行以下命令之一。

Studio Classic

aws --region region \
sagemaker create-space \
--domain-id domain-id \
--space-name space-name \
--space-settings '{
  "JupyterServerAppSettings": {
    "DefaultResourceSpec": {
      "SageMakerImageArn": "sagemaker-image-arn",
      "InstanceType": "system"
    }
  }
}'
JupyterLab

aws --region region \
sagemaker create-space \
--domain-id domain-id \
--space-name space-name \
--ownership-settings "{"OwnerUserProfileName": "user-profile-name"}" \
--space-sharing-settings "{"SharingType": "Shared"}" \
--space-settings "{"AppType": "JupyterLab"}"