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

aws.s3control.MultiRegionAccessPointRoutes

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 the routing configuration for an S3 Multi-Region Access Point.

    Note: Destruction of this resource only removes it from state. It does not alter the configured traffic routing percentages.

    Example Usage

    Active-Active Configuration

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

const primary = new aws.s3.Bucket("primary", {bucket: "example-bucket-primary"});
const secondary = new aws.s3.Bucket("secondary", {bucket: "example-bucket-secondary"});
const example = new aws.s3control.MultiRegionAccessPoint("example", {details: {
    name: "example",
    regions: [
        {
            bucket: primary.bucket,
        },
        {
            bucket: secondary.bucket,
        },
    ],
}});
const exampleMultiRegionAccessPointRoutes = new aws.s3control.MultiRegionAccessPointRoutes("example", {
    mrap: example.arn,
    routes: [
        {
            bucket: primary.bucket,
            region: primary.bucketRegion,
            trafficDialPercentage: 100,
        },
        {
            bucket: secondary.bucket,
            region: secondary.bucketRegion,
            trafficDialPercentage: 100,
        },
    ],
});

    import pulumi
import pulumi_aws as aws

primary = aws.s3.Bucket("primary", bucket="example-bucket-primary")
secondary = aws.s3.Bucket("secondary", bucket="example-bucket-secondary")
example = aws.s3control.MultiRegionAccessPoint("example", details={
    "name": "example",
    "regions": [
        {
            "bucket": primary.bucket,
        },
        {
            "bucket": secondary.bucket,
        },
    ],
})
example_multi_region_access_point_routes = aws.s3control.MultiRegionAccessPointRoutes("example",
    mrap=example.arn,
    routes=[
        {
            "bucket": primary.bucket,
            "region": primary.bucket_region,
            "traffic_dial_percentage": 100,
        },
        {
            "bucket": secondary.bucket,
            "region": secondary.bucket_region,
            "traffic_dial_percentage": 100,
        },
    ])

    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 {
		primary, err := s3.NewBucket(ctx, "primary", &s3.BucketArgs{
			Bucket: pulumi.String("example-bucket-primary"),
		})
		if err != nil {
			return err
		}
		secondary, err := s3.NewBucket(ctx, "secondary", &s3.BucketArgs{
			Bucket: pulumi.String("example-bucket-secondary"),
		})
		if err != nil {
			return err
		}
		example, err := s3control.NewMultiRegionAccessPoint(ctx, "example", &s3control.MultiRegionAccessPointArgs{
			Details: &s3control.MultiRegionAccessPointDetailsArgs{
				Name: pulumi.String("example"),
				Regions: s3control.MultiRegionAccessPointDetailsRegionArray{
					&s3control.MultiRegionAccessPointDetailsRegionArgs{
						Bucket: primary.Bucket,
					},
					&s3control.MultiRegionAccessPointDetailsRegionArgs{
						Bucket: secondary.Bucket,
					},
				},
			},
		})
		if err != nil {
			return err
		}
		_, err = s3control.NewMultiRegionAccessPointRoutes(ctx, "example", &s3control.MultiRegionAccessPointRoutesArgs{
			Mrap: example.Arn,
			Routes: s3control.MultiRegionAccessPointRoutesRouteArray{
				&s3control.MultiRegionAccessPointRoutesRouteArgs{
					Bucket:                primary.Bucket,
					Region:                primary.BucketRegion,
					TrafficDialPercentage: pulumi.Int(100),
				},
				&s3control.MultiRegionAccessPointRoutesRouteArgs{
					Bucket:                secondary.Bucket,
					Region:                secondary.BucketRegion,
					TrafficDialPercentage: pulumi.Int(100),
				},
			},
		})
		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 primary = new Aws.S3.Bucket("primary", new()
    {
        BucketName = "example-bucket-primary",
    });

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

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

    var exampleMultiRegionAccessPointRoutes = new Aws.S3Control.MultiRegionAccessPointRoutes("example", new()
    {
        Mrap = example.Arn,
        Routes = new[]
        {
            new Aws.S3Control.Inputs.MultiRegionAccessPointRoutesRouteArgs
            {
                Bucket = primary.BucketName,
                Region = primary.BucketRegion,
                TrafficDialPercentage = 100,
            },
            new Aws.S3Control.Inputs.MultiRegionAccessPointRoutesRouteArgs
            {
                Bucket = secondary.BucketName,
                Region = secondary.BucketRegion,
                TrafficDialPercentage = 100,
            },
        },
    });

});

    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 com.pulumi.aws.s3control.MultiRegionAccessPointRoutes;
