Package com.pulumi.aws.s3control
Class MultiRegionAccessPoint
- java.lang.Object
-
- com.pulumi.resources.Resource
-
- com.pulumi.resources.CustomResource
-
- com.pulumi.aws.s3control.MultiRegionAccessPoint
-
public class MultiRegionAccessPoint extends com.pulumi.resources.CustomResourceProvides a resource to manage an S3 Multi-Region Access Point associated with specified buckets. > This resource cannot be used with S3 directory buckets. For more information, see the documentation on [Multi-Region Access Points](https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiRegionAccessPoints.html). ## Example Usage ### Multiple AWS Buckets in Different Regions
## 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: ```sh $ pulumi import aws:s3control/multiRegionAccessPoint:MultiRegionAccessPoint example 123456789012:example ```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.inputs.MultiRegionAccessPointDetailsRegionArgs; 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() .regions( MultiRegionAccessPointDetailsRegionArgs.builder() .bucket(fooBucket.id()) .build(), MultiRegionAccessPointDetailsRegionArgs.builder() .bucket(barBucket.id()) .build()) .name("example") .build()) .build()); } }
-
-
Constructor Summary
Constructors Constructor Description MultiRegionAccessPoint(java.lang.String name)MultiRegionAccessPoint(java.lang.String name, MultiRegionAccessPointArgs args)MultiRegionAccessPoint(java.lang.String name, MultiRegionAccessPointArgs args, com.pulumi.resources.CustomResourceOptions options)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description com.pulumi.core.Output<java.lang.String>accountId()com.pulumi.core.Output<java.lang.String>alias()com.pulumi.core.Output<java.lang.String>arn()com.pulumi.core.Output<MultiRegionAccessPointDetails>details()com.pulumi.core.Output<java.lang.String>domainName()static MultiRegionAccessPointget(java.lang.String name, com.pulumi.core.Output<java.lang.String> id, MultiRegionAccessPointState state, com.pulumi.resources.CustomResourceOptions options)Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.com.pulumi.core.Output<java.lang.String>name()com.pulumi.core.Output<java.lang.String>region()com.pulumi.core.Output<java.lang.String>status()
-
-
-
Constructor Detail
-
MultiRegionAccessPoint
public MultiRegionAccessPoint(java.lang.String name)
- Parameters:
name- The _unique_ name of the resulting resource.
-
MultiRegionAccessPoint
public MultiRegionAccessPoint(java.lang.String name, MultiRegionAccessPointArgs args)- Parameters:
name- The _unique_ name of the resulting resource.args- The arguments to use to populate this resource's properties.
-
MultiRegionAccessPoint
public MultiRegionAccessPoint(java.lang.String name, MultiRegionAccessPointArgs args, @Nullable com.pulumi.resources.CustomResourceOptions options)- Parameters:
name- The _unique_ name of the resulting resource.args- The arguments to use to populate this resource's properties.options- A bag of options that control this resource's behavior.
-
-
Method Detail
-
accountId
public com.pulumi.core.Output<java.lang.String> accountId()
- Returns:
- 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
public com.pulumi.core.Output<java.lang.String> alias()
- Returns:
- Alias for the Multi-Region Access Point.
-
arn
public com.pulumi.core.Output<java.lang.String> arn()
- Returns:
- ARN of the Multi-Region Access Point.
-
details
public com.pulumi.core.Output<MultiRegionAccessPointDetails> details()
- Returns:
- Configuration block containing details about the Multi-Region Access Point. See `details` Block below.
-
domainName
public com.pulumi.core.Output<java.lang.String> domainName()
- Returns:
- 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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiRegionAccessPointRequests.html).
-
name
public com.pulumi.core.Output<java.lang.String> name()
- Returns:
- Name of the Multi-Region Access Point.
-
region
public com.pulumi.core.Output<java.lang.String> region()
- Returns:
- Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.
-
status
public com.pulumi.core.Output<java.lang.String> status()
- Returns:
- Status of the Multi-Region Access Point. One of: `READY`, `INCONSISTENT_ACROSS_REGIONS`, `CREATING`, `PARTIALLY_CREATED`, `PARTIALLY_DELETED`, `DELETING`.
-
get
public static MultiRegionAccessPoint get(java.lang.String name, com.pulumi.core.Output<java.lang.String> id, @Nullable MultiRegionAccessPointState state, @Nullable com.pulumi.resources.CustomResourceOptions options)
Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.- Parameters:
name- The _unique_ name of the resulting resource.id- The _unique_ provider ID of the resource to lookup.state-options- Optional settings to control the behavior of the CustomResource.
-
-