Class: Aws::S3::Types::Rule

Inherits:
Struct
  • Object
show all
Includes:
Aws::Structure
Defined in:
lib/aws-sdk-s3/types.rb

Overview

Note:

When making an API call, you may pass Rule data as a hash:

{
  expiration: {
    date: Time.now,
    days: 1,
    expired_object_delete_marker: false,
  },
  id: "ID",
  prefix: "Prefix", # required
  status: "Enabled", # required, accepts Enabled, Disabled
  transition: {
    date: Time.now,
    days: 1,
    storage_class: "GLACIER", # accepts GLACIER, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, DEEP_ARCHIVE
  },
  noncurrent_version_transition: {
    noncurrent_days: 1,
    storage_class: "GLACIER", # accepts GLACIER, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, DEEP_ARCHIVE
  },
  noncurrent_version_expiration: {
    noncurrent_days: 1,
  },
  abort_incomplete_multipart_upload: {
    days_after_initiation: 1,
  },
}

Specifies lifecycle rules for an Amazon S3 bucket. For more information, see [PUT Bucket lifecycle] in the *Amazon Simple Storage Service API Reference*.

[1]: docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTlifecycle.html

See Also:

Instance Attribute Summary collapse

Instance Attribute Details

#abort_incomplete_multipart_upload ⇒ Types::AbortIncompleteMultipartUpload

Specifies the days since the initiation of an incomplete multipart upload that Amazon S3 will wait before permanently removing all parts of the upload. For more information, see [ Aborting Incomplete Multipart Uploads Using a Bucket Lifecycle Policy] in the *Amazon Simple Storage Service Developer Guide*.

[1]: docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config

Returns:



11420
11421
11422
11423
11424
11425
11426
11427
11428
11429
11430
 
# File 'lib/aws-sdk-s3/types.rb', line 11420

class Rule < Struct.new(
  :expiration,
  :id,
  :prefix,
  :status,
  :transition,
  :noncurrent_version_transition,
  :noncurrent_version_expiration,
  :abort_incomplete_multipart_upload)
  include Aws::Structure
end

#expiration ⇒ Types::LifecycleExpiration

Specifies the expiration for the lifecycle of the object.

Returns:



11420
11421
11422
11423
11424
11425
11426
11427
11428
11429
11430
 
# File 'lib/aws-sdk-s3/types.rb', line 11420

class Rule < Struct.new(
  :expiration,
  :id,
  :prefix,
  :status,
  :transition,
  :noncurrent_version_transition,
  :noncurrent_version_expiration,
  :abort_incomplete_multipart_upload)
  include Aws::Structure
end

#id ⇒ String

Unique identifier for the rule. The value can’t be longer than 255 characters.

Returns:

  • (String) 


11420
11421
11422
11423
11424
11425
11426
11427
11428
11429
11430
 
# File 'lib/aws-sdk-s3/types.rb', line 11420

class Rule < Struct.new(
  :expiration,
  :id,
  :prefix,
  :status,
  :transition,
  :noncurrent_version_transition,
  :noncurrent_version_expiration,
  :abort_incomplete_multipart_upload)
  include Aws::Structure
end

#noncurrent_version_expiration ⇒ Types::NoncurrentVersionExpiration

Specifies when noncurrent object versions expire. Upon expiration, Amazon S3 permanently deletes the noncurrent object versions. You set this lifecycle configuration action on a bucket that has versioning enabled (or suspended) to request that Amazon S3 delete noncurrent object versions at a specific period in the object’s lifetime.

Returns:



11420
11421
11422
11423
11424
11425
11426
11427
11428
11429
11430
 
# File 'lib/aws-sdk-s3/types.rb', line 11420

class Rule < Struct.new(
  :expiration,
  :id,
  :prefix,
  :status,
  :transition,
  :noncurrent_version_transition,
  :noncurrent_version_expiration,
  :abort_incomplete_multipart_upload)
  include Aws::Structure
end

#noncurrent_version_transition ⇒ Types::NoncurrentVersionTransition

Container for the transition rule that describes when noncurrent objects transition to the ‘STANDARD_IA`, `ONEZONE_IA`, `INTELLIGENT_TIERING`, `GLACIER`, or `DEEP_ARCHIVE` storage class. If your bucket is versioning-enabled (or versioning is suspended), you can set this action to request that Amazon S3 transition noncurrent object versions to the `STANDARD_IA`, `ONEZONE_IA`, `INTELLIGENT_TIERING`, `GLACIER`, or `DEEP_ARCHIVE` storage class at a specific period in the object’s lifetime.

Returns:



11420
11421
11422
11423
11424
11425
11426
11427
11428
11429
11430
 
# File 'lib/aws-sdk-s3/types.rb', line 11420

class Rule < Struct.new(
  :expiration,
  :id,
  :prefix,
  :status,
  :transition,
  :noncurrent_version_transition,
  :noncurrent_version_expiration,
  :abort_incomplete_multipart_upload)
  include Aws::Structure
end

#prefix ⇒ String

Object key prefix that identifies one or more objects to which this rule applies.

Returns:

  • (String) 


11420
11421
11422
11423
11424
11425
11426
11427
11428
11429
11430
 
# File 'lib/aws-sdk-s3/types.rb', line 11420

class Rule < Struct.new(
  :expiration,
  :id,
  :prefix,
  :status,
  :transition,
  :noncurrent_version_transition,
  :noncurrent_version_expiration,
  :abort_incomplete_multipart_upload)
  include Aws::Structure
end

#status ⇒ String

If ‘Enabled`, the rule is currently being applied. If `Disabled`, the rule is not currently being applied.

Returns:

  • (String) 


11420
11421
11422
11423
11424
11425
11426
11427
11428
11429
11430
 
# File 'lib/aws-sdk-s3/types.rb', line 11420

class Rule < Struct.new(
  :expiration,
  :id,
  :prefix,
  :status,
  :transition,
  :noncurrent_version_transition,
  :noncurrent_version_expiration,
  :abort_incomplete_multipart_upload)
  include Aws::Structure
end

#transition ⇒ Types::Transition

Specifies when an object transitions to a specified storage class.

Returns:



11420
11421
11422
11423
11424
11425
11426
11427
11428
11429
11430
 
# File 'lib/aws-sdk-s3/types.rb', line 11420

class Rule < Struct.new(
  :expiration,
  :id,
  :prefix,
  :status,
  :transition,
  :noncurrent_version_transition,
  :noncurrent_version_expiration,
  :abort_incomplete_multipart_upload)
  include Aws::Structure
end