CreateAccessPoint

创建接EFS入点。访问点是EFS文件系统的特定于应用程序的视图，它将操作系统用户和组以及文件系统路径应用于通过访问点发出的任何文件系统请求。操作系统用户和组会覆盖NFS客户端提供的任何身份信息。文件系统路径作为访问点的根目录公开。使用接入点的应用程序只能访问其自己的目录中以及任何子目录中的数据。要了解更多信息，请参阅使用EFS接入点挂载文件系统。

注意

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

此操作需要 elasticfilesystem:CreateAccessPoint 操作的权限。

可以在创建时标记接入点。如果在创建操作中指定了标签，则会对该elasticfilesystem:TagResource操作IAM执行额外授权，以验证用户是否有权创建标签。因此，您必须授予使用 elasticfilesystem:TagResource 操作的显式权限。有关更多信息，请参阅在创建过程中授予标记资源的权限。

请求语法


POST /2015-02-01/access-points HTTP/1.1
Content-type: application/json

{
   "ClientToken": "string",
   "FileSystemId": "string",
   "PosixUser": { 
      "Gid": number,
      "SecondaryGids": [ number ],
      "Uid": number
   },
   "RootDirectory": { 
      "CreationInfo": { 
         "OwnerGid": number,
         "OwnerUid": number,
         "Permissions": "string"
      },
      "Path": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

URI请求参数

该请求不使用任何URI参数。

请求正文

该请求接受以下JSON格式的数据。

ClientToken

一个不ASCII超过 64 个字符的字符串，Amazon EFS 使用它来确保均等创建。

类型：字符串

长度限制：长度下限为 1。长度上限为 64。

模式：.+

必需：是

FileSystemId

接入点提供访问权限EFS的文件系统的 ID。

类型：字符串

长度限制：最大长度为 128。

模式：^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

必需：是

PosixUser

应用于使用接入点发出的所有文件系统请求的操作系统用户和组。

类型：PosixUser 对象

必需：否

RootDirectory

指定EFS文件系统上的目录，接入点将该目录作为文件系统的根目录公开给使用该接入点的NFS客户端。使用接入点的客户端只能对根目录及之下的目录进行访问。如果Path指定的 RootDirectory > 不存在，Amazon EFS 会创建它并在客户端连接到接入点时应用CreationInfo设置。指定 RootDirectory 时，必须提供 Path 和 CreationInfo。

只有在您为根目录提供了 CreationInfo: OwnUid、Own GID 和权限后，Amazon 才会EFS创建该目录。如果您不提供这些信息，Amazon 就EFS不会创建根目录。如果根目录不存在，则使用接入点进行挂载的尝试将失败。

类型：RootDirectory 对象

必需：否

Tags

创建与接入点关联的标签。每个标签都是一个键值对，每个键都必须是唯一的。有关更多信息，请参阅《 AWS 通用参考指南》中的为AWS 资源添加标签。

类型：Tag 对象数组

必需：否

响应语法


HTTP/1.1 200
Content-type: application/json

{
   "AccessPointArn": "string",
   "AccessPointId": "string",
   "ClientToken": "string",
   "FileSystemId": "string",
   "LifeCycleState": "string",
   "Name": "string",
   "OwnerId": "string",
   "PosixUser": { 
      "Gid": number,
      "SecondaryGids": [ number ],
      "Uid": number
   },
   "RootDirectory": { 
      "CreationInfo": { 
         "OwnerGid": number,
         "OwnerUid": number,
         "Permissions": "string"
      },
      "Path": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}