import com.pulumi.aws.s3control.MultiRegionAccessPointRoutesArgs;
import com.pulumi.aws.s3control.inputs.MultiRegionAccessPointRoutesRouteArgs;
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 primary = new Bucket("primary", BucketArgs.builder()
            .bucket("example-bucket-primary")
            .build());

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

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

        var exampleMultiRegionAccessPointRoutes = new MultiRegionAccessPointRoutes("exampleMultiRegionAccessPointRoutes", MultiRegionAccessPointRoutesArgs.builder()
            .mrap(example.arn())
            .routes(            
                MultiRegionAccessPointRoutesRouteArgs.builder()
                    .bucket(primary.bucket())
                    .region(primary.bucketRegion())
                    .trafficDialPercentage(100)
                    .build(),
                MultiRegionAccessPointRoutesRouteArgs.builder()
                    .bucket(secondary.bucket())
                    .region(secondary.bucketRegion())
                    .trafficDialPercentage(100)
                    .build())
            .build());

    }
}

    resources:
  primary:
    type: aws:s3:Bucket
    properties:
      bucket: example-bucket-primary
  secondary:
    type: aws:s3:Bucket
    properties:
      bucket: example-bucket-secondary
  example:
    type: aws:s3control:MultiRegionAccessPoint
    properties:
      details:
        name: example
        regions:
          - bucket: ${primary.bucket}
          - bucket: ${secondary.bucket}
  exampleMultiRegionAccessPointRoutes:
    type: aws:s3control:MultiRegionAccessPointRoutes
    name: example
    properties:
      mrap: ${example.arn}
      routes:
        - bucket: ${primary.bucket}
          region: ${primary.bucketRegion}
          trafficDialPercentage: 100
        - bucket: ${secondary.bucket}
          region: ${secondary.bucketRegion}
          trafficDialPercentage: 100

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

resource "aws_s3_bucket" "primary" {
  bucket = "example-bucket-primary"
}
resource "aws_s3_bucket" "secondary" {
  bucket = "example-bucket-secondary"
}
resource "aws_s3control_multiregionaccesspoint" "example" {
  details = {
    name = "example"
    regions = [{
      "bucket" = aws_s3_bucket.primary.bucket
      }, {
      "bucket" = aws_s3_bucket.secondary.bucket
    }]
  }
}
resource "aws_s3control_multiregionaccesspointroutes" "example" {
  mrap = aws_s3control_multiregionaccesspoint.example.arn
  routes {
    bucket                  = aws_s3_bucket.primary.bucket
    region                  = aws_s3_bucket.primary.bucket_region
    traffic_dial_percentage = 100
  }
  routes {
    bucket                  = aws_s3_bucket.secondary.bucket
    region                  = aws_s3_bucket.secondary.bucket_region
    traffic_dial_percentage = 100
  }
}

    Failover Configuration

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

const example = new aws.s3control.MultiRegionAccessPointRoutes("example", {
    mrap: exampleAwsS3controlMultiRegionAccessPoint.arn,
    routes: [
        {
            bucket: primary.bucket,
            region: primary.bucketRegion,
            trafficDialPercentage: 0,
        },
        {
            bucket: secondary.bucket,
            region: secondary.bucketRegion,
            trafficDialPercentage: 100,
        },
    ],
});

    import pulumi
import pulumi_aws as aws

