Struct ResourceUpdate 

pub struct ResourceUpdate {
    pub vcpus: Option<u32>,
    pub memory_mb: Option<u32>,
    pub limits: ResourceLimits,
}

A resource update request.

Fields set to None are left unchanged.

Fields

vcpus: Option<u32>

vCPU count change (Tier 1 — will be rejected).

memory_mb: Option<u32>

Memory in MiB change (Tier 1 — will be rejected).

limits: ResourceLimits

Cgroup-based limits (Tier 2 — applied by the selected backend).

Implementations

impl ResourceUpdate

pub fn has_tier1_changes(&self) -> bool

Check if any Tier 1 (immutable) fields are requested.

pub fn has_tier2_changes(&self) -> bool

Check if any Tier 2 (cgroup) fields are requested.

pub fn apply_to_config(&self, config: &mut BoxConfig)

Merge every explicitly requested value into a complete Box config.

Sandbox live updates use the resulting full snapshot because the A3S OCI update contract replaces linux.resources atomically rather than applying a sequence of partial cgroup writes.

pub fn apply_to_limits(&self, limits: &mut ResourceLimits)

Merge every explicitly requested Tier 2 value into existing limits.

pub fn tier2_change_names(&self) -> Vec<&'static str>

Stable names for Tier 2 fields carried by this request.

pub fn build_microvm_cgroup_commands(&self) -> Vec<String>

Build shell commands to apply Tier 2 cgroup changes inside a MicroVM guest.

Host Sandbox updates must use the A3S OCI SDK and never call this method. For a MicroVM, the resize exec runs in the guest root cgroup, so each command resolves the per-container box-<pid>-<seq> slice at runtime. A bare /sys/fs/cgroup/<file> write would hit the root cgroup and silently leave the container’s limits unchanged.

Trait Implementations

impl Clone for ResourceUpdate

fn clone(&self) -> ResourceUpdate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResourceUpdate

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

Formats the value using the given formatter.

impl Default for ResourceUpdate

fn default() -> ResourceUpdate

Returns the “default value” for a type.