Enum ExpirationPolicy 

pub enum ExpirationPolicy {
    Manual,
    TimeToLive(Duration),
    TimeToIdle(Duration),
}

The per-object expiration policy.

Controls automatic object cleanup. The policy is set by the client at upload time via the x-sn-expiration header and persisted with the object.

Variant	Wire format	Behavior
Manual	manual	No automatic expiration (default)
TimeToLive	ttl:30s	Expires after a fixed duration from creation
TimeToIdle	tti:1h	Expires after a duration of no access

Durations use the wire format, which is written in days, hours, minutes, and seconds (e.g. 30s, 5m, 1h, 7d, 400d 12h).

Important: Manual is the default and must remain so — persisted objects without an explicit policy are deserialized as Manual.

Variants

Manual

Manual expiration, meaning no automatic cleanup.

TimeToLive(Duration)

Time to live, with expiration after the specified duration.

TimeToIdle(Duration)

Time to idle, with expiration once the object has not been accessed within the specified duration.

Implementations

impl ExpirationPolicy

pub fn expires_in(&self) -> Option<Duration>

Returns the duration after which the object expires.

pub fn is_timeout(&self) -> bool

Returns true if this policy indicates time-based expiry.

pub fn is_manual(&self) -> bool

Returns true if this policy is Manual.

pub fn check_tti_bump( &self, time_expires: Option<SystemTime>, access_time: SystemTime, ) -> Option<SystemTime>

Checks whether a TTI deadline needs bumping given the current expiry and access time.

Returns Some(new_expire_at) when the current deadline is stale enough to justify a write, None otherwise. The debounce window scales with the TTI duration so short-TTI objects get bumped more frequently.

Trait Implementations

impl Clone for ExpirationPolicy

fn clone(&self) -> ExpirationPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExpirationPolicy

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

Formats the value using the given formatter.

impl Default for ExpirationPolicy

fn default() -> ExpirationPolicy

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ExpirationPolicy

fn deserialize<__D>( __deserializer: __D, ) -> Result<ExpirationPolicy, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ExpirationPolicy

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

Formats the value using the given formatter.

impl FromStr for ExpirationPolicy

type Err = Error

The associated error which can be returned from parsing.

fn from_str( s: &str, ) -> Result<ExpirationPolicy, <ExpirationPolicy as FromStr>::Err>

Parses a string s to return a value of this type.

impl PartialEq for ExpirationPolicy

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Serialize for ExpirationPolicy

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for ExpirationPolicy

impl Eq for ExpirationPolicy

impl StructuralPartialEq for ExpirationPolicy