Package com.pulumi.aws.s3

Class BucketIntelligentTieringConfiguration

java.lang.Object

com.pulumi.resources.Resource

com.pulumi.resources.CustomResource

com.pulumi.aws.s3.BucketIntelligentTieringConfiguration

public class BucketIntelligentTieringConfiguration
extends com.pulumi.resources.CustomResource

Provides an [S3 Intelligent-Tiering](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intelligent-tiering.html) configuration resource. > This resource cannot be used with S3 directory buckets. ## Example Usage ### Add intelligent tiering configuration for entire S3 bucket

 
 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.s3.BucketIntelligentTieringConfiguration;
 import com.pulumi.aws.s3.BucketIntelligentTieringConfigurationArgs;
 import com.pulumi.aws.s3.inputs.BucketIntelligentTieringConfigurationTieringArgs;
 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 Bucket("example", BucketArgs.builder()
             .bucket("example")
             .build());
 
         var example_entire_bucket = new BucketIntelligentTieringConfiguration("example-entire-bucket", BucketIntelligentTieringConfigurationArgs.builder()
             .tierings(            
                 BucketIntelligentTieringConfigurationTieringArgs.builder()
                     .accessTier("DEEP_ARCHIVE_ACCESS")
                     .days(180)
                     .build(),
                 BucketIntelligentTieringConfigurationTieringArgs.builder()
                     .accessTier("ARCHIVE_ACCESS")
                     .days(125)
                     .build())
             .bucket(example.id())
             .name("EntireBucket")
             .build());
 
     }
 }
 
 

### Add intelligent tiering configuration with S3 object filter

 
 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.s3.BucketIntelligentTieringConfiguration;
 import com.pulumi.aws.s3.BucketIntelligentTieringConfigurationArgs;
 import com.pulumi.aws.s3.inputs.BucketIntelligentTieringConfigurationFilterArgs;
 import com.pulumi.aws.s3.inputs.BucketIntelligentTieringConfigurationTieringArgs;
 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 Bucket("example", BucketArgs.builder()
             .bucket("example")
             .build());
 
         var example_filtered = new BucketIntelligentTieringConfiguration("example-filtered", BucketIntelligentTieringConfigurationArgs.builder()
             .filter(BucketIntelligentTieringConfigurationFilterArgs.builder()
                 .prefix("documents/")
                 .tags(Map.ofEntries(
                     Map.entry("priority", "high"),
                     Map.entry("class", "blue")
                 ))
                 .build())
             .tierings(BucketIntelligentTieringConfigurationTieringArgs.builder()
                 .accessTier("ARCHIVE_ACCESS")
                 .days(125)
                 .build())
             .bucket(example.id())
             .name("ImportantBlueDocuments")
             .status("Disabled")
             .build());
 
     }
 }
 
 

## Import Using `pulumi import`, import S3 bucket intelligent tiering configurations using `bucket:name`. For example: ```sh $ pulumi import aws:s3/bucketIntelligentTieringConfiguration:BucketIntelligentTieringConfiguration my-bucket-entire-bucket my-bucket:EntireBucket ```

Nested Class Summary

Nested classes/interfaces inherited from class com.pulumi.resources.CustomResource

com.pulumi.resources.CustomResource.CustomResourceInternal

Nested classes/interfaces inherited from class com.pulumi.resources.Resource

com.pulumi.resources.Resource.LazyField<T extends java.lang.Object>, com.pulumi.resources.Resource.LazyFields, com.pulumi.resources.Resource.ResourceInternal

Field Summary

Fields inherited from class com.pulumi.resources.Resource

childResources, remote

Constructor Summary

Constructors

Constructor	Description
BucketIntelligentTieringConfiguration(java.lang.String name)
BucketIntelligentTieringConfiguration(java.lang.String name, BucketIntelligentTieringConfigurationArgs args)
BucketIntelligentTieringConfiguration(java.lang.String name, BucketIntelligentTieringConfigurationArgs args, com.pulumi.resources.CustomResourceOptions options)

Method Summary

Modifier and Type	Method	Description
com.pulumi.core.Output<java.lang.String>	bucket()
com.pulumi.core.Output<java.util.Optional<BucketIntelligentTieringConfigurationFilter>>	filter()
static BucketIntelligentTieringConfiguration	get(java.lang.String name, com.pulumi.core.Output<java.lang.String> id, BucketIntelligentTieringConfigurationState 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.util.Optional<java.lang.String>>	status()
com.pulumi.core.Output<java.util.List<BucketIntelligentTieringConfigurationTiering>>	tierings()

Methods inherited from class com.pulumi.resources.CustomResource

getId, id, idFuture

Methods inherited from class com.pulumi.resources.Resource

getChildResources, getResourceName, getResourceType, getUrn, pulumiChildResources, pulumiResourceName, pulumiResourceType, urn

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BucketIntelligentTieringConfiguration

public BucketIntelligentTieringConfiguration(java.lang.String name)

Parameters:

name - The _unique_ name of the resulting resource.

BucketIntelligentTieringConfiguration

public BucketIntelligentTieringConfiguration(java.lang.String name,
                                             BucketIntelligentTieringConfigurationArgs args)

Parameters:

name - The _unique_ name of the resulting resource.

args - The arguments to use to populate this resource's properties.

BucketIntelligentTieringConfiguration

public BucketIntelligentTieringConfiguration(java.lang.String name,
                                             BucketIntelligentTieringConfigurationArgs 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

bucket

public com.pulumi.core.Output<java.lang.String> bucket()

Returns:

Name of the bucket this intelligent tiering configuration is associated with.

filter

public com.pulumi.core.Output<java.util.Optional<BucketIntelligentTieringConfigurationFilter>> filter()

Returns:

Bucket filter. The configuration only includes objects that meet the filter's criteria. See `filter` Block below.

name

public com.pulumi.core.Output<java.lang.String> name()

Returns:

Unique name used to identify the S3 Intelligent-Tiering configuration for the bucket.

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.util.Optional<java.lang.String>> status()

Returns:

Status of the configuration. Valid values: `Enabled`, `Disabled`.

tierings

public com.pulumi.core.Output<java.util.List<BucketIntelligentTieringConfigurationTiering>> tierings()

Returns:

S3 Intelligent-Tiering storage class tiers of the configuration. See `tiering` Block below.

get

public static BucketIntelligentTieringConfiguration get(java.lang.String name,
                                                        com.pulumi.core.Output<java.lang.String> id,
                                                        @Nullable
                                                        BucketIntelligentTieringConfigurationState 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.