Struct Volume

pub struct Volume { /* private fields */ }

Interface for accessing and manipulating Podman Volume.

Api Reference

Implementations

impl Volume

pub fn new(podman: Podman, name: impl Into<Id>) -> Self

Exports an interface exposing operations against a Volume instance.

pub fn name(&self) -> &Id

A getter for Volume name

impl Volume

pub async fn exists(&self) -> Result<bool>

Api Reference

Quick way to determine if this volume exists.

Examples:

async {
    use podman_api::Podman;
    let podman = Podman::unix("/run/user/1000/podman/podman.sock");

    match podman.volumes().get("some_vol").exists().await {
        Ok(exists) => if exists {
            println!("volume exists!");
        } else {
            println!("volume doesn't exists!");
        },
        Err(e) => eprintln!("check failed: {}", e),
    }
};

pub async fn inspect(&self) -> Result<VolumeInspect>

Api Reference

Obtain low-level information about this volume.

Examples:

async {
    use podman_api::Podman;
    let podman = Podman::unix("/run/user/1000/podman/podman.sock");

    match podman.volumes().get("my-vol").inspect().await {
        Ok(info) => println!("{:?}", info),
        Err(e) => eprintln!("{}", e),
    }
};

pub async fn delete(&self) -> Result<()>

Api Reference

Delete this volume. To forcefully remove an volume use Volume::remove.

Examples:

async {
    use podman_api::Podman;
    let podman = Podman::unix("/run/user/1000/podman/podman.sock");

    if let Err(e) = podman.volumes().get("my-vol").delete().await {
        eprintln!("{}", e);
    }
};

pub async fn remove(&self) -> Result<()>

Api Reference

Remove this volume forcefully. To remove the volume normally use Volume::delete.

Examples:

async {
    use podman_api::Podman;
    let podman = Podman::unix("/run/user/1000/podman/podman.sock");

    if let Err(e) = podman.volumes().get("my-vol").remove().await {
        eprintln!("{}", e);
    }
};

Trait Implementations

impl Debug for Volume

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

Formats the value using the given formatter.