aws-native.s3files.AccessPoint

AWS Cloud Control v1.62.0, Apr 20 26

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.62.0
published on Monday, Apr 20, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-aws-native

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.62.0
published on Monday, Apr 20, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-aws-native

Create AccessPoint Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new AccessPoint(name: string, args: AccessPointArgs, opts?: CustomResourceOptions);

@overload
def AccessPoint(resource_name: str,
                args: AccessPointArgs,
                opts: Optional[ResourceOptions] = None)

@overload
def AccessPoint(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                file_system_id: Optional[str] = None,
                client_token: Optional[str] = None,
                posix_user: Optional[AccessPointPosixUserArgs] = None,
                root_directory: Optional[AccessPointRootDirectoryArgs] = None,
                tags: Optional[Sequence[_root_inputs.TagArgs]] = None)

func NewAccessPoint(ctx *Context, name string, args AccessPointArgs, opts ...ResourceOption) (*AccessPoint, error)

public AccessPoint(string name, AccessPointArgs args, CustomResourceOptions? opts = null)

public AccessPoint(String name, AccessPointArgs args)
public AccessPoint(String name, AccessPointArgs args, CustomResourceOptions options)

type: aws-native:s3files:AccessPoint
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name string: The unique name of the resource.
args AccessPointArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

resource_name str: The unique name of the resource.
args AccessPointArgs: The arguments to resource properties.
opts ResourceOptions: Bag of options to control resource's behavior.

ctx Context: Context object for the current deployment.
name string: The unique name of the resource.
args AccessPointArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args AccessPointArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args AccessPointArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

AccessPoint Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The AccessPoint resource accepts the following input properties:

FileSystemId string: The ID of the S3 Files file system that the access point provides access to.
ClientToken string: (optional) A string of up to 64 ASCII characters that Amazon EFS uses to ensure idempotent creation.
PosixUser Pulumi.AwsNative.S3Files.Inputs.AccessPointPosixUser: The operating system user and group applied to all compute drive requests made using the access point.
RootDirectory Pulumi.AwsNative.S3Files.Inputs.AccessPointRootDirectory: Specifies the directory on the Amazon EFS file system that the access point exposes as the root directory of your file system to NFS clients using the access point. The clients using the access point can only access the root directory and below. If the RootDirectory>Path specified does not exist, EFS creates it and applies the CreationPermissions settings when a client connects to an access point. When specifying a RootDirectory, you need to provide the Path, and the CreationPermissions is optional.
Tags List<Pulumi.AwsNative.Inputs.Tag>

FileSystemId string: The ID of the S3 Files file system that the access point provides access to.
ClientToken string: (optional) A string of up to 64 ASCII characters that Amazon EFS uses to ensure idempotent creation.
PosixUser AccessPointPosixUserArgs: The operating system user and group applied to all compute drive requests made using the access point.
RootDirectory AccessPointRootDirectoryArgs: Specifies the directory on the Amazon EFS file system that the access point exposes as the root directory of your file system to NFS clients using the access point. The clients using the access point can only access the root directory and below. If the RootDirectory>Path specified does not exist, EFS creates it and applies the CreationPermissions settings when a client connects to an access point. When specifying a RootDirectory, you need to provide the Path, and the CreationPermissions is optional.
Tags TagArgs

fileSystemId String: The ID of the S3 Files file system that the access point provides access to.
clientToken String: (optional) A string of up to 64 ASCII characters that Amazon EFS uses to ensure idempotent creation.
posixUser AccessPointPosixUser: The operating system user and group applied to all compute drive requests made using the access point.
rootDirectory AccessPointRootDirectory: Specifies the directory on the Amazon EFS file system that the access point exposes as the root directory of your file system to NFS clients using the access point. The clients using the access point can only access the root directory and below. If the RootDirectory>Path specified does not exist, EFS creates it and applies the CreationPermissions settings when a client connects to an access point. When specifying a RootDirectory, you need to provide the Path, and the CreationPermissions is optional.
tags List<Tag>

