Struct Items 

#[non_exhaustive]
pub struct Items {
    pub key: Option<String>,
    pub value: Option<String>,
    /* private fields */
}

Available on crate features instance-templates or instances or machine-images or projects or region-instance-templates or region-instances only.

The message type for the items field.

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.

key: Option<String>

Key for the metadata entry. Keys must conform to the following regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length. This is reflected as part of a URL in the metadata server. Additionally, to avoid ambiguity, keys must not conflict with any other metadata keys for the project.

value: Option<String>

Value for the metadata entry. These are free-form strings, and only have meaning as interpreted by the image running in the instance. The only restriction placed on values is that their size must be less than or equal to 262144 bytes (256 KiB).

Implementations

impl Items

pub fn new() -> Self

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

where T: Into<String>,

Sets the value of key.

Example

let x = Items::new().set_key("example");

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

where T: Into<String>,

Sets or clears the value of key.

Example

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

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

where T: Into<String>,

Sets the value of value.

Example

let x = Items::new().set_value("example");

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

where T: Into<String>,

Sets or clears the value of value.

Example

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

Trait Implementations

impl Clone for Items

fn clone(&self) -> Items

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Items

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

Formats the value using the given formatter.

impl Default for Items

fn default() -> Items

Returns the “default value” for a type.

impl Message for Items

fn typename() -> &'static str

The typename of this message.

impl PartialEq for Items

fn eq(&self, other: &Items) -> 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 Items