Struct MachineImage 

#[non_exhaustive]
pub struct MachineImage {

    pub creation_timestamp: Option<String>,
    pub description: Option<String>,
    pub guest_flush: Option<bool>,
    pub id: Option<u64>,
    pub instance_properties: Option<InstanceProperties>,
    pub kind: Option<String>,
    pub label_fingerprint: Option<Bytes>,
    pub labels: HashMap<String, String>,
    pub machine_image_encryption_key: Option<CustomerEncryptionKey>,
    pub name: Option<String>,
    pub satisfies_pzi: Option<bool>,
    pub satisfies_pzs: Option<bool>,
    pub saved_disks: Vec<SavedDisk>,
    pub self_link: Option<String>,
    pub source_disk_encryption_keys: Vec<SourceDiskEncryptionKey>,
    pub source_instance: Option<String>,
    pub source_instance_properties: Option<SourceInstanceProperties>,
    pub status: Option<Status>,
    pub storage_locations: Vec<String>,
    pub total_storage_bytes: Option<i64>,
    /* private fields */
}

Available on crate feature machine-images only.

Represents a machine image resource.

A machine image is a Compute Engine resource that stores all the configuration, metadata, permissions, and data from one or more disks required to create a Virtual machine (VM) instance. For more information, seeMachine images.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

creation_timestamp: Option<String>

Output only. [Output Only] The creation timestamp for this machine image inRFC3339 text format.

description: Option<String>

An optional description of this resource. Provide this property when you create the resource.

guest_flush: Option<bool>

[Input Only] Whether to attempt an application consistent machine image by informing the OS to prepare for the snapshot process.

id: Option<u64>

Output only. [Output Only] A unique identifier for this machine image. The server defines this identifier.

instance_properties: Option<InstanceProperties>

[Output Only] Properties of source instance

kind: Option<String>

Output only. [Output Only] The resource type, which is alwayscompute#machineImage for machine image.

label_fingerprint: Option<Bytes>

A fingerprint for the labels being applied to this machine image, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels.

To see the latest fingerprint, make get() request to the machine image.

labels: HashMap<String, String>

Labels to apply to this machine image. These can be later modified by the setLabels method.

machine_image_encryption_key: Option<CustomerEncryptionKey>

Encrypts the machine image using acustomer-supplied encryption key.

After you encrypt a machine image using a customer-supplied key, you must provide the same key if you use the machine image later. For example, you must provide the encryption key when you create an instance from the encrypted machine image in a future request.

Customer-supplied encryption keys do not protect access to metadata of the machine image.

If you do not provide an encryption key when creating the machine image, then the machine image will be encrypted using an automatically generated key and you do not need to provide a key to use the machine image later.

name: Option<String>

Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.

satisfies_pzi: Option<bool>

Output only. Reserved for future use.

satisfies_pzs: Option<bool>

Output only. [Output Only] Reserved for future use.

saved_disks: Vec<SavedDisk>

Output only. An array of Machine Image specific properties for disks attached to the source instance

self_link: Option<String>

Output only. [Output Only] The URL for this machine image. The server defines this URL.

source_disk_encryption_keys: Vec<SourceDiskEncryptionKey>

[Input Only] Thecustomer-supplied encryption key of the disks attached to the source instance. Required if the source disk is protected by a customer-supplied encryption key.

source_instance: Option<String>

The source instance used to create the machine image. You can provide this as a partial or full URL to the resource. For example, the following are valid values:

 - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance

• projects/project/zones/zone/instances/instance

source_instance_properties: Option<SourceInstanceProperties>

Output only. [Output Only] DEPRECATED: Please use instance_properties instead for source instance related properties. New properties will not be added to this field.

status: Option<Status>

Output only. [Output Only] The status of the machine image. One of the following values:INVALID, CREATING, READY,DELETING, and UPLOADING.

storage_locations: Vec<String>

The regional or multi-regional Cloud Storage bucket location where themachine image is stored.

total_storage_bytes: Option<i64>

Output only. [Output Only] Total size of the storage used by the machine image.

Implementations

impl MachineImage

pub fn new() -> Self

pub fn set_creation_timestamp<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of creation_timestamp.

Example

let x = MachineImage::new().set_creation_timestamp("example");

pub fn set_or_clear_creation_timestamp<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of creation_timestamp.

Example

let x = MachineImage::new().set_or_clear_creation_timestamp(Some("example"));
let x = MachineImage::new().set_or_clear_creation_timestamp(None::<String>);

pub fn set_description<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of description.

Example

let x = MachineImage::new().set_description("example");

pub fn set_or_clear_description<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of description.

Example

let x = MachineImage::new().set_or_clear_description(Some("example"));
let x = MachineImage::new().set_or_clear_description(None::<String>);

