Struct Image 

pub struct Image {
    pub identifier: String,
    pub name: String,
    pub version: String,
    pub state: String,
    pub size: SizeClass,
    pub log_group: Option<String>,
    pub log_stream: Option<String>,
}

A built image, and the log group the service created alongside it.

Fields

identifier: String

The image ARN, which is what imageIdentifier takes.

name: String

The image name.

version: String

The version the create call produced.

state: String

The state the service last reported.

size: SizeClass

The class the requested baseline selected.

Carried on the image because billing follows the baseline requested at create time, and by the time anyone asks what a run cost the request is gone.

log_group: Option<String>

The build log group the create call configured, or None for the service default (Image::build_log_group’s derivation).

Carried for the same reason size is: by the time anyone asks where the build’s logs went, the request is gone.

log_stream: Option<String>

The resolved exact log stream the create call configured — the caller’s prefix plus / plus the sixteen-hex per-build discriminator — or None when no stream was configured.

This is the only place the resolved name exists: the discriminator is minted fresh inside ControlPlane::create_image, so a caller who wants to read their build’s logs has to read the name off this field rather than re-deriving it. The CLI’s build envelope reports it as logStream for exactly that reason.

Implementations

impl Image

pub fn build_log_group(&self) -> String

The configured build log group, or the derived default /aws/lambda-microvms/<image-name>.

The default is the group the service creates itself, so a Terraform stack never owns it and terraform destroy leaves it behind — “the stack destroyed cleanly” is not “the account is clean”. Six of these accumulated before anyone noticed. A configured group (crate::control::CreateImageRequest::log_group) replaces the derivation, because the derived name is then a group no build ever writes to.

pub fn is_ready(state: &str) -> bool

Whether the state the service reported means “built and usable”.

Accepts the two model-backed spellings and the two tolerated ones. Kept generous because the service has answered differently across API versions, and a hard equality check on one spelling is how a working build looks like a stalled one.

pub fn is_failed(state: &str) -> bool

Whether the state means the build failed.

A substring test rather than a set, because the model’s failure spellings are CREATE_FAILED, UPDATE_FAILED, and DELETE_FAILED and the thing they share is the word — matching that means a fourth added later is still recognised as a failure rather than polled until the deadline.

Trait Implementations

impl Clone for Image

fn clone(&self) -> Image

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Image

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

Formats the value using the given formatter.

impl Eq for Image

impl PartialEq for Image

fn eq(&self, other: &Image) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Image