Resource: aws_s3_bucket_intelligent_tiering_configuration

Provides an S3 Intelligent-Tiering configuration resource.

Example Usage

Add intelligent tiering configuration for entire S3 bucket

resource "aws_s3_bucket_intelligent_tiering_configuration" "example-entire-bucket" {
  bucket = aws_s3_bucket.example.id
  name   = "EntireBucket"

  tiering {
    access_tier = "DEEP_ARCHIVE_ACCESS"
    days        = 180
  }
  tiering {
    access_tier = "ARCHIVE_ACCESS"
    days        = 125
  }
}

resource "aws_s3_bucket" "example" {
  bucket = "example"
}

Add intelligent tiering configuration with S3 object filter

resource "aws_s3_bucket_intelligent_tiering_configuration" "example-filtered" {
  bucket = aws_s3_bucket.example.id
  name   = "ImportantBlueDocuments"

  status = "Disabled"

  filter {
    prefix = "documents/"

    tags = {
      priority = "high"
      class    = "blue"
    }
  }

  tiering {
    access_tier = "ARCHIVE_ACCESS"
    days        = 125
  }
}

resource "aws_s3_bucket" "example" {
  bucket = "example"
}

Argument Reference

This resource supports the following arguments:

The filter configuration supports the following:

The tiering configuration supports the following:

Attribute Reference

This resource exports no additional attributes.

Import

In Terraform v1.5.0 and later, use an import block to import S3 bucket intelligent tiering configurations using bucket:name. For example:

import {
  to = aws_s3_bucket_intelligent_tiering_configuration.my-bucket-entire-bucket
  id = "my-bucket:EntireBucket"
}

Using terraform import, import S3 bucket intelligent tiering configurations using bucket:name. For example:

% terraform import aws_s3_bucket_intelligent_tiering_configuration.my-bucket-entire-bucket my-bucket:EntireBucket