Struct ApplyBootConfigRequest 

pub struct ApplyBootConfigRequest {
    pub hosts_expression: String,
    pub boot_image_id: Option<String>,
    pub boot_image_configuration: Option<String>,
    pub kernel_parameters: Option<String>,
    pub runtime_configuration: Option<String>,
    pub enabled: Option<bool>,
    pub dry_run: bool,
}

Request body for POST /v2/boot-config.

Applies a combined boot configuration (image + runtime config + kernel parameters) to the nodes named by hosts_expression. The field is a hosts expression — xnames, NIDs, or hostlist notation; HSM group names are not accepted here (resolve them client-side first if needed).

At least one of boot_image_id, boot_image_configuration, kernel_parameters, or runtime_configuration should be set; null fields are left unchanged on the targeted nodes.

Wire shape

{
  "hosts_expression": "x3000c0s1b0n[0-3]",
  "boot_image_id": "0a1b2c3d-...",
  "boot_image_configuration": null,
  "kernel_parameters": "console=ttyS0 nosmt",
  "runtime_configuration": "cos-2.5",
  "enabled": true,
  "dry_run": false
}

Fields

hosts_expression: String

Hosts expression (xnames, NIDs, or hostlist notation) naming the target nodes.

boot_image_id: Option<String>

IMS image ID to set as the boot image. Mutually exclusive with boot_image_configuration: set one or the other, not both.

boot_image_configuration: Option<String>

CFS configuration name associated with the boot image; the server resolves the most recent image built against this configuration when boot_image_id is absent.

kernel_parameters: Option<String>

Kernel command-line parameters to apply.

runtime_configuration: Option<String>

CFS configuration to assign as the runtime desired-config.

enabled: Option<bool>

Value to set on the CFS component enabled flag when a runtime_configuration is being applied. Absent → server default (true, i.e. let CFS reconfigure on its next pass); false stages the desired configuration without enabling CFS. Ignored when runtime_configuration is not set.

dry_run: bool

When true, return the computed changeset without persisting it.

Trait Implementations

impl Debug for ApplyBootConfigRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ApplyBootConfigRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ApplyBootConfigRequest

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.

impl ToSchema for ApplyBootConfigRequest

fn name() -> Cow<'static, str>

Return name of the schema.

fn schemas(schemas: &mut Vec<(String, RefOr<Schema>)>)

Implement reference [utoipa::openapi::schema::Schema]s for this type.