CreateAccessPoint

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

注意

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

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

可以在创建时标记接入点。如果在创建操作中指定了标签，则 IAM 会对 elasticfilesystem:TagResource 操作执行额外的授权，以验证用户是否具备创建标签的权限。因此，您必须授予使用 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

一个由最多 64 个 ASCII 字符组成的字符串，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 客户端公开。使用接入点的客户端只能对根目录及之下的目录进行访问。如果指定的 RootDirectory > Path 不存在，当客户端连接到接入点时，Amazon EFS 会创建此路径并应用 CreationInfo 设置。指定 RootDirectory 时，必须提供 Path 和 CreationInfo。

只有在您提供 CreationInfo: OwnUid、OwnGID 以及相关目录权限的情况下，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"
      }
   ]
}