example = aws.s3control.MultiRegionAccessPointRoutes("example",
    mrap=example_aws_s3control_multi_region_access_point["arn"],
    routes=[
        {
            "bucket": primary["bucket"],
            "region": primary["bucketRegion"],
            "traffic_dial_percentage": 0,
        },
        {
            "bucket": secondary["bucket"],
            "region": secondary["bucketRegion"],
            "traffic_dial_percentage": 100,
        },
    ])

    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.NewMultiRegionAccessPointRoutes(ctx, "example", &s3control.MultiRegionAccessPointRoutesArgs{
			Mrap: pulumi.Any(exampleAwsS3controlMultiRegionAccessPoint.Arn),
			Routes: s3control.MultiRegionAccessPointRoutesRouteArray{
				&s3control.MultiRegionAccessPointRoutesRouteArgs{
					Bucket:                pulumi.Any(primary.Bucket),
					Region:                pulumi.Any(primary.BucketRegion),
					TrafficDialPercentage: pulumi.Int(0),
				},
				&s3control.MultiRegionAccessPointRoutesRouteArgs{
					Bucket:                pulumi.Any(secondary.Bucket),
					Region:                pulumi.Any(secondary.BucketRegion),
					TrafficDialPercentage: pulumi.Int(100),
				},
			},
		})
		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 = new Aws.S3Control.MultiRegionAccessPointRoutes("example", new()
    {
        Mrap = exampleAwsS3controlMultiRegionAccessPoint.Arn,
        Routes = new[]
        {
            new Aws.S3Control.Inputs.MultiRegionAccessPointRoutesRouteArgs
            {
                Bucket = primary.Bucket,
                Region = primary.BucketRegion,
                TrafficDialPercentage = 0,
            },
            new Aws.S3Control.Inputs.MultiRegionAccessPointRoutesRouteArgs
            {
                Bucket = secondary.Bucket,
                Region = secondary.BucketRegion,
                TrafficDialPercentage = 100,
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.s3control.MultiRegionAccessPointRoutes;
import com.pulumi.aws.s3control.MultiRegionAccessPointRoutesArgs;
import com.pulumi.aws.s3control.inputs.MultiRegionAccessPointRoutesRouteArgs;
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 example = new MultiRegionAccessPointRoutes("example", MultiRegionAccessPointRoutesArgs.builder()
            .mrap(exampleAwsS3controlMultiRegionAccessPoint.arn())
            .routes(            
                MultiRegionAccessPointRoutesRouteArgs.builder()
                    .bucket(primary.bucket())
                    .region(primary.bucketRegion())
                    .trafficDialPercentage(0)
                    .build(),
                MultiRegionAccessPointRoutesRouteArgs.builder()
                    .bucket(secondary.bucket())
                    .region(secondary.bucketRegion())
                    .trafficDialPercentage(100)
                    .build())
            .build());

    }
}

    resources:
  example:
    type: aws:s3control:MultiRegionAccessPointRoutes
    properties:
      mrap: ${exampleAwsS3controlMultiRegionAccessPoint.arn}
      routes:
        - bucket: ${primary.bucket}
          region: ${primary.bucketRegion}
          trafficDialPercentage: 0
        - bucket: ${secondary.bucket}
          region: ${secondary.bucketRegion}
          trafficDialPercentage: 100

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

resource "aws_s3control_multiregionaccesspointroutes" "example" {
  mrap = exampleAwsS3controlMultiRegionAccessPoint.arn
  routes {
    bucket                  = primary.bucket
    region                  = primary.bucketRegion
    traffic_dial_percentage = 0
  }
  routes {
    bucket                  = secondary.bucket
    region                  = secondary.bucketRegion
    traffic_dial_percentage = 100
  }
}

    Create MultiRegionAccessPointRoutes Resource

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

    Constructor syntax

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

@overload
def MultiRegionAccessPointRoutes(resource_name: str,
                                 opts: Optional[ResourceOptions] = None,
                                 mrap: Optional[str] = None,
                                 routes: Optional[Sequence[MultiRegionAccessPointRoutesRouteArgs]] = None,
                                 account_id: Optional[str] = None,
                                 region: Optional[str] = None)
    func NewMultiRegionAccessPointRoutes(ctx *Context, name string, args MultiRegionAccessPointRoutesArgs, opts ...ResourceOption) (*MultiRegionAccessPointRoutes, error)
    public MultiRegionAccessPointRoutes(string name, MultiRegionAccessPointRoutesArgs args, CustomResourceOptions? opts = null)
    public MultiRegionAccessPointRoutes(String name, MultiRegionAccessPointRoutesArgs args)
public MultiRegionAccessPointRoutes(String name, MultiRegionAccessPointRoutesArgs args, CustomResourceOptions options)

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


    resource "aws_s3control_multiregionaccesspointroutes" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args MultiRegionAccessPointRoutesArgs
    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 MultiRegionAccessPointRoutesArgs
    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 MultiRegionAccessPointRoutesArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args MultiRegionAccessPointRoutesArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args MultiRegionAccessPointRoutesArgs
    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 multiRegionAccessPointRoutesResource = new Aws.S3Control.MultiRegionAccessPointRoutes("multiRegionAccessPointRoutesResource", new()
{
    Mrap = "string",
    Routes = new[]
    {
        new Aws.S3Control.Inputs.MultiRegionAccessPointRoutesRouteArgs
        {
            Bucket = "string",
            Region = "string",
            TrafficDialPercentage = 0,
        },
    },
    AccountId = "string",
    Region = "string",
});

    example, err := s3control.NewMultiRegionAccessPointRoutes(ctx, "multiRegionAccessPointRoutesResource", &s3control.MultiRegionAccessPointRoutesArgs{
	Mrap: pulumi.String("string"),
	Routes: s3control.MultiRegionAccessPointRoutesRouteArray{
		&s3control.MultiRegionAccessPointRoutesRouteArgs{
			Bucket:                pulumi.String("string"),
			Region:                pulumi.String("string"),
			TrafficDialPercentage: pulumi.Int(0),
		},
	},
	AccountId: pulumi.String("string"),
	Region:    pulumi.String("string"),
})

    resource "aws_s3control_multiregionaccesspointroutes" "multiRegionAccessPointRoutesResource" {
  mrap = "string"
  routes {
    bucket                  = "string"
    region                  = "string"
    traffic_dial_percentage = 0
  }
  account_id = "string"
  region     = "string"
}

    var multiRegionAccessPointRoutesResource = new MultiRegionAccessPointRoutes("multiRegionAccessPointRoutesResource", MultiRegionAccessPointRoutesArgs.builder()
    .mrap("string")
    .routes(MultiRegionAccessPointRoutesRouteArgs.builder()
        .bucket("string")
        .region("string")
        .trafficDialPercentage(0)
        .build())
    .accountId("string")
    .region("string")
    .build());

    multi_region_access_point_routes_resource = aws.s3control.MultiRegionAccessPointRoutes("multiRegionAccessPointRoutesResource",
    mrap="string",
    routes=[{
        "bucket": "string",
        "region": "string",
        "traffic_dial_percentage": 0,
    }],
    account_id="string",
    region="string")

    const multiRegionAccessPointRoutesResource = new aws.s3control.MultiRegionAccessPointRoutes("multiRegionAccessPointRoutesResource", {
    mrap: "string",
    routes: [{
        bucket: "string",
        region: "string",
        trafficDialPercentage: 0,
    }],
    accountId: "string",
    region: "string",
});

    type: aws:s3control:MultiRegionAccessPointRoutes
properties:
    accountId: string
    mrap: string
    region: string
    routes:
        - bucket: string
          region: string
          trafficDialPercentage: 0

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

    Mrap string
    ARN of the Multi-Region Access Point.
    Routes List<MultiRegionAccessPointRoutesRoute>
    Route configurations. At least one route must have a trafficDialPercentage of 100. See route below.
    AccountId string
    AWS account ID for the owner of the Multi-Region Access Point. Defaults to automatically determined account ID of the Terraform AWS provider.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Mrap string
    ARN of the Multi-Region Access Point.
    Routes []MultiRegionAccessPointRoutesRouteArgs
    Route configurations. At least one route must have a trafficDialPercentage of 100. See route below.
    AccountId string
    AWS account ID for the owner of the Multi-Region Access Point. Defaults to automatically determined account ID of the Terraform AWS provider.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    mrap string
    ARN of the Multi-Region Access Point.
    routes list(object)
    Route configurations. At least one route must have a trafficDialPercentage of 100. See route below.
    account_id string
    AWS account ID for the owner of the Multi-Region Access Point. Defaults to automatically determined account ID of the Terraform AWS provider.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    mrap String
    ARN of the Multi-Region Access Point.
    routes List<MultiRegionAccessPointRoutesRoute>
    Route configurations. At least one route must have a trafficDialPercentage of 100. See route below.
    accountId String
    AWS account ID for the owner of the Multi-Region Access Point. Defaults to automatically determined account ID of the Terraform AWS provider.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    mrap string
    ARN of the Multi-Region Access Point.
    routes MultiRegionAccessPointRoutesRoute[]
    Route configurations. At least one route must have a trafficDialPercentage of 100. See route below.
    accountId string
    AWS account ID for the owner of the Multi-Region Access Point. Defaults to automatically determined account ID of the Terraform AWS provider.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    mrap str
    ARN of the Multi-Region Access Point.
    routes Sequence[MultiRegionAccessPointRoutesRouteArgs]
    Route configurations. At least one route must have a trafficDialPercentage of 100. See route below.
    account_id str
    AWS account ID for the owner of the Multi-Region Access Point. Defaults to automatically determined account ID of the Terraform AWS provider.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    mrap String
    ARN of the Multi-Region Access Point.
    routes List<Property Map>
    Route configurations. At least one route must have a trafficDialPercentage of 100. See route below.
    accountId String
    AWS account ID for the owner of the Multi-Region Access Point. Defaults to automatically determined account ID of the Terraform 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 MultiRegionAccessPointRoutes resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing MultiRegionAccessPointRoutes Resource

    Get an existing MultiRegionAccessPointRoutes 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?: MultiRegionAccessPointRoutesState, opts?: CustomResourceOptions): MultiRegionAccessPointRoutes
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        account_id: Optional[str] = None,
        mrap: Optional[str] = None,
        region: Optional[str] = None,
        routes: Optional[Sequence[MultiRegionAccessPointRoutesRouteArgs]] = None) -> MultiRegionAccessPointRoutes
    func GetMultiRegionAccessPointRoutes(ctx *Context, name string, id IDInput, state *MultiRegionAccessPointRoutesState, opts ...ResourceOption) (*MultiRegionAccessPointRoutes, error)
    public static MultiRegionAccessPointRoutes Get(string name, Input<string> id, MultiRegionAccessPointRoutesState? state, CustomResourceOptions? opts = null)
    public static MultiRegionAccessPointRoutes get(String name, Output<String> id, MultiRegionAccessPointRoutesState state, CustomResourceOptions options)
    resources:  _:    type: aws:s3control:MultiRegionAccessPointRoutes    get:      id: ${id}
    import {
  to = aws_s3control_multiregionaccesspointroutes.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
    AWS account ID for the owner of the Multi-Region Access Point. Defaults to automatically determined account ID of the Terraform AWS provider.
    Mrap string
    ARN of the Multi-Region Access Point.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Routes List<MultiRegionAccessPointRoutesRoute>
    Route configurations. At least one route must have a trafficDialPercentage of 100. See route below.
    AccountId string
    AWS account ID for the owner of the Multi-Region Access Point. Defaults to automatically determined account ID of the Terraform AWS provider.
    Mrap string
    ARN of the Multi-Region Access Point.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Routes []MultiRegionAccessPointRoutesRouteArgs
    Route configurations. At least one route must have a trafficDialPercentage of 100. See route below.
    account_id string
    AWS account ID for the owner of the Multi-Region Access Point. Defaults to automatically determined account ID of the Terraform AWS provider.
    mrap string
    ARN of the Multi-Region Access Point.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    routes list(object)
    Route configurations. At least one route must have a trafficDialPercentage of 100. See route below.
    accountId String
    AWS account ID for the owner of the Multi-Region Access Point. Defaults to automatically determined account ID of the Terraform AWS provider.
    mrap String
    ARN of the Multi-Region Access Point.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    routes List<MultiRegionAccessPointRoutesRoute>
    Route configurations. At least one route must have a trafficDialPercentage of 100. See route below.
    accountId string
    AWS account ID for the owner of the Multi-Region Access Point. Defaults to automatically determined account ID of the Terraform AWS provider.
    mrap string
    ARN of the Multi-Region Access Point.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    routes MultiRegionAccessPointRoutesRoute[]
    Route configurations. At least one route must have a trafficDialPercentage of 100. See route below.
    account_id str
    AWS account ID for the owner of the Multi-Region Access Point. Defaults to automatically determined account ID of the Terraform AWS provider.
    mrap str
    ARN of the Multi-Region Access Point.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    routes Sequence[MultiRegionAccessPointRoutesRouteArgs]
    Route configurations. At least one route must have a trafficDialPercentage of 100. See route below.
    accountId String
    AWS account ID for the owner of the Multi-Region Access Point. Defaults to automatically determined account ID of the Terraform AWS provider.
    mrap String
    ARN of the Multi-Region Access Point.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    routes List<Property Map>
    Route configurations. At least one route must have a trafficDialPercentage of 100. See route below.

    Supporting Types

    MultiRegionAccessPointRoutesRoute, MultiRegionAccessPointRoutesRouteArgs

    Bucket string
    Name of the Amazon S3 bucket.
    Region string
    AWS Region where the bucket is located.
    TrafficDialPercentage int
    Traffic routing configuration. A value of 0 indicates a passive status (traffic will not be routed to the Region), and a value of 100 indicates an active status (traffic will be routed to the Region).
    Bucket string
    Name of the Amazon S3 bucket.
    Region string
    AWS Region where the bucket is located.
    TrafficDialPercentage int
    Traffic routing configuration. A value of 0 indicates a passive status (traffic will not be routed to the Region), and a value of 100 indicates an active status (traffic will be routed to the Region).
    bucket string
    Name of the Amazon S3 bucket.
    region string
    AWS Region where the bucket is located.
    traffic_dial_percentage number
    Traffic routing configuration. A value of 0 indicates a passive status (traffic will not be routed to the Region), and a value of 100 indicates an active status (traffic will be routed to the Region).
    bucket String
    Name of the Amazon S3 bucket.
    region String
    AWS Region where the bucket is located.
    trafficDialPercentage Integer
    Traffic routing configuration. A value of 0 indicates a passive status (traffic will not be routed to the Region), and a value of 100 indicates an active status (traffic will be routed to the Region).
    bucket string
    Name of the Amazon S3 bucket.
    region string
    AWS Region where the bucket is located.
    trafficDialPercentage number
    Traffic routing configuration. A value of 0 indicates a passive status (traffic will not be routed to the Region), and a value of 100 indicates an active status (traffic will be routed to the Region).
    bucket str
    Name of the Amazon S3 bucket.
    region str
    AWS Region where the bucket is located.
    traffic_dial_percentage int
    Traffic routing configuration. A value of 0 indicates a passive status (traffic will not be routed to the Region), and a value of 100 indicates an active status (traffic will be routed to the Region).
    bucket String
    Name of the Amazon S3 bucket.
    region String
    AWS Region where the bucket is located.
    trafficDialPercentage Number
    Traffic routing configuration. A value of 0 indicates a passive status (traffic will not be routed to the Region), and a value of 100 indicates an active status (traffic will be routed to the Region).

    Import

    Identity Schema

    Required

    • mrap (String) ARN 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 Point Routes using the mrap argument. For example:

    $ pulumi import aws:s3control/multiRegionAccessPointRoutes:MultiRegionAccessPointRoutes example arn:aws:s3::0123456789012:accesspoint/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