Struct podman_api::api::Pod

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

Interface for accessing and manipulating Podman Pod.

Api Reference

Implementations

impl<'podman> Pod<'podman>

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

Exports an interface exposing operations against a Pod instance.

pub fn id(&self) -> &Id

A getter for Pod id

impl<'podman> Pod<'podman>

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:

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

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

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

Api Reference

Stop this pod.

Examples:

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

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

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

Api Reference

Stop this pod with a timeout.

Examples:

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);
}

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

Api Reference

Return low-level information about this pod.

Examples:

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);
}

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

Api Reference

Send a signal to this pod.

Examples:

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

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

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

Api Reference

Kill this pod.

Examples:

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

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

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

Api Reference

Pause this pod.

Examples:

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

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

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

Api Reference

Unpause this pod

Examples:

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

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

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

Api Reference

Restart this pod.

Examples:

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

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

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

Api Reference

Delete this pod.

Examples:

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

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

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

Api Reference

Force remove this pod.

Examples:

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

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

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

Api Reference

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

Examples:

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);
}

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

Api Reference

List processes inside this pod.

Examples:

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);
}

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

Api Reference

List processes inside this pod.

Only supported as of version > 4.0

Examples:

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

let 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);
    }
}

Trait Implementations

impl<'podman> Debug for Pod<'podman>

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

Formats the value using the given formatter.