Sign in Dashboard Get started
  1. Packages
  2. Packages
  3. AWS
  4. API Docs
  5. s3control
  6. MultiRegionAccessPoint
Viewing docs for AWS v7.32.0
published on Friday, May 29, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws

aws.s3control.MultiRegionAccessPoint

aws logo
Viewing docs for AWS v7.32.0
published on Friday, May 29, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws

    Provides a resource to manage an S3 Multi-Region Access Point associated with specified buckets.

    This resource cannot be used with S3 directory buckets.

    Example Usage

    Multiple AWS Buckets in Different Regions

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

const fooBucket = new aws.s3.Bucket("foo_bucket", {bucket: "example-bucket-foo"});
const barBucket = new aws.s3.Bucket("bar_bucket", {bucket: "example-bucket-bar"});
const example = new aws.s3control.MultiRegionAccessPoint("example", {details: {
    name: "example",
    regions: [
        {
            bucket: fooBucket.id,
        },
        {
            bucket: barBucket.id,
        },
    ],
}});

    import pulumi
import pulumi_aws as aws

foo_bucket = aws.s3.Bucket("foo_bucket", bucket="example-bucket-foo")
bar_bucket = aws.s3.Bucket("bar_bucket", bucket="example-bucket-bar")
example = aws.s3control.MultiRegionAccessPoint("example", details={
    "name": "example",
    "regions": [
        {
            "bucket": foo_bucket.id,
        },
        {
            "bucket": bar_bucket.id,
        },
    ],
})

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/s3"
	"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 {
		fooBucket, err := s3.NewBucket(ctx, "foo_bucket", &s3.BucketArgs{
			Bucket: pulumi.String("example-bucket-foo"),
		})
		if err != nil {
			return err
		}
		barBucket, err := s3.NewBucket(ctx, "bar_bucket", &s3.BucketArgs{
			Bucket: pulumi.String("example-bucket-bar"),
		})
		if err != nil {
			return err
		}
		_, err = s3control.NewMultiRegionAccessPoint(ctx, "example", &s3control.MultiRegionAccessPointArgs{
			Details: &s3control.MultiRegionAccessPointDetailsArgs{
				Name: pulumi.String("example"),
				Regions: s3control.MultiRegionAccessPointDetailsRegionArray{
					&s3control.MultiRegionAccessPointDetailsRegionArgs{
						Bucket: fooBucket.ID(),
					},
					&s3control.MultiRegionAccessPointDetailsRegionArgs{
						Bucket: barBucket.ID(),
					},
				},
			},
		})
		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 fooBucket = new Aws.S3.Bucket("foo_bucket", new()
    {
        BucketName = "example-bucket-foo",
    });

    var barBucket = new Aws.S3.Bucket("bar_bucket", new()
    {
        BucketName = "example-bucket-bar",
    });

    var example = new Aws.S3Control.MultiRegionAccessPoint("example", new()
    {
        Details = new Aws.S3Control.Inputs.MultiRegionAccessPointDetailsArgs
        {
            Name = "example",
            Regions = new[]
            {
                new Aws.S3Control.Inputs.MultiRegionAccessPointDetailsRegionArgs
                {
                    Bucket = fooBucket.Id,
                },
                new Aws.S3Control.Inputs.MultiRegionAccessPointDetailsRegionArgs
                {
                    Bucket = barBucket.Id,
                },
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.s3.Bucket;
import com.pulumi.aws.s3.BucketArgs;
import com.pulumi.aws.s3control.MultiRegionAccessPoint;
import com.pulumi.aws.s3control.MultiRegionAccessPointArgs;
import com.pulumi.aws.s3control.inputs.MultiRegionAccessPointDetailsArgs;
import java.util.ArrayList;
import java.util.Arrays;
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) {
        var fooBucket = new Bucket("fooBucket", BucketArgs.builder()
            .bucket("example-bucket-foo")
            .build());

        var barBucket = new Bucket("barBucket", BucketArgs.builder()
            .bucket("example-bucket-bar")
            .build());

        var example = new MultiRegionAccessPoint("example", MultiRegionAccessPointArgs.builder()
            .details(MultiRegionAccessPointDetailsArgs.builder()
                .name("example")
                .regions(                
                    MultiRegionAccessPointDetailsRegionArgs.builder()
                        .bucket(fooBucket.id())
                        .build(),
                    MultiRegionAccessPointDetailsRegionArgs.builder()
                        .bucket(barBucket.id())
                        .build())
                .build())
            .build());

    }
}

    resources:
  fooBucket:
    type: aws:s3:Bucket
    name: foo_bucket
    properties:
      bucket: example-bucket-foo
  barBucket:
    type: aws:s3:Bucket
    name: bar_bucket
    properties:
      bucket: example-bucket-bar
  example:
    type: aws:s3control:MultiRegionAccessPoint
    properties:
      details:
        name: example
        regions:
          - bucket: ${fooBucket.id}
          - bucket: ${barBucket.id}

    pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_s3_bucket" "foo_bucket" {
  bucket = "example-bucket-foo"
}
resource "aws_s3_bucket" "bar_bucket" {
  bucket = "example-bucket-bar"
}
resource "aws_s3control_multiregionaccesspoint" "example" {
  details = {
    name = "example"
    regions = [{
      "bucket" = aws_s3_bucket.foo_bucket.id
      }, {
      "bucket" = aws_s3_bucket.bar_bucket.id
    }]
  }
}

    Create MultiRegionAccessPoint Resource

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

    Constructor syntax

    new MultiRegionAccessPoint(name: string, args: MultiRegionAccessPointArgs, opts?: CustomResourceOptions);
    @overload
def MultiRegionAccessPoint(resource_name: str,
                           args: MultiRegionAccessPointArgs,
                           opts: Optional[ResourceOptions] = None)

@overload
def MultiRegionAccessPoint(resource_name: str,
                           opts: Optional[ResourceOptions] = None,
                           details: Optional[MultiRegionAccessPointDetailsArgs] = None,
                           account_id: Optional[str] = None,
                           region: Optional[str] = None)
    func NewMultiRegionAccessPoint(ctx *Context, name string, args MultiRegionAccessPointArgs, opts ...ResourceOption) (*MultiRegionAccessPoint, error)
    public MultiRegionAccessPoint(string name, MultiRegionAccessPointArgs args, CustomResourceOptions? opts = null)
    public MultiRegionAccessPoint(String name, MultiRegionAccessPointArgs args)
public MultiRegionAccessPoint(String name, MultiRegionAccessPointArgs args, CustomResourceOptions options)

    type: aws:s3control:MultiRegionAccessPoint
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "aws_s3control_multiregionaccesspoint" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args MultiRegionAccessPointArgs
    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 MultiRegionAccessPointArgs
    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 MultiRegionAccessPointArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args MultiRegionAccessPointArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args MultiRegionAccessPointArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var multiRegionAccessPointResource = new Aws.S3Control.MultiRegionAccessPoint("multiRegionAccessPointResource", new()
{
    Details = new Aws.S3Control.Inputs.MultiRegionAccessPointDetailsArgs
    {
        Name = "string",
        Regions = new[]
        {
            new Aws.S3Control.Inputs.MultiRegionAccessPointDetailsRegionArgs
            {
                Bucket = "string",
                BucketAccountId = "string",
                Region = "string",
            },
        },
        PublicAccessBlock = new Aws.S3Control.Inputs.MultiRegionAccessPointDetailsPublicAccessBlockArgs
        {
            BlockPublicAcls = false,
            BlockPublicPolicy = false,
            IgnorePublicAcls = false,
            RestrictPublicBuckets = false,
        },
    },
    AccountId = "string",
    Region = "string",
});

    example, err := s3control.NewMultiRegionAccessPoint(ctx, "multiRegionAccessPointResource", &s3control.MultiRegionAccessPointArgs{
	Details: &s3control.MultiRegionAccessPointDetailsArgs{
		Name: pulumi.String("string"),
		Regions: s3control.MultiRegionAccessPointDetailsRegionArray{
			&s3control.MultiRegionAccessPointDetailsRegionArgs{
				Bucket:          pulumi.String("string"),
				BucketAccountId: pulumi.String("string"),
				Region:          pulumi.String("string"),
			},
		},
		PublicAccessBlock: &s3control.MultiRegionAccessPointDetailsPublicAccessBlockArgs{
			BlockPublicAcls:       pulumi.Bool(false),
			BlockPublicPolicy:     pulumi.Bool(false),
			IgnorePublicAcls:      pulumi.Bool(false),
			RestrictPublicBuckets: pulumi.Bool(false),
		},
	},
	AccountId: pulumi.String("string"),
	Region:    pulumi.String("string"),
})

    resource "aws_s3control_multiregionaccesspoint" "multiRegionAccessPointResource" {
  details = {
    name = "string"
    regions = [{
      "bucket"          = "string"
      "bucketAccountId" = "string"
      "region"          = "string"
    }]
    public_access_block = {
      block_public_acls       = false
      block_public_policy     = false
      ignore_public_acls      = false
      restrict_public_buckets = false
    }
  }
  account_id = "string"
  region     = "string"
}

    var multiRegionAccessPointResource = new MultiRegionAccessPoint("multiRegionAccessPointResource", MultiRegionAccessPointArgs.builder()
    .details(MultiRegionAccessPointDetailsArgs.builder()
        .name("string")
        .regions(MultiRegionAccessPointDetailsRegionArgs.builder()
            .bucket("string")
            .bucketAccountId("string")
            .region("string")
            .build())
        .publicAccessBlock(MultiRegionAccessPointDetailsPublicAccessBlockArgs.builder()
            .blockPublicAcls(false)
            .blockPublicPolicy(false)
            .ignorePublicAcls(false)
            .restrictPublicBuckets(false)
            .build())
        .build())
    .accountId("string")
    .region("string")
    .build());

    multi_region_access_point_resource = aws.s3control.MultiRegionAccessPoint("multiRegionAccessPointResource",
    details={
        "name": "string",
        "regions": [{
            "bucket": "string",
            "bucket_account_id": "string",
            "region": "string",
        }],
        "public_access_block": {
            "block_public_acls": False,
            "block_public_policy": False,
            "ignore_public_acls": False,
            "restrict_public_buckets": False,
        },
    },
    account_id="string",
    region="string")

    const multiRegionAccessPointResource = new aws.s3control.MultiRegionAccessPoint("multiRegionAccessPointResource", {
    details: {
        name: "string",
        regions: [{
            bucket: "string",
            bucketAccountId: "string",
            region: "string",
        }],
        publicAccessBlock: {
            blockPublicAcls: false,
            blockPublicPolicy: false,
            ignorePublicAcls: false,
            restrictPublicBuckets: false,
        },
    },
    accountId: "string",
    region: "string",
});

    type: aws:s3control:MultiRegionAccessPoint
properties:
    accountId: string
    details:
        name: string
        publicAccessBlock:
            blockPublicAcls: false
            blockPublicPolicy: false
            ignorePublicAcls: false
            restrictPublicBuckets: false
        regions:
            - bucket: string
              bucketAccountId: string
              region: string
    region: string

    MultiRegionAccessPoint 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 MultiRegionAccessPoint resource accepts the following input properties:

    Details MultiRegionAccessPointDetails
    A configuration block containing details about the Multi-Region Access Point. See Details Configuration Block below for more details
    AccountId string
    The AWS account ID for the owner of the buckets for which you want to create a Multi-Region Access Point. Defaults to automatically determined account ID of the AWS provider.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Details MultiRegionAccessPointDetailsArgs
    A configuration block containing details about the Multi-Region Access Point. See Details Configuration Block below for more details
    AccountId string
    The AWS account ID for the owner of the buckets for which you want to create a Multi-Region Access Point. Defaults to automatically determined account ID of the AWS provider.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    details object
    A configuration block containing details about the Multi-Region Access Point. See Details Configuration Block below for more details
    account_id string
    The AWS account ID for the owner of the buckets for which you want to create a Multi-Region Access Point. Defaults to automatically determined account ID of the AWS provider.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    details MultiRegionAccessPointDetails
    A configuration block containing details about the Multi-Region Access Point. See Details Configuration Block below for more details
    accountId String
    The AWS account ID for the owner of the buckets for which you want to create a Multi-Region Access Point. Defaults to automatically determined account ID of the AWS provider.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    details MultiRegionAccessPointDetails
    A configuration block containing details about the Multi-Region Access Point. See Details Configuration Block below for more details
    accountId string
    The AWS account ID for the owner of the buckets for which you want to create a Multi-Region Access Point. Defaults to automatically determined account ID of the AWS provider.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    details MultiRegionAccessPointDetailsArgs
    A configuration block containing details about the Multi-Region Access Point. See Details Configuration Block below for more details
    account_id str
    The AWS account ID for the owner of the buckets for which you want to create a Multi-Region Access Point. Defaults to automatically determined account ID of the AWS provider.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    details Property Map
    A configuration block containing details about the Multi-Region Access Point. See Details Configuration Block below for more details
    accountId String
    The AWS account ID for the owner of the buckets for which you want to create a Multi-Region Access Point. Defaults to automatically determined account ID of the AWS provider.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.

    Outputs

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

    Alias string
    Alias for the Multi-Region Access Point.
    Arn string
    Amazon Resource Name (ARN) of the Multi-Region Access Point.
    DomainName string
    DNS domain name of the S3 Multi-Region Access Point in the format alias.accesspoint.s3-global.amazonaws.com. For more information, see the documentation on Multi-Region Access Point Requests.
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    Name of the Multi-Region Access Point.
    Status string
    Status of the Multi-Region Access Point. One of: READY, INCONSISTENT_ACROSS_REGIONS, CREATING, PARTIALLY_CREATED, PARTIALLY_DELETED, DELETING.
    Alias string
    Alias for the Multi-Region Access Point.
    Arn string
    Amazon Resource Name (ARN) of the Multi-Region Access Point.
    DomainName string
    DNS domain name of the S3 Multi-Region Access Point in the format alias.accesspoint.s3-global.amazonaws.com. For more information, see the documentation on Multi-Region Access Point Requests.
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    Name of the Multi-Region Access Point.
    Status string
    Status of the Multi-Region Access Point. One of: READY, INCONSISTENT_ACROSS_REGIONS, CREATING, PARTIALLY_CREATED, PARTIALLY_DELETED, DELETING.
    alias string
    Alias for the Multi-Region Access Point.
    arn string
    Amazon Resource Name (ARN) of the Multi-Region Access Point.
    domain_name string
    DNS domain name of the S3 Multi-Region Access Point in the format alias.accesspoint.s3-global.amazonaws.com. For more information, see the documentation on Multi-Region Access Point Requests.
    id string
    The provider-assigned unique ID for this managed resource.
    name string
    Name of the Multi-Region Access Point.
    status string
    Status of the Multi-Region Access Point. One of: READY, INCONSISTENT_ACROSS_REGIONS, CREATING, PARTIALLY_CREATED, PARTIALLY_DELETED, DELETING.
    alias String
    Alias for the Multi-Region Access Point.
    arn String
    Amazon Resource Name (ARN) of the Multi-Region Access Point.
    domainName String
    DNS domain name of the S3 Multi-Region Access Point in the format alias.accesspoint.s3-global.amazonaws.com. For more information, see the documentation on Multi-Region Access Point Requests.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    Name of the Multi-Region Access Point.
    status String
    Status of the Multi-Region Access Point. One of: READY, INCONSISTENT_ACROSS_REGIONS, CREATING, PARTIALLY_CREATED, PARTIALLY_DELETED, DELETING.
    alias string
    Alias for the Multi-Region Access Point.
    arn string
    Amazon Resource Name (ARN) of the Multi-Region Access Point.
    domainName string
    DNS domain name of the S3 Multi-Region Access Point in the format alias.accesspoint.s3-global.amazonaws.com. For more information, see the documentation on Multi-Region Access Point Requests.
    id string
    The provider-assigned unique ID for this managed resource.
    name string
    Name of the Multi-Region Access Point.
    status string
    Status of the Multi-Region Access Point. One of: READY, INCONSISTENT_ACROSS_REGIONS, CREATING, PARTIALLY_CREATED, PARTIALLY_DELETED, DELETING.
    alias str
    Alias for the Multi-Region Access Point.
    arn str
    Amazon Resource Name (ARN) of the Multi-Region Access Point.
    domain_name str
    DNS domain name of the S3 Multi-Region Access Point in the format alias.accesspoint.s3-global.amazonaws.com. For more information, see the documentation on Multi-Region Access Point Requests.
    id str
    The provider-assigned unique ID for this managed resource.
    name str
    Name of the Multi-Region Access Point.
    status str
    Status of the Multi-Region Access Point. One of: READY, INCONSISTENT_ACROSS_REGIONS, CREATING, PARTIALLY_CREATED, PARTIALLY_DELETED, DELETING.
    alias String
    Alias for the Multi-Region Access Point.
    arn String
    Amazon Resource Name (ARN) of the Multi-Region Access Point.
    domainName String
    DNS domain name of the S3 Multi-Region Access Point in the format alias.accesspoint.s3-global.amazonaws.com. For more information, see the documentation on Multi-Region Access Point Requests.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    Name of the Multi-Region Access Point.
    status String
    Status of the Multi-Region Access Point. One of: READY, INCONSISTENT_ACROSS_REGIONS, CREATING, PARTIALLY_CREATED, PARTIALLY_DELETED, DELETING.

    Look up Existing MultiRegionAccessPoint Resource

    Get an existing MultiRegionAccessPoint resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: MultiRegionAccessPointState, opts?: CustomResourceOptions): MultiRegionAccessPoint
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        account_id: Optional[str] = None,
        alias: Optional[str] = None,
        arn: Optional[str] = None,
        details: Optional[MultiRegionAccessPointDetailsArgs] = None,
        domain_name: Optional[str] = None,
        name: Optional[str] = None,
        region: Optional[str] = None,
        status: Optional[str] = None) -> MultiRegionAccessPoint
    func GetMultiRegionAccessPoint(ctx *Context, name string, id IDInput, state *MultiRegionAccessPointState, opts ...ResourceOption) (*MultiRegionAccessPoint, error)
    public static MultiRegionAccessPoint Get(string name, Input<string> id, MultiRegionAccessPointState? state, CustomResourceOptions? opts = null)
    public static MultiRegionAccessPoint get(String name, Output<String> id, MultiRegionAccessPointState state, CustomResourceOptions options)
    resources:  _:    type: aws:s3control:MultiRegionAccessPoint    get:      id: ${id}
    import {
  to = aws_s3control_multiregionaccesspoint.example
  id = "${id}"
}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AccountId string
    The AWS account ID for the owner of the buckets for which you want to create a Multi-Region Access Point. Defaults to automatically determined account ID of the AWS provider.
    Alias string
    Alias for the Multi-Region Access Point.
    Arn string
    Amazon Resource Name (ARN) of the Multi-Region Access Point.
    Details MultiRegionAccessPointDetails
    A configuration block containing details about the Multi-Region Access Point. See Details Configuration Block below for more details
    DomainName string
    DNS domain name of the S3 Multi-Region Access Point in the format alias.accesspoint.s3-global.amazonaws.com. For more information, see the documentation on Multi-Region Access Point Requests.
    Name string
    Name of the Multi-Region Access Point.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Status string
    Status of the Multi-Region Access Point. One of: READY, INCONSISTENT_ACROSS_REGIONS, CREATING, PARTIALLY_CREATED, PARTIALLY_DELETED, DELETING.
    AccountId string
    The AWS account ID for the owner of the buckets for which you want to create a Multi-Region Access Point. Defaults to automatically determined account ID of the AWS provider.
    Alias string
    Alias for the Multi-Region Access Point.
    Arn string
    Amazon Resource Name (ARN) of the Multi-Region Access Point.
    Details MultiRegionAccessPointDetailsArgs
    A configuration block containing details about the Multi-Region Access Point. See Details Configuration Block below for more details
    DomainName string
    DNS domain name of the S3 Multi-Region Access Point in the format alias.accesspoint.s3-global.amazonaws.com. For more information, see the documentation on Multi-Region Access Point Requests.
    Name string
    Name of the Multi-Region Access Point.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Status string
    Status of the Multi-Region Access Point. One of: READY, INCONSISTENT_ACROSS_REGIONS, CREATING, PARTIALLY_CREATED, PARTIALLY_DELETED, DELETING.
    account_id string
    The AWS account ID for the owner of the buckets for which you want to create a Multi-Region Access Point. Defaults to automatically determined account ID of the AWS provider.
    alias string
    Alias for the Multi-Region Access Point.
    arn string
    Amazon Resource Name (ARN) of the Multi-Region Access Point.
    details object
    A configuration block containing details about the Multi-Region Access Point. See Details Configuration Block below for more details
    domain_name string
    DNS domain name of the S3 Multi-Region Access Point in the format alias.accesspoint.s3-global.amazonaws.com. For more information, see the documentation on Multi-Region Access Point Requests.
    name string
    Name of the Multi-Region Access Point.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    status string
    Status of the Multi-Region Access Point. One of: READY, INCONSISTENT_ACROSS_REGIONS, CREATING, PARTIALLY_CREATED, PARTIALLY_DELETED, DELETING.
    accountId String
    The AWS account ID for the owner of the buckets for which you want to create a Multi-Region Access Point. Defaults to automatically determined account ID of the AWS provider.
    alias String
    Alias for the Multi-Region Access Point.
    arn String
    Amazon Resource Name (ARN) of the Multi-Region Access Point.
    details MultiRegionAccessPointDetails
    A configuration block containing details about the Multi-Region Access Point. See Details Configuration Block below for more details
    domainName String
    DNS domain name of the S3 Multi-Region Access Point in the format alias.accesspoint.s3-global.amazonaws.com. For more information, see the documentation on Multi-Region Access Point Requests.
    name String
    Name of the Multi-Region Access Point.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    status String
    Status of the Multi-Region Access Point. One of: READY, INCONSISTENT_ACROSS_REGIONS, CREATING, PARTIALLY_CREATED, PARTIALLY_DELETED, DELETING.
    accountId string
    The AWS account ID for the owner of the buckets for which you want to create a Multi-Region Access Point. Defaults to automatically determined account ID of the AWS provider.
    alias string
    Alias for the Multi-Region Access Point.
    arn string
    Amazon Resource Name (ARN) of the Multi-Region Access Point.
    details MultiRegionAccessPointDetails
    A configuration block containing details about the Multi-Region Access Point. See Details Configuration Block below for more details
    domainName string
    DNS domain name of the S3 Multi-Region Access Point in the format alias.accesspoint.s3-global.amazonaws.com. For more information, see the documentation on Multi-Region Access Point Requests.
    name string
    Name of the Multi-Region Access Point.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    status string
    Status of the Multi-Region Access Point. One of: READY, INCONSISTENT_ACROSS_REGIONS, CREATING, PARTIALLY_CREATED, PARTIALLY_DELETED, DELETING.
    account_id str
    The AWS account ID for the owner of the buckets for which you want to create a Multi-Region Access Point. Defaults to automatically determined account ID of the AWS provider.
    alias str
    Alias for the Multi-Region Access Point.
    arn str
    Amazon Resource Name (ARN) of the Multi-Region Access Point.
    details MultiRegionAccessPointDetailsArgs
    A configuration block containing details about the Multi-Region Access Point. See Details Configuration Block below for more details
    domain_name str
    DNS domain name of the S3 Multi-Region Access Point in the format alias.accesspoint.s3-global.amazonaws.com. For more information, see the documentation on Multi-Region Access Point Requests.
    name str
    Name of the Multi-Region Access Point.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    status str
    Status of the Multi-Region Access Point. One of: READY, INCONSISTENT_ACROSS_REGIONS, CREATING, PARTIALLY_CREATED, PARTIALLY_DELETED, DELETING.
    accountId String
    The AWS account ID for the owner of the buckets for which you want to create a Multi-Region Access Point. Defaults to automatically determined account ID of the AWS provider.
    alias String
    Alias for the Multi-Region Access Point.
    arn String
    Amazon Resource Name (ARN) of the Multi-Region Access Point.
    details Property Map
    A configuration block containing details about the Multi-Region Access Point. See Details Configuration Block below for more details
    domainName String
    DNS domain name of the S3 Multi-Region Access Point in the format alias.accesspoint.s3-global.amazonaws.com. For more information, see the documentation on Multi-Region Access Point Requests.
    name String
    Name of the Multi-Region Access Point.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    status String
    Status of the Multi-Region Access Point. One of: READY, INCONSISTENT_ACROSS_REGIONS, CREATING, PARTIALLY_CREATED, PARTIALLY_DELETED, DELETING.

    Supporting Types

    MultiRegionAccessPointDetails, MultiRegionAccessPointDetailsArgs

    Name string
    The name of the Multi-Region Access Point.
    Regions List<MultiRegionAccessPointDetailsRegion>

    The Region configuration block to specify the bucket associated with the Multi-Region Access Point. See Region Configuration below for more details.

    For more information, see the documentation on Multi-Region Access Points.

    PublicAccessBlock MultiRegionAccessPointDetailsPublicAccessBlock
    Configuration block to manage the PublicAccessBlock configuration that you want to apply to this Multi-Region Access Point. You can enable the configuration options in any combination. See Public Access Block Configuration below for more details.
    Name string
    The name of the Multi-Region Access Point.
    Regions []MultiRegionAccessPointDetailsRegion

    The Region configuration block to specify the bucket associated with the Multi-Region Access Point. See Region Configuration below for more details.

    For more information, see the documentation on Multi-Region Access Points.

    PublicAccessBlock MultiRegionAccessPointDetailsPublicAccessBlock
    Configuration block to manage the PublicAccessBlock configuration that you want to apply to this Multi-Region Access Point. You can enable the configuration options in any combination. See Public Access Block Configuration below for more details.
    name string
    The name of the Multi-Region Access Point.
    regions list(object)

    The Region configuration block to specify the bucket associated with the Multi-Region Access Point. See Region Configuration below for more details.

    For more information, see the documentation on Multi-Region Access Points.

    public_access_block object
    Configuration block to manage the PublicAccessBlock configuration that you want to apply to this Multi-Region Access Point. You can enable the configuration options in any combination. See Public Access Block Configuration below for more details.
    name String
    The name of the Multi-Region Access Point.
    regions List<MultiRegionAccessPointDetailsRegion>

    The Region configuration block to specify the bucket associated with the Multi-Region Access Point. See Region Configuration below for more details.

    For more information, see the documentation on Multi-Region Access Points.

    publicAccessBlock MultiRegionAccessPointDetailsPublicAccessBlock
    Configuration block to manage the PublicAccessBlock configuration that you want to apply to this Multi-Region Access Point. You can enable the configuration options in any combination. See Public Access Block Configuration below for more details.
    name string
    The name of the Multi-Region Access Point.
    regions MultiRegionAccessPointDetailsRegion[]

    The Region configuration block to specify the bucket associated with the Multi-Region Access Point. See Region Configuration below for more details.

    For more information, see the documentation on Multi-Region Access Points.

    publicAccessBlock MultiRegionAccessPointDetailsPublicAccessBlock
    Configuration block to manage the PublicAccessBlock configuration that you want to apply to this Multi-Region Access Point. You can enable the configuration options in any combination. See Public Access Block Configuration below for more details.
    name str
    The name of the Multi-Region Access Point.
    regions Sequence[MultiRegionAccessPointDetailsRegion]

    The Region configuration block to specify the bucket associated with the Multi-Region Access Point. See Region Configuration below for more details.

    For more information, see the documentation on Multi-Region Access Points.

    public_access_block MultiRegionAccessPointDetailsPublicAccessBlock
    Configuration block to manage the PublicAccessBlock configuration that you want to apply to this Multi-Region Access Point. You can enable the configuration options in any combination. See Public Access Block Configuration below for more details.
    name String
    The name of the Multi-Region Access Point.
    regions List<Property Map>

    The Region configuration block to specify the bucket associated with the Multi-Region Access Point. See Region Configuration below for more details.

    For more information, see the documentation on Multi-Region Access Points.

    publicAccessBlock Property Map
    Configuration block to manage the PublicAccessBlock configuration that you want to apply to this Multi-Region Access Point. You can enable the configuration options in any combination. See Public Access Block Configuration below for more details.

    MultiRegionAccessPointDetailsPublicAccessBlock, MultiRegionAccessPointDetailsPublicAccessBlockArgs

    BlockPublicAcls bool
    Whether Amazon S3 should block public ACLs for buckets in this account. Defaults to true. Enabling this setting does not affect existing policies or ACLs. When set to true causes the following behavior:

    • PUT Bucket acl and PUT Object acl calls fail if the specified ACL is public.
    • PUT Object calls fail if the request includes a public ACL.
    • PUT Bucket calls fail if the request includes a public ACL.
    BlockPublicPolicy bool
    Whether Amazon S3 should block public bucket policies for buckets in this account. Defaults to true. Enabling this setting does not affect existing bucket policies. When set to true causes Amazon S3 to:

    • Reject calls to PUT Bucket policy if the specified bucket policy allows public access.
    IgnorePublicAcls bool
    Whether Amazon S3 should ignore public ACLs for buckets in this account. Defaults to true. Enabling this setting does not affect the persistence of any existing ACLs and doesn't prevent new public ACLs from being set. When set to true causes Amazon S3 to:

    • Ignore all public ACLs on buckets in this account and any objects that they contain.
    RestrictPublicBuckets bool
    Whether Amazon S3 should restrict public bucket policies for buckets in this account. Defaults to true. Enabling this setting does not affect previously stored bucket policies, except that public and cross-account access within any public bucket policy, including non-public delegation to specific accounts, is blocked. When set to true:

    • Only the bucket owner and AWS Services can access buckets with public policies.
    BlockPublicAcls bool
    Whether Amazon S3 should block public ACLs for buckets in this account. Defaults to true. Enabling this setting does not affect existing policies or ACLs. When set to true causes the following behavior:

    • PUT Bucket acl and PUT Object acl calls fail if the specified ACL is public.
    • PUT Object calls fail if the request includes a public ACL.
    • PUT Bucket calls fail if the request includes a public ACL.
    BlockPublicPolicy bool
    Whether Amazon S3 should block public bucket policies for buckets in this account. Defaults to true. Enabling this setting does not affect existing bucket policies. When set to true causes Amazon S3 to:

    • Reject calls to PUT Bucket policy if the specified bucket policy allows public access.
    IgnorePublicAcls bool
    Whether Amazon S3 should ignore public ACLs for buckets in this account. Defaults to true. Enabling this setting does not affect the persistence of any existing ACLs and doesn't prevent new public ACLs from being set. When set to true causes Amazon S3 to:

    • Ignore all public ACLs on buckets in this account and any objects that they contain.
    RestrictPublicBuckets bool
    Whether Amazon S3 should restrict public bucket policies for buckets in this account. Defaults to true. Enabling this setting does not affect previously stored bucket policies, except that public and cross-account access within any public bucket policy, including non-public delegation to specific accounts, is blocked. When set to true:

    • Only the bucket owner and AWS Services can access buckets with public policies.
    block_public_acls bool
    Whether Amazon S3 should block public ACLs for buckets in this account. Defaults to true. Enabling this setting does not affect existing policies or ACLs. When set to true causes the following behavior:

    • PUT Bucket acl and PUT Object acl calls fail if the specified ACL is public.
    • PUT Object calls fail if the request includes a public ACL.
    • PUT Bucket calls fail if the request includes a public ACL.
    block_public_policy bool
    Whether Amazon S3 should block public bucket policies for buckets in this account. Defaults to true. Enabling this setting does not affect existing bucket policies. When set to true causes Amazon S3 to:

    • Reject calls to PUT Bucket policy if the specified bucket policy allows public access.
    ignore_public_acls bool
    Whether Amazon S3 should ignore public ACLs for buckets in this account. Defaults to true. Enabling this setting does not affect the persistence of any existing ACLs and doesn't prevent new public ACLs from being set. When set to true causes Amazon S3 to:

    • Ignore all public ACLs on buckets in this account and any objects that they contain.
    restrict_public_buckets bool
    Whether Amazon S3 should restrict public bucket policies for buckets in this account. Defaults to true. Enabling this setting does not affect previously stored bucket policies, except that public and cross-account access within any public bucket policy, including non-public delegation to specific accounts, is blocked. When set to true:

    • Only the bucket owner and AWS Services can access buckets with public policies.
    blockPublicAcls Boolean
    Whether Amazon S3 should block public ACLs for buckets in this account. Defaults to true. Enabling this setting does not affect existing policies or ACLs. When set to true causes the following behavior:

    • PUT Bucket acl and PUT Object acl calls fail if the specified ACL is public.
    • PUT Object calls fail if the request includes a public ACL.
    • PUT Bucket calls fail if the request includes a public ACL.
    blockPublicPolicy Boolean
    Whether Amazon S3 should block public bucket policies for buckets in this account. Defaults to true. Enabling this setting does not affect existing bucket policies. When set to true causes Amazon S3 to:

    • Reject calls to PUT Bucket policy if the specified bucket policy allows public access.
    ignorePublicAcls Boolean
    Whether Amazon S3 should ignore public ACLs for buckets in this account. Defaults to true. Enabling this setting does not affect the persistence of any existing ACLs and doesn't prevent new public ACLs from being set. When set to true causes Amazon S3 to:

    • Ignore all public ACLs on buckets in this account and any objects that they contain.
    restrictPublicBuckets Boolean
    Whether Amazon S3 should restrict public bucket policies for buckets in this account. Defaults to true. Enabling this setting does not affect previously stored bucket policies, except that public and cross-account access within any public bucket policy, including non-public delegation to specific accounts, is blocked. When set to true:

    • Only the bucket owner and AWS Services can access buckets with public policies.
    blockPublicAcls boolean
    Whether Amazon S3 should block public ACLs for buckets in this account. Defaults to true. Enabling this setting does not affect existing policies or ACLs. When set to true causes the following behavior:

    • PUT Bucket acl and PUT Object acl calls fail if the specified ACL is public.
    • PUT Object calls fail if the request includes a public ACL.
    • PUT Bucket calls fail if the request includes a public ACL.
    blockPublicPolicy boolean
    Whether Amazon S3 should block public bucket policies for buckets in this account. Defaults to true. Enabling this setting does not affect existing bucket policies. When set to true causes Amazon S3 to:

    • Reject calls to PUT Bucket policy if the specified bucket policy allows public access.
    ignorePublicAcls boolean
    Whether Amazon S3 should ignore public ACLs for buckets in this account. Defaults to true. Enabling this setting does not affect the persistence of any existing ACLs and doesn't prevent new public ACLs from being set. When set to true causes Amazon S3 to:

    • Ignore all public ACLs on buckets in this account and any objects that they contain.
    restrictPublicBuckets boolean
    Whether Amazon S3 should restrict public bucket policies for buckets in this account. Defaults to true. Enabling this setting does not affect previously stored bucket policies, except that public and cross-account access within any public bucket policy, including non-public delegation to specific accounts, is blocked. When set to true:

    • Only the bucket owner and AWS Services can access buckets with public policies.
    block_public_acls bool
    Whether Amazon S3 should block public ACLs for buckets in this account. Defaults to true. Enabling this setting does not affect existing policies or ACLs. When set to true causes the following behavior:

    • PUT Bucket acl and PUT Object acl calls fail if the specified ACL is public.
    • PUT Object calls fail if the request includes a public ACL.
    • PUT Bucket calls fail if the request includes a public ACL.
    block_public_policy bool
    Whether Amazon S3 should block public bucket policies for buckets in this account. Defaults to true. Enabling this setting does not affect existing bucket policies. When set to true causes Amazon S3 to:

    • Reject calls to PUT Bucket policy if the specified bucket policy allows public access.
    ignore_public_acls bool
    Whether Amazon S3 should ignore public ACLs for buckets in this account. Defaults to true. Enabling this setting does not affect the persistence of any existing ACLs and doesn't prevent new public ACLs from being set. When set to true causes Amazon S3 to:

    • Ignore all public ACLs on buckets in this account and any objects that they contain.
    restrict_public_buckets bool
    Whether Amazon S3 should restrict public bucket policies for buckets in this account. Defaults to true. Enabling this setting does not affect previously stored bucket policies, except that public and cross-account access within any public bucket policy, including non-public delegation to specific accounts, is blocked. When set to true:

    • Only the bucket owner and AWS Services can access buckets with public policies.
    blockPublicAcls Boolean
    Whether Amazon S3 should block public ACLs for buckets in this account. Defaults to true. Enabling this setting does not affect existing policies or ACLs. When set to true causes the following behavior:

    • PUT Bucket acl and PUT Object acl calls fail if the specified ACL is public.
    • PUT Object calls fail if the request includes a public ACL.
    • PUT Bucket calls fail if the request includes a public ACL.
    blockPublicPolicy Boolean
    Whether Amazon S3 should block public bucket policies for buckets in this account. Defaults to true. Enabling this setting does not affect existing bucket policies. When set to true causes Amazon S3 to:

    • Reject calls to PUT Bucket policy if the specified bucket policy allows public access.
    ignorePublicAcls Boolean
    Whether Amazon S3 should ignore public ACLs for buckets in this account. Defaults to true. Enabling this setting does not affect the persistence of any existing ACLs and doesn't prevent new public ACLs from being set. When set to true causes Amazon S3 to:

    • Ignore all public ACLs on buckets in this account and any objects that they contain.
    restrictPublicBuckets Boolean
    Whether Amazon S3 should restrict public bucket policies for buckets in this account. Defaults to true. Enabling this setting does not affect previously stored bucket policies, except that public and cross-account access within any public bucket policy, including non-public delegation to specific accounts, is blocked. When set to true:

    • Only the bucket owner and AWS Services can access buckets with public policies.

    MultiRegionAccessPointDetailsRegion, MultiRegionAccessPointDetailsRegionArgs

    Bucket string
    The name of the associated bucket for the Region.
    BucketAccountId string
    The AWS account ID that owns the Amazon S3 bucket that's associated with this Multi-Region Access Point.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Bucket string
    The name of the associated bucket for the Region.
    BucketAccountId string
    The AWS account ID that owns the Amazon S3 bucket that's associated with this Multi-Region Access Point.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    bucket string
    The name of the associated bucket for the Region.
    bucket_account_id string
    The AWS account ID that owns the Amazon S3 bucket that's associated with this Multi-Region Access Point.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    bucket String
    The name of the associated bucket for the Region.
    bucketAccountId String
    The AWS account ID that owns the Amazon S3 bucket that's associated with this Multi-Region Access Point.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    bucket string
    The name of the associated bucket for the Region.
    bucketAccountId string
    The AWS account ID that owns the Amazon S3 bucket that's associated with this Multi-Region Access Point.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    bucket str
    The name of the associated bucket for the Region.
    bucket_account_id str
    The AWS account ID that owns the Amazon S3 bucket that's associated with this Multi-Region Access Point.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    bucket String
    The name of the associated bucket for the Region.
    bucketAccountId String
    The AWS account ID that owns the Amazon S3 bucket that's associated with this Multi-Region Access Point.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.

    Import

    Identity Schema

    Required

    • name (String) Name of the Multi-Region Access Point.

    Optional

    • accountId (String) AWS Account where this resource is managed.
    • region (String) Region where this resource is managed.

    Using pulumi import, import Multi-Region Access Points using the accountId and name of the Multi-Region Access Point separated by a colon (:). For example:

    $ pulumi import aws:s3control/multiRegionAccessPoint:MultiRegionAccessPoint example 123456789012:example

    To learn more about importing existing cloud resources, see Importing resources.

    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.32.0
    published on Friday, May 29, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial