Struct RebuildBuilder

pub struct RebuildBuilder<'a> { /* private fields */ }

Builder for Rebuild.

Implementations

impl<'a> RebuildBuilder<'a>

pub fn access_ipv4<VALUE: Into<Cow<'a, str>>>( &mut self, value: VALUE, ) -> &mut Self

IPv4 address that should be used to access this server.

pub fn access_ipv6<VALUE: Into<Cow<'a, str>>>( &mut self, value: VALUE, ) -> &mut Self

IPv6 address that should be used to access this server.

pub fn admin_pass<VALUE: Into<Cow<'a, str>>>( &mut self, value: VALUE, ) -> &mut Self

The administrative password of the server. If you omit this parameter, the operation generates a new password.

pub fn description<VALUE: Into<Option<Cow<'a, str>>>>( &mut self, value: VALUE, ) -> &mut Self

A free form description of the server. Limited to 255 characters in length. Before microversion 2.19 this was set to the server name.

New in version 2.19

pub fn image_ref<VALUE: Into<Cow<'a, str>>>( &mut self, value: VALUE, ) -> &mut Self

The UUID of the image to rebuild for your server instance. It must be a valid UUID otherwise API will return 400. To rebuild a volume-backed server with a new image, at least microversion 2.93 needs to be provided in the request else the request will fall back to old behaviour i.e. the API will return 400 (for an image different from the image used when creating the volume). For non-volume-backed servers, specifying a new image will result in validating that the image is acceptable for the current compute host on which the server exists. If the new image is not valid, the server will go into ERROR status.

pub fn key_name<VALUE: Into<Option<Cow<'a, str>>>>( &mut self, value: VALUE, ) -> &mut Self

Key pair name for rebuild API. If null is specified, the existing keypair is unset.

Note

Users within the same project are able to rebuild other user’s instances in that project with a new keypair. Keys are owned by users (which is the only resource that’s true of). Servers are owned by projects. Because of this a rebuild with a key_name is looking up the keypair by the user calling rebuild.

New in version 2.54

pub fn name<VALUE: Into<Cow<'a, str>>>(&mut self, value: VALUE) -> &mut Self

The server name.

pub fn os_dcf_disk_config(&mut self, value: OsDcfDiskConfig) -> &mut Self

Controls how the API partitions the disk when you create, rebuild, or resize servers. A server inherits the OS-DCF:diskConfig value from the image from which it was created, and an image inherits the OS-DCF:diskConfig value from the server from which it was created. To override the inherited setting, you can include this attribute in the request body of a server create, rebuild, or resize request. If the OS-DCF:diskConfig value for an image is MANUAL, you cannot create a server from that image and set its OS-DCF:diskConfig value to AUTO. A valid value is:

• AUTO. The API builds the server with a single partition the size of the target flavor disk. The API automatically adjusts the file system to fit the entire partition.
• MANUAL. The API builds the server by using whatever partition scheme and file system is in the source image. If the target flavor disk is larger, the API does not partition the remaining disk space.

pub fn preserve_ephemeral<VALUE: Into<bool>>( &mut self, value: VALUE, ) -> &mut Self

Indicates whether the server is rebuilt with the preservation of the ephemeral partition (true).

Note

This only works with baremetal servers provided by Ironic. Passing it to any other server instance results in a fault and will prevent the rebuild from happening.

pub fn trusted_image_certificates<VALUE: Into<Vec<Cow<'a, str>>>>( &mut self, value: VALUE, ) -> &mut Self

A list of trusted certificate IDs, which are used during image signature verification to verify the signing certificate. The list is restricted to a maximum of 50 IDs. This parameter is optional in server rebuild requests if allowed by policy, and is not supported for volume-backed instances.

If null is specified, the existing trusted certificate IDs are either unset or reset to the configured defaults.

New in version 2.63

pub fn user_data<VALUE: Into<Option<Cow<'a, str>>>>( &mut self, value: VALUE, ) -> &mut Self

Configuration information or scripts to use upon rebuild. Must be Base64 encoded. Restricted to 65535 bytes. If null is specified, the existing user_data is unset.

New in version 2.57

pub fn build(&self) -> Result<Rebuild<'a>, RebuildBuilderError>

Builds a new Rebuild.

Errors

If a required field has not been initialized.

impl<'a> RebuildBuilder<'a>

pub fn metadata<I, K, V>(&mut self, iter: I) -> &mut Self

where I: Iterator<Item = (K, V)>, K: Into<Cow<'a, str>>, V: Into<Cow<'a, str>>,

Metadata key and value pairs. The maximum size of the metadata key and value is 255 bytes each.

Trait Implementations

impl<'a> Clone for RebuildBuilder<'a>

fn clone(&self) -> RebuildBuilder<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Default for RebuildBuilder<'a>

fn default() -> Self

Returns the “default value” for a type.