fileSystemId string: The ID of the S3 Files file system that the access point provides access to.
clientToken string: (optional) A string of up to 64 ASCII characters that Amazon EFS uses to ensure idempotent creation.
posixUser AccessPointPosixUser: The operating system user and group applied to all compute drive requests made using the access point.
rootDirectory AccessPointRootDirectory: Specifies the directory on the Amazon EFS file system that the access point exposes as the root directory of your file system to NFS clients using the access point. The clients using the access point can only access the root directory and below. If the RootDirectory>Path specified does not exist, EFS creates it and applies the CreationPermissions settings when a client connects to an access point. When specifying a RootDirectory, you need to provide the Path, and the CreationPermissions is optional.
tags Tag[]

file_system_id str: The ID of the S3 Files file system that the access point provides access to.
client_token str: (optional) A string of up to 64 ASCII characters that Amazon EFS uses to ensure idempotent creation.
posix_user AccessPointPosixUserArgs: The operating system user and group applied to all compute drive requests made using the access point.
root_directory AccessPointRootDirectoryArgs: Specifies the directory on the Amazon EFS file system that the access point exposes as the root directory of your file system to NFS clients using the access point. The clients using the access point can only access the root directory and below. If the RootDirectory>Path specified does not exist, EFS creates it and applies the CreationPermissions settings when a client connects to an access point. When specifying a RootDirectory, you need to provide the Path, and the CreationPermissions is optional.
tags Sequence[TagArgs]

fileSystemId String: The ID of the S3 Files file system that the access point provides access to.
clientToken String: (optional) A string of up to 64 ASCII characters that Amazon EFS uses to ensure idempotent creation.
posixUser Property Map: The operating system user and group applied to all compute drive requests made using the access point.
rootDirectory Property Map: Specifies the directory on the Amazon EFS file system that the access point exposes as the root directory of your file system to NFS clients using the access point. The clients using the access point can only access the root directory and below. If the RootDirectory>Path specified does not exist, EFS creates it and applies the CreationPermissions settings when a client connects to an access point. When specifying a RootDirectory, you need to provide the Path, and the CreationPermissions is optional.
tags List<Property Map>

Outputs

All input properties are implicitly available as output properties. Additionally, the AccessPoint resource produces the following output properties:

AccessPointArn string
AccessPointId string
Id string: The provider-assigned unique ID for this managed resource.
OwnerId string
Status Pulumi.AwsNative.S3Files.AccessPointStatus

AccessPointArn string
AccessPointId string
Id string: The provider-assigned unique ID for this managed resource.
OwnerId string
Status AccessPointStatus

accessPointArn String
accessPointId String
id String: The provider-assigned unique ID for this managed resource.
ownerId String
status AccessPointStatus

accessPointArn string
accessPointId string
id string: The provider-assigned unique ID for this managed resource.
ownerId string
status AccessPointStatus

access_point_arn str
access_point_id str
id str: The provider-assigned unique ID for this managed resource.
owner_id str
status AccessPointStatus

accessPointArn String
accessPointId String
id String: The provider-assigned unique ID for this managed resource.
ownerId String
status "available" | "creating" | "updating" | "deleting" | "deleted" | "error"

Supporting Types

AccessPointCreationPermissions, AccessPointCreationPermissionsArgs

OwnerGid string: Specifies the POSIX group ID to apply to the RootDirectory. Accepts values from 0 to 2^32 (4294967295).
OwnerUid string: Specifies the POSIX user ID to apply to the RootDirectory. Accepts values from 0 to 2^32 (4294967295).
Permissions string: Specifies the POSIX permissions to apply to the RootDirectory, in the format of an octal number representing the file's mode bits.

OwnerGid string: Specifies the POSIX group ID to apply to the RootDirectory. Accepts values from 0 to 2^32 (4294967295).
OwnerUid string: Specifies the POSIX user ID to apply to the RootDirectory. Accepts values from 0 to 2^32 (4294967295).
Permissions string: Specifies the POSIX permissions to apply to the RootDirectory, in the format of an octal number representing the file's mode bits.

ownerGid String: Specifies the POSIX group ID to apply to the RootDirectory. Accepts values from 0 to 2^32 (4294967295).
ownerUid String: Specifies the POSIX user ID to apply to the RootDirectory. Accepts values from 0 to 2^32 (4294967295).
permissions String: Specifies the POSIX permissions to apply to the RootDirectory, in the format of an octal number representing the file's mode bits.

