Skip to content

Put Bucket Lifecycle Configuration

s3control_put_bucket_lifecycle_configuration R Documentation

This action puts a lifecycle configuration to an Amazon S3 on Outposts bucket

Description

This action puts a lifecycle configuration to an Amazon S3 on Outposts bucket. To put a lifecycle configuration to an S3 bucket, see put_bucket_lifecycle_configuration in the Amazon S3 API Reference.

Creates a new lifecycle configuration for the S3 on Outposts bucket or replaces an existing lifecycle configuration. Outposts buckets only support lifecycle configurations that delete/expire objects after a certain period of time and abort incomplete multipart uploads.

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request. In addition, you must use an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived by using the access point ARN, see the Examples section.

The following actions are related to put_bucket_lifecycle_configuration:

  • get_bucket_lifecycle_configuration

  • delete_bucket_lifecycle_configuration

Usage

s3control_put_bucket_lifecycle_configuration(AccountId, Bucket,
  LifecycleConfiguration)

Arguments

AccountId

[required] The Amazon Web Services account ID of the Outposts bucket.

Bucket

[required] The name of the bucket for which to set the configuration.

LifecycleConfiguration

Container for lifecycle rules. You can add as many as 1,000 rules.

Value

An empty list.

Request syntax

svc$put_bucket_lifecycle_configuration(
  AccountId = "string",
  Bucket = "string",
  LifecycleConfiguration = list(
    Rules = list(
      list(
        Expiration = list(
          Date = as.POSIXct(
            "2015-01-01"
          ),
          Days = 123,
          ExpiredObjectDeleteMarker = TRUE|FALSE
        ),
        ID = "string",
        Filter = list(
          Prefix = "string",
          Tag = list(
            Key = "string",
            Value = "string"
          ),
          And = list(
            Prefix = "string",
            Tags = list(
              list(
                Key = "string",
                Value = "string"
              )
            ),
            ObjectSizeGreaterThan = 123,
            ObjectSizeLessThan = 123
          ),
          ObjectSizeGreaterThan = 123,
          ObjectSizeLessThan = 123
        ),
        Status = "Enabled"|"Disabled",
        Transitions = list(
          list(
            Date = as.POSIXct(
              "2015-01-01"
            ),
            Days = 123,
            StorageClass = "GLACIER"|"STANDARD_IA"|"ONEZONE_IA"|"INTELLIGENT_TIERING"|"DEEP_ARCHIVE"
          )
        ),
        NoncurrentVersionTransitions = list(
          list(
            NoncurrentDays = 123,
            StorageClass = "GLACIER"|"STANDARD_IA"|"ONEZONE_IA"|"INTELLIGENT_TIERING"|"DEEP_ARCHIVE"
          )
        ),
        NoncurrentVersionExpiration = list(
          NoncurrentDays = 123,
          NewerNoncurrentVersions = 123
        ),
        AbortIncompleteMultipartUpload = list(
          DaysAfterInitiation = 123
        )
      )
    )
  )
)