pub fn set_guest_flush<T>(self, v: T) -> Self

where T: Into<bool>,

Sets the value of guest_flush.

Example

let x = MachineImage::new().set_guest_flush(true);

pub fn set_or_clear_guest_flush<T>(self, v: Option<T>) -> Self

where T: Into<bool>,

Sets or clears the value of guest_flush.

Example

let x = MachineImage::new().set_or_clear_guest_flush(Some(false));
let x = MachineImage::new().set_or_clear_guest_flush(None::<bool>);

pub fn set_id<T>(self, v: T) -> Self

where T: Into<u64>,

Sets the value of id.

Example

let x = MachineImage::new().set_id(42_u32);

pub fn set_or_clear_id<T>(self, v: Option<T>) -> Self

where T: Into<u64>,

Sets or clears the value of id.

Example

let x = MachineImage::new().set_or_clear_id(Some(42_u32));
let x = MachineImage::new().set_or_clear_id(None::<u32>);

pub fn set_instance_properties<T>(self, v: T) -> Self

where T: Into<InstanceProperties>,

Sets the value of instance_properties.

Example

use google_cloud_compute_v1::model::InstanceProperties;
let x = MachineImage::new().set_instance_properties(InstanceProperties::default()/* use setters */);

pub fn set_or_clear_instance_properties<T>(self, v: Option<T>) -> Self

where T: Into<InstanceProperties>,

Sets or clears the value of instance_properties.

Example

use google_cloud_compute_v1::model::InstanceProperties;
let x = MachineImage::new().set_or_clear_instance_properties(Some(InstanceProperties::default()/* use setters */));
let x = MachineImage::new().set_or_clear_instance_properties(None::<InstanceProperties>);

pub fn set_kind<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of kind.

Example

let x = MachineImage::new().set_kind("example");

pub fn set_or_clear_kind<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of kind.

Example

let x = MachineImage::new().set_or_clear_kind(Some("example"));
let x = MachineImage::new().set_or_clear_kind(None::<String>);

pub fn set_label_fingerprint<T>(self, v: T) -> Self

where T: Into<Bytes>,

Sets the value of label_fingerprint.

Example

let x = MachineImage::new().set_label_fingerprint(bytes::Bytes::from_static(b"example"));

pub fn set_or_clear_label_fingerprint<T>(self, v: Option<T>) -> Self

where T: Into<Bytes>,

Sets or clears the value of label_fingerprint.

Example

let x = MachineImage::new().set_or_clear_label_fingerprint(Some(bytes::Bytes::from_static(b"example")));
let x = MachineImage::new().set_or_clear_label_fingerprint(None::<bytes::Bytes>);

pub fn set_labels<T, K, V>(self, v: T) -> Self

where T: IntoIterator<Item = (K, V)>, K: Into<String>, V: Into<String>,

Sets the value of labels.

Example

let x = MachineImage::new().set_labels([
    ("key0", "abc"),
    ("key1", "xyz"),
]);

pub fn set_machine_image_encryption_key<T>(self, v: T) -> Self

where T: Into<CustomerEncryptionKey>,

Sets the value of machine_image_encryption_key.

Example

use google_cloud_compute_v1::model::CustomerEncryptionKey;
let x = MachineImage::new().set_machine_image_encryption_key(CustomerEncryptionKey::default()/* use setters */);

pub fn set_or_clear_machine_image_encryption_key<T>(self, v: Option<T>) -> Self

where T: Into<CustomerEncryptionKey>,

Sets or clears the value of machine_image_encryption_key.

Example

use google_cloud_compute_v1::model::CustomerEncryptionKey;
let x = MachineImage::new().set_or_clear_machine_image_encryption_key(Some(CustomerEncryptionKey::default()/* use setters */));
let x = MachineImage::new().set_or_clear_machine_image_encryption_key(None::<CustomerEncryptionKey>);

pub fn set_name<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of name.

Example

let x = MachineImage::new().set_name("example");

pub fn set_or_clear_name<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of name.

Example

let x = MachineImage::new().set_or_clear_name(Some("example"));
let x = MachineImage::new().set_or_clear_name(None::<String>);

pub fn set_satisfies_pzi<T>(self, v: T) -> Self

where T: Into<bool>,

Sets the value of satisfies_pzi.

Example

let x = MachineImage::new().set_satisfies_pzi(true);

pub fn set_or_clear_satisfies_pzi<T>(self, v: Option<T>) -> Self

where T: Into<bool>,

Sets or clears the value of satisfies_pzi.

Example

let x = MachineImage::new().set_or_clear_satisfies_pzi(Some(false));
let x = MachineImage::new().set_or_clear_satisfies_pzi(None::<bool>);

pub fn set_satisfies_pzs<T>(self, v: T) -> Self

