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 dry_run: bool,
}Expand description
Request body for POST /api/v1/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",
"dry_run": false
}Fields§
§hosts_expression: StringHosts 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.
dry_run: boolWhen true, return the computed changeset without persisting it.