kube_core::params

Enum VersionMatch

Source
pub enum VersionMatch {
    NotOlderThan,
    Exact,
}
Expand description

Controls how the resource version parameter is applied for list calls

Not specifying a VersionMatch strategy will give you different semantics depending on what resource_version, limit, continue_token you include with the list request.

See https://kubernetes.io/docs/reference/using-api/api-concepts/#semantics-for-get-and-list for details.

Variants§

§

NotOlderThan

Returns data at least as new as the provided resource version.

The newest available data is preferred, but any data not older than the provided resource version may be served. This guarantees that the collection’s resource version is not older than the requested resource version, but does not make any guarantee about the resource version of any of the items in that collection.

§Any Version

A degenerate, but common sub-case of NotOlderThan is when used together with resource_version “0”.

It is possible for a “0” resource version request to return data at a much older resource version than the client has previously observed, particularly in HA configurations, due to partitions or stale caches. Clients that cannot tolerate this should not use this semantic.

§

Exact

Return data at the exact resource version provided.

If the provided resource version is unavailable, the server responds with HTTP 410 “Gone”. For list requests to servers that honor the resource version Match parameter, this guarantees that the collection’s resource version is the same as the resource version you requested in the query string. That guarantee does not apply to the resource version of any items within that collection.

Note that Exact cannot be used with resource version “0”. For the most up-to-date list; use Unset.

Trait Implementations§

Source§

impl Clone for VersionMatch

Source§

fn clone(&self) -> VersionMatch

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 VersionMatch

Source§

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

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

impl PartialEq for VersionMatch

Source§

fn eq(&self, other: &VersionMatch) -> 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 VersionMatch

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§

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

🔬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, 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<T> ToOwned for T
where T: Clone,

Source§

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>,

Source§

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>,

Source§

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.