AWS::EFS::AccessPoint - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::EFS::AccessPoint

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

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

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "Type" : "AWS::EFS::AccessPoint", "Properties" : { "AccessPointTags" : [ AccessPointTag, ... ], "ClientToken" : String, "FileSystemId" : String, "PosixUser" : PosixUser, "RootDirectory" : RootDirectory } }

YAML

Type: AWS::EFS::AccessPoint Properties: AccessPointTags: - AccessPointTag ClientToken: String FileSystemId: String PosixUser: PosixUser RootDirectory: RootDirectory

属性

AccessPointTags

要应用于此资源的键值对的数组。

有关更多信息,请参阅标签

必需:否

类型AccessPointTag 的列表

Update requires: No interruption

ClientToken

请求中指定的不透明字符串,以确保幂等创建。

必需:否

类型:字符串

最低1

最高64

Update requires: Replacement

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})$

Update requires: Replacement

PosixUser

访问点上的完整 POSIX 身份,包括用户 ID、组 ID 和辅助组 ID,由使用访问点的 NFS 客户端用于所有文件操作。

必需:否

类型PosixUser

Update requires: Replacement

RootDirectory

Amazon EFS 文件系统上的目录,访问点将其作为根目录,向使用访问点的 NFS 客户端公开。

必需:否

类型RootDirectory

Update requires: Replacement

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回资源 ID。例如:

{"Ref":"fsap-0123456789abcdef0"}

Ref 返回访问点 ID。

For more information about using the Ref function, see Ref.

Fn::GetAtt

Fn::GetAtt 内部函数返回此类型的一个指定属性的值。以下为可用属性和示例返回值。

有关使用 Fn::GetAtt 内部函数的更多信息,请参阅 Fn::GetAtt

AccessPointId

EFS 访问点的 ID。

Arn

访问点的 Amazon 资源名称 (ARN)。

示例

声明 EFS 文件系统的访问点

以下示例声明与 EFS 文件系统关联的访问点。有关在 EC2 实例上挂载文件系统的信息,请参阅 EFS 用户指南 中的挂载文件系统

JSON

"AccessPointResource": { "Type": "AWS::EFS::AccessPoint", "Properties": { "FileSystemId": { "Ref": "FileSystemResource" }, "PosixUser": { "Uid": "13234", "Gid": "1322", "SecondaryGids": [ "1344", "1452" ] }, "RootDirectory": { "CreationInfo": { "OwnerGid": "708798", "OwnerUid": "7987987", "Permissions": "0755" }, "Path": "/testcfn/abc" } } } }

YAML

AccessPointResource: Type: 'AWS::EFS::AccessPoint' Properties: FileSystemId: !Ref FileSystemResource PosixUser: Uid: "13234" Gid: "1322" SecondaryGids: - "1344" - "1452" RootDirectory: CreationInfo: OwnerGid: "708798" OwnerUid: "7987987" Permissions: "0755" Path: "/testcfn/abc"

另请参阅