ownerGid string: Specifies the POSIX group ID to apply to the RootDirectory. Accepts values from 0 to 2^32 (4294967295).
ownerUid string: Specifies the POSIX user ID to apply to the RootDirectory. Accepts values from 0 to 2^32 (4294967295).
permissions string: Specifies the POSIX permissions to apply to the RootDirectory, in the format of an octal number representing the file's mode bits.

owner_gid str: Specifies the POSIX group ID to apply to the RootDirectory. Accepts values from 0 to 2^32 (4294967295).
owner_uid str: Specifies the POSIX user ID to apply to the RootDirectory. Accepts values from 0 to 2^32 (4294967295).
permissions str: Specifies the POSIX permissions to apply to the RootDirectory, in the format of an octal number representing the file's mode bits.

ownerGid String: Specifies the POSIX group ID to apply to the RootDirectory. Accepts values from 0 to 2^32 (4294967295).
ownerUid String: Specifies the POSIX user ID to apply to the RootDirectory. Accepts values from 0 to 2^32 (4294967295).
permissions String: Specifies the POSIX permissions to apply to the RootDirectory, in the format of an octal number representing the file's mode bits.

AccessPointPosixUser, AccessPointPosixUserArgs

Gid string: The POSIX group ID used for all file system operations using this access point.
Uid string: The POSIX user ID used for all file system operations using this access point.
SecondaryGids List<string>: Secondary POSIX group IDs used for all file system operations using this access point.

Gid string: The POSIX group ID used for all file system operations using this access point.
Uid string: The POSIX user ID used for all file system operations using this access point.
SecondaryGids []string: Secondary POSIX group IDs used for all file system operations using this access point.

gid String: The POSIX group ID used for all file system operations using this access point.
uid String: The POSIX user ID used for all file system operations using this access point.
secondaryGids List<String>: Secondary POSIX group IDs used for all file system operations using this access point.

gid string: The POSIX group ID used for all file system operations using this access point.
uid string: The POSIX user ID used for all file system operations using this access point.
secondaryGids string[]: Secondary POSIX group IDs used for all file system operations using this access point.

gid str: The POSIX group ID used for all file system operations using this access point.
uid str: The POSIX user ID used for all file system operations using this access point.
secondary_gids Sequence[str]: Secondary POSIX group IDs used for all file system operations using this access point.

gid String: The POSIX group ID used for all file system operations using this access point.
uid String: The POSIX user ID used for all file system operations using this access point.
secondaryGids List<String>: Secondary POSIX group IDs used for all file system operations using this access point.

AccessPointRootDirectory, AccessPointRootDirectoryArgs

CreationPermissions Pulumi.AwsNative.S3Files.Inputs.AccessPointCreationPermissions: (Optional) Specifies the POSIX IDs and permissions to apply to the access point's RootDirectory. If the RootDirectory>Path specified does not exist, EFS creates the root directory using the CreationPermissions settings when a client connects to an access point. When specifying the CreationPermissions, you must provide values for all properties. If you do not provide CreationPermissions and the specified RootDirectory>Path does not exist, attempts to mount the file system using the access point will fail.
Path string: Specifies the path on the EFS file system to expose as the root directory to NFS clients using the access point to access the EFS file system. A path can have up to four subdirectories. If the specified path does not exist, you are required to provide the CreationPermissions.

CreationPermissions AccessPointCreationPermissions: (Optional) Specifies the POSIX IDs and permissions to apply to the access point's RootDirectory. If the RootDirectory>Path specified does not exist, EFS creates the root directory using the CreationPermissions settings when a client connects to an access point. When specifying the CreationPermissions, you must provide values for all properties. If you do not provide CreationPermissions and the specified RootDirectory>Path does not exist, attempts to mount the file system using the access point will fail.
Path string: Specifies the path on the EFS file system to expose as the root directory to NFS clients using the access point to access the EFS file system. A path can have up to four subdirectories. If the specified path does not exist, you are required to provide the CreationPermissions.

