Skip to main content

MicrovmImageVersionSummaryWire

Struct MicrovmImageVersionSummaryWire 

Source
pub struct MicrovmImageVersionSummaryWire {
Show 18 fields pub base_image_arn: String, pub build_role_arn: String, pub code_artifact: CodeArtifact, pub image_arn: String, pub image_version: String, pub state: String, pub status: String, pub created_at: f64, pub base_image_version: Option<String>, pub description: Option<String>, pub resources: Option<Vec<Resources>>, pub cpu_configurations: Option<Vec<CpuConfiguration>>, pub egress_network_connectors: Option<Vec<String>>, pub additional_os_capabilities: Option<Vec<String>>, pub environment_variables: Option<BTreeMap<String, String>>, pub updated_at: Option<f64>, pub state_reason: Option<String>, pub tags: Option<BTreeMap<String, String>>,
}
Expand description

MicrovmImageVersionSummary, which is also GetMicrovmImageVersionOutput and UpdateMicrovmImageVersionResponse — the three shapes are member-for-member identical in the model, so one type serves all of them.

One type rather than three for the reason MicrovmResponseWire gives: a second copy is a second place to keep twenty member spellings right, and the model itself declares them as one set. Checked member-by-member against service-2.json on 2026-08-16 — GetMicrovmImageVersionOutput, UpdateMicrovmImageVersionResponse, and MicrovmImageVersionSummary list the same twenty members with the same eight required.

Note state here is the member’s name — unlike the build summary below, and that asymmetry is the whole trap.

§All eight required members, not the four this crate reads

The same argument MicrovmImageBuildSummaryWire records: the model marking a member required is the strongest promise it makes about a response, and a required member absent from the struct is one no drift check can notice going missing. status in particular was Option<String> while the model requires it — so a service that stopped sending the availability status would have read as None, which is exactly how a version blocked from launching would look identical to one nobody had ever set. Confirmed present on all 22 versions in the conformance account (2026-08-16), so requiring it is a measurement rather than a reading of the model alone.

§hooks is deliberately not here, and the reason is a measurement

The model marks every member of Hooks, MicrovmHooks, and MicrovmImageHooks optional, while this module’s request-side Hooks declares them all as bare fields — correct for a request, since this client always sends all six. A real response is not so generous: GetMicrovmImageVersion on an image built by another tool answered "microvmHooks": {"run": "ENABLED", "runTimeoutInSeconds": 30} and nothing else (measured 2026-08-16, us-east-1, omnigent-host-vpc version 3.0), so five of MicrovmHooks’s eight members were absent. Reusing Hooks here would fail that parse and turn a readable version into a client error. A response-shaped hooks type is the fix if a caller ever needs it; until then the absence is the honest option, and the test a_versions_hooks_block_is_not_read_because_a_real_one_omits_members pins the reason.

Fields§

§base_image_arn: String§build_role_arn: String§code_artifact: CodeArtifact§image_arn: String§image_version: String§state: String§status: String

MicrovmImageVersionStatus: ACTIVE or INACTIVE.

A String rather than a VersionStatus, because this is a response and a third value AWS adds must parse rather than fail — the same rule MicrovmImageBuildSummaryWire::architecture follows. VersionStatus is for the request, where narrowing turns a typo into a compile error.

§created_at: f64

Epoch seconds, possibly fractional.

§base_image_version: Option<String>

The base version this version was pinned to, when one was.

The readback for CreateMicrovmImage.baseImageVersion, and the reason pinning is worth doing: an unpinned build still reports one here, and the value the service echoes is spelled differently from anything the base’s own listing offers ("1.0" against the managed base’s "0"/"1" — docs/PLATFORM.md). So this is the record of what was built, not a value to feed back into a request.

§description: Option<String>§resources: Option<Vec<Resources>>

ResourcesList, max 1. The only place a built image’s size class is observable: GetMicrovm carries no memory figure at all.

§cpu_configurations: Option<Vec<CpuConfiguration>>§egress_network_connectors: Option<Vec<String>>

The image-level egress list. Max 1 in the model, not the 10 the VM-level NetworkConnectorList allows — see crate::constants::MAX_IMAGE_EGRESS_CONNECTORS.

§additional_os_capabilities: Option<Vec<String>>§environment_variables: Option<BTreeMap<String, String>>§updated_at: Option<f64>§state_reason: Option<String>

The version-level failure reason. Measured null on real failures while the build-level one is populated — docs/PLATFORM.md, “A failed build’s stateReason lives on the build”.

§tags: Option<BTreeMap<String, String>>

Implementations§

Source§

impl MicrovmImageVersionSummaryWire

Source

pub fn is_active(&self) -> bool

Whether RunMicrovm will launch this version.

A comparison against the model’s spelling through VersionStatus rather than against a literal here, so the two cannot drift: the request type and the readback agree on what "ACTIVE" is spelled like or neither compiles.

Source

pub fn describe(&self) -> String

The version, its state, its availability status, and the reason when the service gave one — the line a retire or a rollback prints.

An absent reason renders nothing rather than an empty parenthesis, for the reason MicrovmImageBuildSummaryWire::describe gives.

Trait Implementations§

Source§

impl Clone for MicrovmImageVersionSummaryWire

Source§

fn clone(&self) -> MicrovmImageVersionSummaryWire

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for MicrovmImageVersionSummaryWire

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<'de> Deserialize<'de> for MicrovmImageVersionSummaryWire

Source§

fn deserialize<__D>( __deserializer: __D, ) -> Result<MicrovmImageVersionSummaryWire, <__D as Deserializer<'de>>::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Serialize for MicrovmImageVersionSummaryWire

Source§

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<T> DynClone for T
where T: Clone,

Source§

fn __clone_box(&self, _: Private) -> *mut ()

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<Unshared, Shared> IntoShared<Shared> for Unshared
where Shared: FromUnshared<Unshared>,

Source§

fn into_shared(self) -> Shared

Creates a shared type from an unshared type.
Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more