Enum PvcAccessMode 

pub enum PvcAccessMode {
    ReadWriteOnce,
    ReadOnlyMany,
    ReadWriteMany,
    ReadWriteOncePod,
    Unknown(String),
}

A PersistentVolumeClaim access mode as a closed set — ReadWriteOnce, ReadOnlyMany, ReadWriteMany, ReadWriteOncePod — so a typo is rejected by the CRD schema itself instead of surfacing as a provisioner error at the first backup or restore run.

Deliberately no Default (unlike other unit enums here): everywhere this type appears, an absent/empty list means “inherit from context” — the source PVC’s modes for a staged PVC, ReadWriteOnce for a restore-created PVC — so there is no context-free default value to name.

The extra PvcAccessMode::Unknown variant exists ONLY so values persisted before this field was schema-enforced still deserialize instead of erroring the typed watch stream for the whole Kind (one legacy CR must never wedge every other CR’s reconciliation). It is hidden from the CRD schema — the apiserver rejects non-canonical strings on every new write — and crate::validate::validate_access_modes rejects it loudly per-CR with the offending value quoted.

use kopiur_api::common::PvcAccessMode;

// Canonical values round-trip as bare k8s strings.
assert_eq!(serde_json::to_value(PvcAccessMode::ReadOnlyMany).unwrap(), "ReadOnlyMany");
let m: PvcAccessMode = serde_json::from_value(serde_json::json!("ReadWriteOnce")).unwrap();
assert_eq!(m, PvcAccessMode::ReadWriteOnce);

// A legacy/bogus stored string decodes (never a watcher-poisoning error) into
// `Unknown`, preserving the value verbatim for the rejection message — and it
// re-serializes to the same string, so a read-modify-write never mutates it.
let m: PvcAccessMode = serde_json::from_value(serde_json::json!("ReadWriteOnze")).unwrap();
assert_eq!(m, PvcAccessMode::Unknown("ReadWriteOnze".into()));
assert_eq!(serde_json::to_value(&m).unwrap(), "ReadWriteOnze");

Variants

ReadWriteOnce

Mounted read-write by a single node (RWO).

ReadOnlyMany

Mounted read-only by many nodes (ROX) — e.g. a CephFS backingSnapshot shallow-clone staged PVC.

ReadWriteMany

Mounted read-write by many nodes (RWX).

ReadWriteOncePod

Mounted read-write by a single pod (RWOP); the apiserver requires it to be the sole mode on a PVC.

Unknown(String)

A non-canonical stored value (pre-schema-enforcement legacy data). Never admissible on a new write (not in the CRD schema); consumers reject it via crate::validate::validate_access_modes with the value quoted, instead of a serde error that would poison the typed watcher.

Implementations

impl PvcAccessMode

pub const CANONICAL: [&'static str; 4]

The four canonical Kubernetes access-mode strings — the CRD schema enum and the “valid values” list in rejection messages, from one source.

pub fn mode_str(&self) -> &str

The k8s wire string (exhaustive; Unknown echoes the stored value verbatim).

pub fn parse(s: &str) -> Option<Self>

Parse a canonical k8s access-mode string; None for anything else. The migrate tool uses this to refuse a non-canonical VolSync value up front instead of passing it through to a doomed kubectl apply.

Trait Implementations

impl Clone for PvcAccessMode

fn clone(&self) -> PvcAccessMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PvcAccessMode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PvcAccessMode

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl JsonSchema for PvcAccessMode

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn json_schema(_: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

impl PartialEq for PvcAccessMode

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

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl Eq for PvcAccessMode

impl StructuralPartialEq for PvcAccessMode