where T: Into<bool>,

Sets the value of satisfies_pzs.

Example

let x = MachineImage::new().set_satisfies_pzs(true);

pub fn set_or_clear_satisfies_pzs<T>(self, v: Option<T>) -> Self

where T: Into<bool>,

Sets or clears the value of satisfies_pzs.

Example

let x = MachineImage::new().set_or_clear_satisfies_pzs(Some(false));
let x = MachineImage::new().set_or_clear_satisfies_pzs(None::<bool>);

pub fn set_saved_disks<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<SavedDisk>,

Sets the value of saved_disks.

Example

use google_cloud_compute_v1::model::SavedDisk;
let x = MachineImage::new()
    .set_saved_disks([
        SavedDisk::default()/* use setters */,
        SavedDisk::default()/* use (different) setters */,
    ]);

pub fn set_self_link<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of self_link.

Example

let x = MachineImage::new().set_self_link("example");

pub fn set_or_clear_self_link<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of self_link.

Example

let x = MachineImage::new().set_or_clear_self_link(Some("example"));
let x = MachineImage::new().set_or_clear_self_link(None::<String>);

pub fn set_source_disk_encryption_keys<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<SourceDiskEncryptionKey>,

Sets the value of source_disk_encryption_keys.

Example

use google_cloud_compute_v1::model::SourceDiskEncryptionKey;
let x = MachineImage::new()
    .set_source_disk_encryption_keys([
        SourceDiskEncryptionKey::default()/* use setters */,
        SourceDiskEncryptionKey::default()/* use (different) setters */,
    ]);

pub fn set_source_instance<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of source_instance.

Example

let x = MachineImage::new().set_source_instance("example");

pub fn set_or_clear_source_instance<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of source_instance.

Example

let x = MachineImage::new().set_or_clear_source_instance(Some("example"));
let x = MachineImage::new().set_or_clear_source_instance(None::<String>);

pub fn set_source_instance_properties<T>(self, v: T) -> Self

where T: Into<SourceInstanceProperties>,

Sets the value of source_instance_properties.

Example

use google_cloud_compute_v1::model::SourceInstanceProperties;
let x = MachineImage::new().set_source_instance_properties(SourceInstanceProperties::default()/* use setters */);

pub fn set_or_clear_source_instance_properties<T>(self, v: Option<T>) -> Self

where T: Into<SourceInstanceProperties>,

Sets or clears the value of source_instance_properties.

Example

use google_cloud_compute_v1::model::SourceInstanceProperties;
let x = MachineImage::new().set_or_clear_source_instance_properties(Some(SourceInstanceProperties::default()/* use setters */));
let x = MachineImage::new().set_or_clear_source_instance_properties(None::<SourceInstanceProperties>);

pub fn set_status<T>(self, v: T) -> Self

where T: Into<Status>,

Sets the value of status.

Example

use google_cloud_compute_v1::model::machine_image::Status;
let x0 = MachineImage::new().set_status(Status::Deleting);
let x1 = MachineImage::new().set_status(Status::Invalid);
let x2 = MachineImage::new().set_status(Status::Ready);

pub fn set_or_clear_status<T>(self, v: Option<T>) -> Self

where T: Into<Status>,

Sets or clears the value of status.

Example

use google_cloud_compute_v1::model::machine_image::Status;
let x0 = MachineImage::new().set_or_clear_status(Some(Status::Deleting));
let x1 = MachineImage::new().set_or_clear_status(Some(Status::Invalid));
let x2 = MachineImage::new().set_or_clear_status(Some(Status::Ready));
let x_none = MachineImage::new().set_or_clear_status(None::<Status>);

pub fn set_storage_locations<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<String>,

Sets the value of storage_locations.

Example

let x = MachineImage::new().set_storage_locations(["a", "b", "c"]);

pub fn set_total_storage_bytes<T>(self, v: T) -> Self

where T: Into<i64>,

Sets the value of total_storage_bytes.

Example

let x = MachineImage::new().set_total_storage_bytes(42);

pub fn set_or_clear_total_storage_bytes<T>(self, v: Option<T>) -> Self

where T: Into<i64>,

Sets or clears the value of total_storage_bytes.

Example

let x = MachineImage::new().set_or_clear_total_storage_bytes(Some(42));
let x = MachineImage::new().set_or_clear_total_storage_bytes(None::<i32>);

Trait Implementations

impl Clone for MachineImage

fn clone(&self) -> MachineImage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MachineImage

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

Formats the value using the given formatter.

impl Default for MachineImage

fn default() -> MachineImage

Returns the “default value” for a type.

impl Message for MachineImage

fn typename() -> &'static str

The typename of this message.

impl PartialEq for MachineImage

fn eq(&self, other: &MachineImage) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for MachineImage