Enum kube_core::params::VersionMatch

pub enum VersionMatch {
    NotOlderThan,
    Exact,
}

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

impl Clone for VersionMatch

fn clone(&self) -> VersionMatch

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for VersionMatch

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

Formats the value using the given formatter.

impl PartialEq for VersionMatch

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