1. Packages
  2. AWS
  3. API Docs
  4. s3
  5. getFilesAccessPoint
Viewing docs for AWS v7.26.0
published on Thursday, Apr 16, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws

aws.s3.getFilesAccessPoint

aws logo
Viewing docs for AWS v7.26.0
published on Thursday, Apr 16, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws

    Data source for managing an S3 Files Access Point.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = aws.s3.getFilesAccessPoint({
    id: "fsap-1234567890abcdef0",
});

    import pulumi
import pulumi_aws as aws

example = aws.s3.get_files_access_point(id="fsap-1234567890abcdef0")

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/s3"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := s3.LookupFilesAccessPoint(ctx, &s3.LookupFilesAccessPointArgs{
			Id: "fsap-1234567890abcdef0",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = Aws.S3.GetFilesAccessPoint.Invoke(new()
    {
        Id = "fsap-1234567890abcdef0",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.s3.S3Functions;
import com.pulumi.aws.s3.inputs.GetFilesAccessPointArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var example = S3Functions.getFilesAccessPoint(GetFilesAccessPointArgs.builder()
            .id("fsap-1234567890abcdef0")
            .build());

    }
}

    variables:
  example:
    fn::invoke:
      function: aws:s3:getFilesAccessPoint
      arguments:
        id: fsap-1234567890abcdef0

    Using getFilesAccessPoint

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getFilesAccessPoint(args: GetFilesAccessPointArgs, opts?: InvokeOptions): Promise<GetFilesAccessPointResult>
function getFilesAccessPointOutput(args: GetFilesAccessPointOutputArgs, opts?: InvokeOptions): Output<GetFilesAccessPointResult>
    def get_files_access_point(id: Optional[str] = None,
                           posix_users: Optional[Sequence[GetFilesAccessPointPosixUser]] = None,
                           region: Optional[str] = None,
                           root_directories: Optional[Sequence[GetFilesAccessPointRootDirectory]] = None,
                           opts: Optional[InvokeOptions] = None) -> GetFilesAccessPointResult
def get_files_access_point_output(id: Optional[pulumi.Input[str]] = None,
                           posix_users: Optional[pulumi.Input[Sequence[pulumi.Input[GetFilesAccessPointPosixUserArgs]]]] = None,
                           region: Optional[pulumi.Input[str]] = None,
                           root_directories: Optional[pulumi.Input[Sequence[pulumi.Input[GetFilesAccessPointRootDirectoryArgs]]]] = None,
                           opts: Optional[InvokeOptions] = None) -> Output[GetFilesAccessPointResult]
    func LookupFilesAccessPoint(ctx *Context, args *LookupFilesAccessPointArgs, opts ...InvokeOption) (*LookupFilesAccessPointResult, error)
