1. Packages
  2. AWS
  3. API Docs
  4. s3control
  5. getAccessPoints
AWS v7.19.0 published on Friday, Feb 6, 2026 by Pulumi
aws logo
AWS v7.19.0 published on Friday, Feb 6, 2026 by Pulumi

    Provides details about an AWS S3 Control Access Points.

    Example Usage

    Basic Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const example = aws.s3control.getAccessPoints({});
    
    import pulumi
    import pulumi_aws as aws
    
    example = aws.s3control.get_access_points()
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/s3control"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := s3control.GetAccessPoints(ctx, &s3control.GetAccessPointsArgs{}, 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.S3Control.GetAccessPoints.Invoke();
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.s3control.S3controlFunctions;
    import com.pulumi.aws.s3control.inputs.GetAccessPointsArgs;
    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 = S3controlFunctions.getAccessPoints(GetAccessPointsArgs.builder()
                .build());
    
        }
    }
    
    variables:
      example:
        fn::invoke:
          function: aws:s3control:getAccessPoints
          arguments: {}
    

    Filter by Bucket Name

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const example = aws.s3control.getAccessPoints({
        bucket: exampleAwsS3Bucket.bucket,
    });
    
    import pulumi
    import pulumi_aws as aws
    
    example = aws.s3control.get_access_points(bucket=example_aws_s3_bucket["bucket"])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/s3control"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := s3control.GetAccessPoints(ctx, &s3control.GetAccessPointsArgs{
    			Bucket: pulumi.StringRef(exampleAwsS3Bucket.Bucket),
    		}, 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.S3Control.GetAccessPoints.Invoke(new()
        {
            Bucket = exampleAwsS3Bucket.Bucket,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.s3control.S3controlFunctions;
    import com.pulumi.aws.s3control.inputs.GetAccessPointsArgs;
    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 = S3controlFunctions.getAccessPoints(GetAccessPointsArgs.builder()
                .bucket(exampleAwsS3Bucket.bucket())
                .build());
    
        }
    }
    
    variables:
      example:
        fn::invoke:
          function: aws:s3control:getAccessPoints
          arguments:
            bucket: ${exampleAwsS3Bucket.bucket}
    

    Using getAccessPoints

    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 getAccessPoints(args: GetAccessPointsArgs, opts?: InvokeOptions): Promise<GetAccessPointsResult>
    function getAccessPointsOutput(args: GetAccessPointsOutputArgs, opts?: InvokeOptions): Output<GetAccessPointsResult>
    def get_access_points(account_id: Optional[str] = None,
                          bucket: Optional[str] = None,
                          data_source_id: Optional[str] = None,
                          data_source_type: Optional[str] = None,
                          region: Optional[str] = None,
                          opts: Optional[InvokeOptions] = None) -> GetAccessPointsResult
    def get_access_points_output(account_id: Optional[pulumi.Input[str]] = None,
                          bucket: Optional[pulumi.Input[str]] = None,
                          data_source_id: Optional[pulumi.Input[str]] = None,
                          data_source_type: Optional[pulumi.Input[str]] = None,
                          region: Optional[pulumi.Input[str]] = None,
                          opts: Optional[InvokeOptions] = None) -> Output[GetAccessPointsResult]
    func GetAccessPoints(ctx *Context, args *GetAccessPointsArgs, opts ...InvokeOption) (*GetAccessPointsResult, error)
    func GetAccessPointsOutput(ctx *Context, args *GetAccessPointsOutputArgs, opts ...InvokeOption) GetAccessPointsResultOutput

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

    public static class GetAccessPoints 
    {
        public static Task<GetAccessPointsResult> InvokeAsync(GetAccessPointsArgs args, InvokeOptions? opts = null)
        public static Output<GetAccessPointsResult> Invoke(GetAccessPointsInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetAccessPointsResult> getAccessPoints(GetAccessPointsArgs args, InvokeOptions options)
    public static Output<GetAccessPointsResult> getAccessPoints(GetAccessPointsArgs args, InvokeOptions options)
    
    fn::invoke:
      function: aws:s3control/getAccessPoints:getAccessPoints
      arguments:
        # arguments dictionary

    The following arguments are supported:

    AccountId string
    AWS account ID for the account that owns the specified access points. If omitted, defaults to the caller's account ID.
    Bucket string
    Name of the bucket associated with the access points.
    DataSourceId string
    Unique identifier for the access points data source.
    DataSourceType string
    Type of the data source that the access points are attached to. To return all access points set this argument to ALL.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    AccountId string
    AWS account ID for the account that owns the specified access points. If omitted, defaults to the caller's account ID.
    Bucket string
    Name of the bucket associated with the access points.
    DataSourceId string
    Unique identifier for the access points data source.
    DataSourceType string
    Type of the data source that the access points are attached to. To return all access points set this argument to ALL.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    accountId String
    AWS account ID for the account that owns the specified access points. If omitted, defaults to the caller's account ID.
    bucket String
    Name of the bucket associated with the access points.
    dataSourceId String
    Unique identifier for the access points data source.
    dataSourceType String
    Type of the data source that the access points are attached to. To return all access points set this argument to ALL.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    accountId string
    AWS account ID for the account that owns the specified access points. If omitted, defaults to the caller's account ID.
    bucket string
    Name of the bucket associated with the access points.
    dataSourceId string
    Unique identifier for the access points data source.
    dataSourceType string
    Type of the data source that the access points are attached to. To return all access points set this argument to ALL.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    account_id str
    AWS account ID for the account that owns the specified access points. If omitted, defaults to the caller's account ID.
    bucket str
    Name of the bucket associated with the access points.
    data_source_id str
    Unique identifier for the access points data source.
    data_source_type str
    Type of the data source that the access points are attached to. To return all access points set this argument to ALL.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    accountId String
    AWS account ID for the account that owns the specified access points. If omitted, defaults to the caller's account ID.
    bucket String
    Name of the bucket associated with the access points.
    dataSourceId String
    Unique identifier for the access points data source.
    dataSourceType String
    Type of the data source that the access points are attached to. To return all access points set this argument to ALL.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.

    getAccessPoints Result

    The following output properties are available:

    AccessPoints List<GetAccessPointsAccessPoint>
    A list of access points matching the search criteria. See access_points below.
    Id string
    The provider-assigned unique ID for this managed resource.
    Region string
    AccountId string
    Bucket string
    Name of the bucket associated with the access point.
    DataSourceId string
    Unique identifier for the data source of the access point.
    DataSourceType string
    Type of the data source that the access point is attached to.
    AccessPoints []GetAccessPointsAccessPoint
    A list of access points matching the search criteria. See access_points below.
    Id string
    The provider-assigned unique ID for this managed resource.
    Region string
    AccountId string
    Bucket string
    Name of the bucket associated with the access point.
    DataSourceId string
    Unique identifier for the data source of the access point.
    DataSourceType string
    Type of the data source that the access point is attached to.
    accessPoints List<GetAccessPointsAccessPoint>
    A list of access points matching the search criteria. See access_points below.
    id String
    The provider-assigned unique ID for this managed resource.
    region String
    accountId String
    bucket String
    Name of the bucket associated with the access point.
    dataSourceId String
    Unique identifier for the data source of the access point.
    dataSourceType String
    Type of the data source that the access point is attached to.
    accessPoints GetAccessPointsAccessPoint[]
    A list of access points matching the search criteria. See access_points below.
    id string
    The provider-assigned unique ID for this managed resource.
    region string
    accountId string
    bucket string
    Name of the bucket associated with the access point.
    dataSourceId string
    Unique identifier for the data source of the access point.
    dataSourceType string
    Type of the data source that the access point is attached to.
    access_points Sequence[GetAccessPointsAccessPoint]
    A list of access points matching the search criteria. See access_points below.
    id str
    The provider-assigned unique ID for this managed resource.
    region str
    account_id str
    bucket str
    Name of the bucket associated with the access point.
    data_source_id str
    Unique identifier for the data source of the access point.
    data_source_type str
    Type of the data source that the access point is attached to.
    accessPoints List<Property Map>
    A list of access points matching the search criteria. See access_points below.
    id String
    The provider-assigned unique ID for this managed resource.
    region String
    accountId String
    bucket String
    Name of the bucket associated with the access point.
    dataSourceId String
    Unique identifier for the data source of the access point.
    dataSourceType String
    Type of the data source that the access point is attached to.

    Supporting Types

    GetAccessPointsAccessPoint

    AccessPointArn string
    Access point ARN.
    Alias string
    Access point alias.
    Bucket string
    Name of the bucket associated with the access points.
    BucketAccountId string
    AWS account ID associated with the S3 bucket associated with the access point.
    DataSourceId string
    Unique identifier for the access points data source.
    DataSourceType string
    Type of the data source that the access points are attached to. To return all access points set this argument to ALL.
    Name string
    Name of the access point.
    NetworkOrigin string
    Indicates whether the access point allows access from the public Internet.
    VpcConfigurations List<GetAccessPointsAccessPointVpcConfiguration>
    VPC configuration for the access point. See vpc_configuration below.
    AccessPointArn string
    Access point ARN.
    Alias string
    Access point alias.
    Bucket string
    Name of the bucket associated with the access points.
    BucketAccountId string
    AWS account ID associated with the S3 bucket associated with the access point.
    DataSourceId string
    Unique identifier for the access points data source.
    DataSourceType string
    Type of the data source that the access points are attached to. To return all access points set this argument to ALL.
    Name string
    Name of the access point.
    NetworkOrigin string
    Indicates whether the access point allows access from the public Internet.
    VpcConfigurations []GetAccessPointsAccessPointVpcConfiguration
    VPC configuration for the access point. See vpc_configuration below.
    accessPointArn String
    Access point ARN.
    alias String
    Access point alias.
    bucket String
    Name of the bucket associated with the access points.
    bucketAccountId String
    AWS account ID associated with the S3 bucket associated with the access point.
    dataSourceId String
    Unique identifier for the access points data source.
    dataSourceType String
    Type of the data source that the access points are attached to. To return all access points set this argument to ALL.
    name String
    Name of the access point.
    networkOrigin String
    Indicates whether the access point allows access from the public Internet.
    vpcConfigurations List<GetAccessPointsAccessPointVpcConfiguration>
    VPC configuration for the access point. See vpc_configuration below.
    accessPointArn string
    Access point ARN.
    alias string
    Access point alias.
    bucket string
    Name of the bucket associated with the access points.
    bucketAccountId string
    AWS account ID associated with the S3 bucket associated with the access point.
    dataSourceId string
    Unique identifier for the access points data source.
    dataSourceType string
    Type of the data source that the access points are attached to. To return all access points set this argument to ALL.
    name string
    Name of the access point.
    networkOrigin string
    Indicates whether the access point allows access from the public Internet.
    vpcConfigurations GetAccessPointsAccessPointVpcConfiguration[]
    VPC configuration for the access point. See vpc_configuration below.
    access_point_arn str
    Access point ARN.
    alias str
    Access point alias.
    bucket str
    Name of the bucket associated with the access points.
    bucket_account_id str
    AWS account ID associated with the S3 bucket associated with the access point.
    data_source_id str
    Unique identifier for the access points data source.
    data_source_type str
    Type of the data source that the access points are attached to. To return all access points set this argument to ALL.
    name str
    Name of the access point.
    network_origin str
    Indicates whether the access point allows access from the public Internet.
    vpc_configurations Sequence[GetAccessPointsAccessPointVpcConfiguration]
    VPC configuration for the access point. See vpc_configuration below.
    accessPointArn String
    Access point ARN.
    alias String
    Access point alias.
    bucket String
    Name of the bucket associated with the access points.
    bucketAccountId String
    AWS account ID associated with the S3 bucket associated with the access point.
    dataSourceId String
    Unique identifier for the access points data source.
    dataSourceType String
    Type of the data source that the access points are attached to. To return all access points set this argument to ALL.
    name String
    Name of the access point.
    networkOrigin String
    Indicates whether the access point allows access from the public Internet.
    vpcConfigurations List<Property Map>
    VPC configuration for the access point. See vpc_configuration below.

    GetAccessPointsAccessPointVpcConfiguration

    VpcId string
    Access point will only allow connections from this VPC.
    VpcId string
    Access point will only allow connections from this VPC.
    vpcId String
    Access point will only allow connections from this VPC.
    vpcId string
    Access point will only allow connections from this VPC.
    vpc_id str
    Access point will only allow connections from this VPC.
    vpcId String
    Access point will only allow connections from this VPC.

    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
    AWS v7.19.0 published on Friday, Feb 6, 2026 by Pulumi
      Meet Neo: Your AI Platform Teammate