aws_s3_bucket_metric

Provides a S3 bucket metrics configuration resource.

Example Usage

Add metrics configuration for entire S3 bucket

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

resource "aws_s3_bucket_metric" "example-entire-bucket" {
  bucket = "${aws_s3_bucket.example.bucket}"
  name   = "EntireBucket"
}

Add metrics configuration with S3 bucket object filter

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

resource "aws_s3_bucket_metric" "example-filtered" {
  bucket = "${aws_s3_bucket.example.bucket}"
  name   = "ImportantBlueDocuments"

  filter {
    prefix = "documents/"

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

Argument Reference

The following arguments are supported:

• bucket - (Required) The name of the bucket to put metric configuration.
• name - (Required) Unique identifier of the metrics configuration for the bucket.
• filter - (Optional) Object filtering that accepts a prefix, tags, or a logical AND of prefix and tags (documented below).

The filter metric configuration supports the following:

• prefix - (Optional) Object prefix for filtering (singular).
• tags - (Optional) Object tags for filtering (up to 10).

Import

S3 bucket metric configurations can be imported using bucket:metric, e.g.

$ terraform import aws_s3_bucket_metric.my-bucket-entire-bucket my-bucket:EntireBucket