creationPermissions AccessPointCreationPermissions: (Optional) Specifies the POSIX IDs and permissions to apply to the access point's RootDirectory. If the RootDirectory>Path specified does not exist, EFS creates the root directory using the CreationPermissions settings when a client connects to an access point. When specifying the CreationPermissions, you must provide values for all properties. If you do not provide CreationPermissions and the specified RootDirectory>Path does not exist, attempts to mount the file system using the access point will fail.
path String: Specifies the path on the EFS file system to expose as the root directory to NFS clients using the access point to access the EFS file system. A path can have up to four subdirectories. If the specified path does not exist, you are required to provide the CreationPermissions.

creationPermissions AccessPointCreationPermissions: (Optional) Specifies the POSIX IDs and permissions to apply to the access point's RootDirectory. If the RootDirectory>Path specified does not exist, EFS creates the root directory using the CreationPermissions settings when a client connects to an access point. When specifying the CreationPermissions, you must provide values for all properties. If you do not provide CreationPermissions and the specified RootDirectory>Path does not exist, attempts to mount the file system using the access point will fail.
path string: Specifies the path on the EFS file system to expose as the root directory to NFS clients using the access point to access the EFS file system. A path can have up to four subdirectories. If the specified path does not exist, you are required to provide the CreationPermissions.

creation_permissions AccessPointCreationPermissions: (Optional) Specifies the POSIX IDs and permissions to apply to the access point's RootDirectory. If the RootDirectory>Path specified does not exist, EFS creates the root directory using the CreationPermissions settings when a client connects to an access point. When specifying the CreationPermissions, you must provide values for all properties. If you do not provide CreationPermissions and the specified RootDirectory>Path does not exist, attempts to mount the file system using the access point will fail.
path str: Specifies the path on the EFS file system to expose as the root directory to NFS clients using the access point to access the EFS file system. A path can have up to four subdirectories. If the specified path does not exist, you are required to provide the CreationPermissions.

creationPermissions Property Map: (Optional) Specifies the POSIX IDs and permissions to apply to the access point's RootDirectory. If the RootDirectory>Path specified does not exist, EFS creates the root directory using the CreationPermissions settings when a client connects to an access point. When specifying the CreationPermissions, you must provide values for all properties. If you do not provide CreationPermissions and the specified RootDirectory>Path does not exist, attempts to mount the file system using the access point will fail.
path String: Specifies the path on the EFS file system to expose as the root directory to NFS clients using the access point to access the EFS file system. A path can have up to four subdirectories. If the specified path does not exist, you are required to provide the CreationPermissions.

AccessPointStatus, AccessPointStatusArgs

Available: available
Creating: creating
Updating: updating
Deleting: deleting
Deleted: deleted
Error: error

AccessPointStatusAvailable: available
AccessPointStatusCreating: creating
AccessPointStatusUpdating: updating
AccessPointStatusDeleting: deleting
AccessPointStatusDeleted: deleted
AccessPointStatusError: error

Available: available
Creating: creating
Updating: updating
Deleting: deleting
Deleted: deleted
Error: error

Available: available
Creating: creating
Updating: updating
Deleting: deleting
Deleted: deleted
Error: error

AVAILABLE: available
CREATING: creating
UPDATING: updating
DELETING: deleting
DELETED: deleted
ERROR: error

"available": available
"creating": creating
"updating": updating
"deleting": deleting
"deleted": deleted
"error": error

Tag, TagArgs

A set of tags to apply to the resource.

Key string: The key name of the tag
Value string: The value of the tag

Key string: The key name of the tag
Value string: The value of the tag

key String: The key name of the tag
value String: The value of the tag

key string: The key name of the tag
value string: The value of the tag

key str: The key name of the tag
value str: The value of the tag

key String: The key name of the tag
value String: The value of the tag

Package Details

Repository: AWS Native pulumi/pulumi-aws-native
License: Apache-2.0

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.62.0
published on Monday, Apr 20, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-aws-native

aws-native.s3files.AccessPoint

On this page

On this page

Create AccessPoint Resource

Constructor syntax

Parameters

AccessPoint Resource Properties

Inputs

Outputs

Supporting Types

AccessPointCreationPermissions, AccessPointCreationPermissionsArgs

AccessPointPosixUser, AccessPointPosixUserArgs

AccessPointRootDirectory, AccessPointRootDirectoryArgs

AccessPointStatus, AccessPointStatusArgs

Tag, TagArgs

Package Details

On this page

On this page