Struct podman_api::api::Pod

source · [−]

pub struct Pod<'podman> { /* private fields */ }

Expand description

Interface for accessing and manipulating Podman Pod.

Api Reference

Implementations

source

impl<'podman> Pod<'podman>

source

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

Exports an interface exposing operations against a Pod instance.

source

pub fn id(&self) -> &Id

A getter for Pod id

source

impl<'podman> Pod<'podman>

source

pub async fn start(&self) -> Result<PodStartReport>

Api Reference

Start this pod.

Parameters:

detach_keys - Override the key sequence for detaching a pod. Format is a single character [a-Z] or ctrl- where is one of: a-z, @, ^, [, , or _.

Examples:

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

    if let Err(e) = podman.pods().get("79c93f220e3e").start().await {
        eprintln!("{}", e);
    }
};

source

pub async fn stop(&self) -> Result<PodStopReport>

Api Reference

Stop this pod.

Examples:

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

    if let Err(e) = podman.pods().get("79c93f220e3e").stop().await {
        eprintln!("{}", e);
    }
};

source

pub async fn stop_with_timeout(&self, t: usize) -> Result<PodStopReport>

Api Reference

Stop this pod with a timeout.

Examples:

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

    if let Err(e) = podman.pods().get("79c93f220e3e").stop_with_timeout(10).await {
        eprintln!("{}", e);
    }
};

source

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

Api Reference

Return low-level information about this pod.

Examples:

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

    match podman.pods().get("79c93f220e3e").inspect().await {
        Ok(info) => println!("{:?}", info),
        Err(e) => eprintln!("{}", e),
    }
};

source

pub async fn send_signal(
&self,
signal: impl Into<String>
) -> Result<PodKillReport>

Api Reference

Send a signal to this pod.

Examples:

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

    if let Err(e) = podman.pods().get("79c93f220e3e").send_signal("SIGINT").await {
        eprintln!("{}", e);
    }
};

source

pub async fn kill(&self) -> Result<PodKillReport>

Api Reference

Kill this pod.

Examples:

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

    if let Err(e) = podman.pods().get("79c93f220e3e").kill().await {
        eprintln!("{}", e);
    }
};

source

pub async fn pause(&self) -> Result<PodPauseReport>

Api Reference

Pause this pod.

Examples:

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

    if let Err(e) = podman.pods().get("79c93f220e3e").pause().await {
        eprintln!("{}", e);
    }
};

source

pub async fn unpause(&self) -> Result<PodUnpauseReport>

Api Reference

Unpause this pod

Examples:

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

    if let Err(e) = podman.pods().get("79c93f220e3e").unpause().await {
        eprintln!("{}", e);
    }
};

source

pub async fn restart(&self) -> Result<PodRestartReport>

Api Reference

Restart this pod.

Examples:

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

    if let Err(e) = podman.pods().get("79c93f220e3e").restart().await {
        eprintln!("{}", e);
    }
};

source

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

Api Reference

Delete this pod.

Examples:

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

    if let Err(e) = podman.pods().get("79c93f220e3e").delete().await {
        eprintln!("{}", e);
    }
};

source

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

Api Reference

Force remove this pod.

Examples:

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

    if let Err(e) = podman.pods().get("79c93f220e3e").remove().await {
        eprintln!("{}", e);
    }
};

source

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

Api Reference

Quick way to determine if a pod exists by name or ID.

Examples:

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

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

source

pub async fn top(&self, opts: &PodTopOpts) -> Result<LibpodPodTopResponse>

Api Reference

List processes inside this pod.

Examples:

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

    match podman.pods().get("79c93f220e3e").top(&Default::default()).await {
        Ok(info) => println!("{:?}", info),
        Err(e) => eprintln!("{}", e),
    }
};

source

pub fn top_stream(
&self,
opts: &PodTopOpts
) -> impl Stream<Item = Result<LibpodPodTopResponse>> + Unpin + 'podman

Api Reference

List processes inside this pod.

Only supported as of version > 4.0

Examples:

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

    let mut stream = podman.pods().get("79c93f220e3e").top_stream(&Default::default());
    while let Some(chunk) = stream.next().await {
        match chunk{
            Ok(chunk) => println!("{:?}", chunk),
            Err(e) => eprintln!("{}", e),
        }
    }
};

source

pub async fn generate_systemd_units(
&self,
opts: &SystemdUnitsOpts
) -> Result<Value>

Api Reference

Generate Systemd Units based on this pod.

Examples:

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

    match podman
        .pods()
        .get("ea03584c0fd6")
        .generate_systemd_units(&Default::default())
        .await
    {
        Ok(info) => println!("{:?}", info),
        Err(e) => eprintln!("{}", e),
    }
};