Struct aws_sdk_s3::types::LifecycleRule
source · #[non_exhaustive]pub struct LifecycleRule {
pub expiration: Option<LifecycleExpiration>,
pub id: Option<String>,
pub prefix: Option<String>,
pub filter: Option<LifecycleRuleFilter>,
pub status: ExpirationStatus,
pub transitions: Option<Vec<Transition>>,
pub noncurrent_version_transitions: Option<Vec<NoncurrentVersionTransition>>,
pub noncurrent_version_expiration: Option<NoncurrentVersionExpiration>,
pub abort_incomplete_multipart_upload: Option<AbortIncompleteMultipartUpload>,
}
Expand description
A lifecycle rule for individual objects in an Amazon S3 bucket.
For more information see, Managing your storage lifecycle in the Amazon S3 User Guide.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. }
syntax; cannot be matched against without a wildcard ..
; and struct update syntax will not work.expiration: Option<LifecycleExpiration>
Specifies the expiration for the lifecycle of the object in the form of date, days and, whether the object has a delete marker.
id: Option<String>
Unique identifier for the rule. The value cannot be longer than 255 characters.
prefix: Option<String>
Prefix identifying one or more objects to which the rule applies. This is no longer used; use Filter
instead.
Replacement must be made for object keys containing special characters (such as carriage returns) when using XML requests. For more information, see XML related object key constraints.
filter: Option<LifecycleRuleFilter>
The Filter
is used to identify objects that a Lifecycle Rule applies to. A Filter
must have exactly one of Prefix
, Tag
, or And
specified. Filter
is required if the LifecycleRule
does not contain a Prefix
element.
status: ExpirationStatus
If 'Enabled', the rule is currently being applied. If 'Disabled', the rule is not currently being applied.
transitions: Option<Vec<Transition>>
Specifies when an Amazon S3 object transitions to a specified storage class.
noncurrent_version_transitions: Option<Vec<NoncurrentVersionTransition>>
Specifies the transition rule for the lifecycle rule that describes when noncurrent objects transition to a specific 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 a specific storage class at a set period in the object's lifetime.
noncurrent_version_expiration: Option<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.
abort_incomplete_multipart_upload: Option<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 Configuration in the Amazon S3 User Guide.
Implementations§
source§impl LifecycleRule
impl LifecycleRule
sourcepub fn expiration(&self) -> Option<&LifecycleExpiration>
pub fn expiration(&self) -> Option<&LifecycleExpiration>
Specifies the expiration for the lifecycle of the object in the form of date, days and, whether the object has a delete marker.
sourcepub fn id(&self) -> Option<&str>
pub fn id(&self) -> Option<&str>
Unique identifier for the rule. The value cannot be longer than 255 characters.
sourcepub fn prefix(&self) -> Option<&str>
👎Deprecated
pub fn prefix(&self) -> Option<&str>
Prefix identifying one or more objects to which the rule applies. This is no longer used; use Filter
instead.
Replacement must be made for object keys containing special characters (such as carriage returns) when using XML requests. For more information, see XML related object key constraints.
sourcepub fn filter(&self) -> Option<&LifecycleRuleFilter>
pub fn filter(&self) -> Option<&LifecycleRuleFilter>
The Filter
is used to identify objects that a Lifecycle Rule applies to. A Filter
must have exactly one of Prefix
, Tag
, or And
specified. Filter
is required if the LifecycleRule
does not contain a Prefix
element.
sourcepub fn status(&self) -> &ExpirationStatus
pub fn status(&self) -> &ExpirationStatus
If 'Enabled', the rule is currently being applied. If 'Disabled', the rule is not currently being applied.
sourcepub fn transitions(&self) -> &[Transition]
pub fn transitions(&self) -> &[Transition]
Specifies when an Amazon S3 object transitions to a specified storage class.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .transitions.is_none()
.
sourcepub fn noncurrent_version_transitions(&self) -> &[NoncurrentVersionTransition]
pub fn noncurrent_version_transitions(&self) -> &[NoncurrentVersionTransition]
Specifies the transition rule for the lifecycle rule that describes when noncurrent objects transition to a specific 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 a specific storage class at a set period in the object's lifetime.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .noncurrent_version_transitions.is_none()
.
sourcepub fn noncurrent_version_expiration(
&self,
) -> Option<&NoncurrentVersionExpiration>
pub fn noncurrent_version_expiration( &self, ) -> Option<&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.
sourcepub fn abort_incomplete_multipart_upload(
&self,
) -> Option<&AbortIncompleteMultipartUpload>
pub fn abort_incomplete_multipart_upload( &self, ) -> Option<&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 Configuration in the Amazon S3 User Guide.
source§impl LifecycleRule
impl LifecycleRule
sourcepub fn builder() -> LifecycleRuleBuilder
pub fn builder() -> LifecycleRuleBuilder
Creates a new builder-style object to manufacture LifecycleRule
.
Trait Implementations§
source§impl Clone for LifecycleRule
impl Clone for LifecycleRule
source§fn clone(&self) -> LifecycleRule
fn clone(&self) -> LifecycleRule
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for LifecycleRule
impl Debug for LifecycleRule
source§impl PartialEq for LifecycleRule
impl PartialEq for LifecycleRule
impl StructuralPartialEq for LifecycleRule
Auto Trait Implementations§
impl Freeze for LifecycleRule
impl RefUnwindSafe for LifecycleRule
impl Send for LifecycleRule
impl Sync for LifecycleRule
impl Unpin for LifecycleRule
impl UnwindSafe for LifecycleRule
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)