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

# 在 Studio 中创建和自动装载 Amazon EFS
<a name="studio-updated-automount"></a>

Amazon SageMaker AI 支持为域创建 Amazon EFS 卷并为每个用户自动挂载主目录文件夹。使用该文件夹，用户可以在自己的专用空间之间共享数据。不过，用户不能与域中的其他用户共享数据。用户只能访问自己的文件夹。

**重要**  
对于 2026 年 6 月 1 日之后创建的域，默认情况下不会在创建域时创建 EFS（用于快速设置）。必须先启用 EFS 创建，然后才能启用自动装载。

 **EFS 创建和自动装载设置** 

Amazon SageMaker Studio 中的 EFS 涉及两个协同工作的设置：
+ `HomeEFSCreation`— 控制是否由 SageMaker AI 为域创建和管理 EFS 文件系统。

  通过快速设置创建的新域名的默认值：**已禁用**

  启用后：为该域创建由 SageMaker AI 管理的新 EFS 文件系统。
+ `AutoMountHomeEFS`— 控制是否为用户自动装载 EFS 存储。

  默认：**启用**（`HomeEFSCreation`启用时）

  描述： Auto-mounts 每个用户的主目录，用于在其私人空间中共享笔记本、数据和代码。

  此设置只有在启用后`HomeEFSCreation`才可编辑。

  在用户配置文件级别，此值默认为 **DefaultAsDomain**（继承域级设置）。

关键行为：
+ 如果未设置任何值`AutoMountHomeEFS`，则默认情况下会启用自动装载 EFS。
+ 如果您有现有空间，请重新启动该空间以挂载 EFS。
+ Auto-mount EFS 仅适用于私有空间。

 **启用 EFS 创建和自动装载** 

创建域名后（快速设置）：

1. 打开 A SageMaker I 控制台。

1. 在左侧导航窗格的**管理员配置**下，选择**域**。

1. 选择您的域名，然后选择**域名设置**选项卡。

1. 在**存储配置**部分，选择**编辑**。

1. 在 **EFS 存储和加密**下，切换`HomeEFSCreation`到开启。这将为该域创建由 SageMaker AI 管理的新 EFS 文件系统。

1. 确保`AutoMountHomeEFS`已开启（开启时默认为启`HomeEFSCreation`用）。这会自动为每个用户挂载一个主目录，以便在他们的私人空间中共享笔记本、数据和代码。

1. 选择**提交**。

1. 如果您有现有空间，请重启这些空间以访问 EFS 数据。

对于自定义设置，默认情况下启用 EFS 创建和自动挂载。

 用户文件夹可通过名为 `user-default-efs` 的文件夹访问。该文件夹位于 Studio 应用程序的 `$HOME` 目录中。

 有关退出 Amazon EFS 自动挂载的信息，请参阅 [选择退出 Amazon EFS 自动挂载](studio-updated-automount-optout.md)。

 Amazon EFS 自动挂载还有助于将数据从 Studio Classic 迁移到 Studio。有关更多信息，请参阅 [（可选）将数据从 Studio Classic 迁移到 Studio](studio-updated-migrate-data.md)。

 **接入点信息** 

 激活自动挂载后， SageMaker AI 会使用 Amazon EFS 接入点来方便访问 Amazon EFS 卷中的数据。有关接入点的更多信息，请参阅[使用 Amazon EFS 接入点 SageMaker Amazon EFS](https://docs.amazonaws.cn/efs/latest/ug/efs-access-points.html) 接入点 AI 在创建用户配置文件期间或在为现有用户配置文件创建应用程序期间，为域中的每个用户配置文件创建唯一的访问点。接入点的 POSIX 用户值与 SageMaker AI 为其创建接入点的用户配置文件的`HomeEfsFileSystemUid`值相匹配。要获取用户的价值，请参阅[DescribeUserProfile](https://docs.amazonaws.cn/sagemaker/latest/APIReference/API_DescribeUserProfile.html#sagemaker-DescribeUserProfile-response-HomeEfsFileSystemUid)。根目录路径也被设置为与 POSIX 用户值相同的值。  

 SageMaker AI 将新目录的权限设置为以下值：

 
+  所有者用户 ID：`{{POSIX user value}}`
+  所有者组 ID：`0`
+  权限 `700` 

 访问 Amazon EFS 卷需要接入点。因此，删除或更新接入点会导致 Amazon EFS 卷无法访问。

 **错误解决** 

 如果 SageMaker AI 在创建应用程序期间自动挂载 Amazon EFS 用户文件夹时遇到问题，则仍会创建应用程序。但是，在本例中， SageMaker AI 会创建一个名为的文件，`error.txt`而不是挂载 Amazon EFS 文件夹。此文件描述了遇到的错误以及解决该错误的步骤。 SageMaker AI 在应用程序`$HOME`目录下的`user-default-efs`文件夹中创建该`error.txt`文件。