创建和删除接入点 - Amazon Elastic File System

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

创建和删除接入点

您可以使用 AWS Management Console 或创建 Amazon EFS 接入点 AWS CLI。您也可以直接使用软件 AWS 开发工具包或 Amazon EFS API 以编程方式创建接入点。接入点一经创建就无法进行修改。一个文件系统最多可以有 1 千个接入点。有关 EFS 访问点的更多信息,请参阅使用 Amazon EFS 访问点

以下过程介绍如何使用控制台和 AWS CLI创建接入点。

您可以使用 AWS Management Console、 AWS Command Line Interface (AWS CLI)、Amazon EFS API 和软件开发工具包创建和删除 Amazon EFS 接入点。接入点一经创建就无法进行修改。一个文件系统最多可以有 1 千个接入点。

注意

如果快速连续发送多个在同一文件系统上创建接入点的请求,并且文件系统接近 1 千个接入点的限制,则可能会遇到对这些请求的限制响应。这是为了确保文件系统不超过规定的接入点配额。

  1. 访问 https://console.aws.amazon.com/efs/,打开 Amazon Elastic File System 控制台。

  2. 选择接入点以打开接入点窗口。

  3. 选择创建接入点以显示创建接入点页面。

    也可以通过选择文件系统来打开创建接入点页面。选择文件系统的名称文件系统 ID,然后选择接入点创建接入点,为该文件系统创建接入点。

    
                可以在 Amazon EFS 控制台中的创建接入点页面上创建和编辑接入点。
    1. 详细信息面板中输入以下信息:

      • 文件系统 – 输入文件系统名称或 ID,然后选择匹配的文件系统。也可以从选择输入字段时显示的列表中选择文件系统。

      • (可选)名称 – 输入接入点的名称。

      • (可选)根目录路径 – 可以为接入点指定根目录;默认接入点根目录为 /。要输入根目录路径,请使用格式 /foo/bar。有关更多信息,请参阅使用接入点强制使用根目录

    2. (可选)在 POSIX 用户面板中,可以指定完整的 POSIX 身份,以用于使用接入点的 NFS 客户端对所有文件操作强制执行用户和组信息。有关更多信息,请参阅使用接入点强制使用用户身份

      • 用户 ID – 输入用户的数字 POSIX 用户 ID。

      • 组 ID – 输入用户的数字 POSIX 组 ID。

      • 辅助组 ID – 输入以逗号分隔的可选辅助组 ID 列表。

    3. (可选)对于根目录创建权限,可以指定 Amazon EFS 创建根目录路径时使用的权限(如果已指定,并且根目录尚不存在)。有关更多信息,请参阅使用接入点强制使用根目录

      注意

      如果未指定任何根目录所有权和权限,并且根目录尚不存在,EFS 将不会创建根目录。使用接入点挂载文件系统的任何尝试都将失败。

      • 拥有者用户 ID – 输入用作根目录所有者的数字 POSIX 用户 ID。

      • 拥有者组 ID – 输入用作根目录所有者组的数字 POSIX 组 ID。

      • 权限 – 输入目录的 Unix 模式。一个常见配置是 755。确保为接入点用户设置了执行位,以便他们能够执行装载操作。

  4. 选择创建接入点以使用此配置创建接入点。

在以下示例中,create-access-point CLI 命令将为 EFS 文件系统创建接入点。等效的 API 命令是 CreateAccessPoint

aws efs create-access-point --file-system-id fs-abcdef0123456789a --client-token 010102020-3 \ --root-directory “Path=/efs/mobileapp/east,CreationInfo={OwnerUid=0,OwnerGid=11,Permissions=775}” \ --posix-user “Uid=22,Gid=4” \ --tags Key=Name,Value=east-users

如果请求成功,CLI 将使用接入点描述进行响应。

{ "ClientToken": "010102020-3", "Name": "east-users", "AccessPointId": "fsap-abcd1234ef5678901", "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111122223333:access-point/fsap-abcd1234ef5678901", "FileSystemId": "fs-01234567", "LifeCycleState": "creating", "OwnerId": "111122223333", "PosixUser": { "Gid": 4, "Uid": 22 }, "RootDirectory": { "CreationInfo": { "OwnerGid": 0, "OwnerUid": 11, "Permissions": "775" }, "Path": "/efs/mobileapp/east", }, "Tags": [] }
注意

如果快速连续发送多个在同一文件系统上创建接入点的请求,并且文件系统接近 1 千个接入点的限制,则可能会遇到对这些请求的限制响应。这是为了确保文件系统不超过规定的接入点配额。

删除接入点

删除接入点后,任何使用该接入点的客户端都将无法访问为其配置的 Amazon EFS 文件系统。

  1. 访问 https://console.aws.amazon.com/efs/,打开 Amazon Elastic File System 控制台。

  2. 在左侧导航窗格中,选择接入点以打开接入点页面。

  3. 选择要删除的接入点。

  4. 选择 Delete (删除)

  5. 选择确认以确认操作并删除接入点。

在以下示例中,delete-access-point CLI 命令将删除指定的接入点。等效的 API 命令是 DeleteAccessPoint。如果此命令成功,该服务会返回带有空 HTTP 正文的 HTTP 204 响应。

aws efs delete-access-point --access-point-id fsap-092e9f80b3fb5e6f3 --client-token 010102020-3