func LookupFilesAccessPointOutput(ctx *Context, args *LookupFilesAccessPointOutputArgs, opts ...InvokeOption) LookupFilesAccessPointResultOutput

    > Note: This function is named LookupFilesAccessPoint in the Go SDK.

    public static class GetFilesAccessPoint 
{
    public static Task<GetFilesAccessPointResult> InvokeAsync(GetFilesAccessPointArgs args, InvokeOptions? opts = null)
    public static Output<GetFilesAccessPointResult> Invoke(GetFilesAccessPointInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetFilesAccessPointResult> getFilesAccessPoint(GetFilesAccessPointArgs args, InvokeOptions options)
public static Output<GetFilesAccessPointResult> getFilesAccessPoint(GetFilesAccessPointArgs args, InvokeOptions options)

    fn::invoke:
  function: aws:s3/getFilesAccessPoint:getFilesAccessPoint
  arguments:
    # arguments dictionary

    The following arguments are supported:

    Id string

    Access point ID.

    The following arguments are optional:

    PosixUsers List<GetFilesAccessPointPosixUser>
    POSIX user configuration. See posixUser below.
    Region string
    Region where this resource is managed. Defaults to the Region set in the provider configuration.
    RootDirectories List<GetFilesAccessPointRootDirectory>
    Root directory configuration. See rootDirectory below.
    Id string

    Access point ID.

    The following arguments are optional:

    PosixUsers []GetFilesAccessPointPosixUser
    POSIX user configuration. See posixUser below.
    Region string
    Region where this resource is managed. Defaults to the Region set in the provider configuration.
    RootDirectories []GetFilesAccessPointRootDirectory
    Root directory configuration. See rootDirectory below.
    id String

    Access point ID.

    The following arguments are optional:

    posixUsers List<GetFilesAccessPointPosixUser>
    POSIX user configuration. See posixUser below.
    region String
    Region where this resource is managed. Defaults to the Region set in the provider configuration.
    rootDirectories List<GetFilesAccessPointRootDirectory>
    Root directory configuration. See rootDirectory below.
    id string

    Access point ID.

    The following arguments are optional:

    posixUsers GetFilesAccessPointPosixUser[]
    POSIX user configuration. See posixUser below.
    region string
    Region where this resource is managed. Defaults to the Region set in the provider configuration.
    rootDirectories GetFilesAccessPointRootDirectory[]
    Root directory configuration. See rootDirectory below.
    id str

    Access point ID.

    The following arguments are optional:

    posix_users Sequence[GetFilesAccessPointPosixUser]
    POSIX user configuration. See posixUser below.
    region str
    Region where this resource is managed. Defaults to the Region set in the provider configuration.
    root_directories Sequence[GetFilesAccessPointRootDirectory]
    Root directory configuration. See rootDirectory below.
    id String

    Access point ID.

    The following arguments are optional:

    posixUsers List<Property Map>
    POSIX user configuration. See posixUser below.
    region String
    Region where this resource is managed. Defaults to the Region set in the provider configuration.
    rootDirectories List<Property Map>
    Root directory configuration. See rootDirectory below.

    getFilesAccessPoint Result

    The following output properties are available:

    Arn string
    ARN of the access point.
    FileSystemId string
    File system ID.
    Id string
    Name string
    Access point name.
    OwnerId string
    AWS account ID of the owner.
    Region string
    Status string
    Access point status.
    Tags Dictionary<string, string>
    Map of tags assigned to the resource.
    PosixUsers List<GetFilesAccessPointPosixUser>
    POSIX user configuration. See posixUser below.
    RootDirectories List<GetFilesAccessPointRootDirectory>
    Root directory configuration. See rootDirectory below.
    Arn string
    ARN of the access point.
    FileSystemId string
    File system ID.
    Id string
    Name string
    Access point name.
    OwnerId string
    AWS account ID of the owner.
    Region string
    Status string
    Access point status.
    Tags map[string]string
    Map of tags assigned to the resource.
    PosixUsers []GetFilesAccessPointPosixUser
    POSIX user configuration. See posixUser below.
    RootDirectories []GetFilesAccessPointRootDirectory
    Root directory configuration. See rootDirectory below.
    arn String
    ARN of the access point.
    fileSystemId String
    File system ID.
    id String
    name String
    Access point name.
    ownerId String
    AWS account ID of the owner.
    region String
    status String
    Access point status.
    tags Map<String,String>
    Map of tags assigned to the resource.
    posixUsers List<GetFilesAccessPointPosixUser>
    POSIX user configuration. See posixUser below.
    rootDirectories List<GetFilesAccessPointRootDirectory>
    Root directory configuration. See rootDirectory below.
    arn string
    ARN of the access point.
    fileSystemId string
    File system ID.
    id string
    name string
    Access point name.
    ownerId string
    AWS account ID of the owner.
    region string
    status string
    Access point status.
    tags {[key: string]: string}
    Map of tags assigned to the resource.
    posixUsers GetFilesAccessPointPosixUser[]
    POSIX user configuration. See posixUser below.
    rootDirectories GetFilesAccessPointRootDirectory[]
    Root directory configuration. See rootDirectory below.
    arn str
    ARN of the access point.
    file_system_id str
    File system ID.
    id str
    name str
    Access point name.
    owner_id str
    AWS account ID of the owner.
    region str
    status str
    Access point status.
    tags Mapping[str, str]
    Map of tags assigned to the resource.
    posix_users Sequence[GetFilesAccessPointPosixUser]
    POSIX user configuration. See posixUser below.
    root_directories Sequence[GetFilesAccessPointRootDirectory]
    Root directory configuration. See rootDirectory below.
    arn String
    ARN of the access point.
    fileSystemId String
    File system ID.
    id String
    name String
    Access point name.
    ownerId String
    AWS account ID of the owner.
    region String
    status String
    Access point status.
    tags Map<String>
    Map of tags assigned to the resource.
    posixUsers List<Property Map>
    POSIX user configuration. See posixUser below.
    rootDirectories List<Property Map>
    Root directory configuration. See rootDirectory below.

    Supporting Types

    GetFilesAccessPointPosixUser

    Gid int
    POSIX group ID.
    SecondaryGids List<int>
    Set of secondary POSIX group IDs.
    Uid int
    POSIX user ID.
    Gid int
    POSIX group ID.
    SecondaryGids []int
    Set of secondary POSIX group IDs.
    Uid int
    POSIX user ID.
    gid Integer
    POSIX group ID.
    secondaryGids List<Integer>
    Set of secondary POSIX group IDs.
    uid Integer
    POSIX user ID.
    gid number
    POSIX group ID.
    secondaryGids number[]
    Set of secondary POSIX group IDs.
    uid number
    POSIX user ID.
    gid int
    POSIX group ID.
    secondary_gids Sequence[int]
    Set of secondary POSIX group IDs.
    uid int
    POSIX user ID.
    gid Number
    POSIX group ID.
    secondaryGids List<Number>
    Set of secondary POSIX group IDs.
    uid Number
    POSIX user ID.

    GetFilesAccessPointRootDirectory

    Path string
    Root directory path.
    CreationPermissions List<GetFilesAccessPointRootDirectoryCreationPermission>
    Permissions set when the root directory was created. See creationPermissions below.
    Path string
    Root directory path.
    CreationPermissions []GetFilesAccessPointRootDirectoryCreationPermission
    Permissions set when the root directory was created. See creationPermissions below.
    path String
    Root directory path.
    creationPermissions List<GetFilesAccessPointRootDirectoryCreationPermission>
    Permissions set when the root directory was created. See creationPermissions below.
    path string
    Root directory path.
    creationPermissions GetFilesAccessPointRootDirectoryCreationPermission[]
    Permissions set when the root directory was created. See creationPermissions below.
    path str
    Root directory path.
    creation_permissions Sequence[GetFilesAccessPointRootDirectoryCreationPermission]
    Permissions set when the root directory was created. See creationPermissions below.
    path String
    Root directory path.
    creationPermissions List<Property Map>
    Permissions set when the root directory was created. See creationPermissions below.

    GetFilesAccessPointRootDirectoryCreationPermission

    OwnerGid int
    Owner group ID.
    OwnerUid int
    Owner user ID.
    Permissions string
    POSIX permissions in octal notation.
    OwnerGid int
    Owner group ID.
    OwnerUid int
    Owner user ID.
    Permissions string
    POSIX permissions in octal notation.
    ownerGid Integer
    Owner group ID.
    ownerUid Integer
    Owner user ID.
    permissions String
    POSIX permissions in octal notation.
    ownerGid number
    Owner group ID.
    ownerUid number
    Owner user ID.
    permissions string
    POSIX permissions in octal notation.
    owner_gid int
    Owner group ID.
    owner_uid int
    Owner user ID.
    permissions str
    POSIX permissions in octal notation.
    ownerGid Number
    Owner group ID.
    ownerUid Number
    Owner user ID.
    permissions String
    POSIX permissions in octal notation.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo
    Viewing docs for AWS v7.26.0
    published on Thursday, Apr 16, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws
      Try Pulumi Cloud free. Your team will thank you.