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
Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional 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>
👎Deprecated

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

source

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.

source

pub fn id(&self) -> Option<&str>

Unique identifier for the rule. The value cannot be longer than 255 characters.

source

pub fn prefix(&self) -> Option<&str>

👎Deprecated

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.

source

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.

source

pub fn status(&self) -> &ExpirationStatus

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

source

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().

source

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().

source

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.

source

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

source

pub fn builder() -> LifecycleRuleBuilder

Creates a new builder-style object to manufacture LifecycleRule.

Trait Implementations§

source§

impl Clone for LifecycleRule

source§

fn clone(&self) -> LifecycleRule

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
source§

impl Debug for LifecycleRule

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl PartialEq for LifecycleRule

source§

fn eq(&self, other: &LifecycleRule) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl StructuralPartialEq for LifecycleRule

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> CloneToUninit for T
where T: Clone,

source§

default unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<Unshared, Shared> IntoShared<Shared> for Unshared
where Shared: FromUnshared<Unshared>,

source§

fn into_shared(self) -> Shared

Creates a shared type from an unshared type.
source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

source§

fn vzip(self) -> V

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more