Struct BlockDeviceMapping

#[non_exhaustive]
pub struct BlockDeviceMapping {
    pub virtual_name: Option<String>,
    pub device_name: Option<String>,
    pub ebs: Option<Ebs>,
    pub no_device: Option<bool>,
}

Describes a block device mapping.

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.

virtual_name: Option<String>

The name of the instance store volume (virtual device) to attach to an instance at launch. The name must be in the form ephemeralX where X is a number starting from zero (0), for example, ephemeral0.

device_name: Option<String>

The device name assigned to the volume (for example, /dev/sdh or xvdh). For more information, see Device naming on Linux instances in the Amazon EC2 User Guide.

To define a block device mapping, set the device name and exactly one of the following properties: Ebs, NoDevice, or VirtualName.

ebs: Option<Ebs>

Information to attach an EBS volume to an instance at launch.

no_device: Option<bool>

Setting this value to true prevents a volume that is included in the block device mapping of the AMI from being mapped to the specified device name at launch.

If NoDevice is true for the root device, instances might fail the EC2 health check. In that case, Amazon EC2 Auto Scaling launches replacement instances.

Implementations

impl BlockDeviceMapping

pub fn virtual_name(&self) -> Option<&str>

The name of the instance store volume (virtual device) to attach to an instance at launch. The name must be in the form ephemeralX where X is a number starting from zero (0), for example, ephemeral0.

pub fn device_name(&self) -> Option<&str>

The device name assigned to the volume (for example, /dev/sdh or xvdh). For more information, see Device naming on Linux instances in the Amazon EC2 User Guide.

To define a block device mapping, set the device name and exactly one of the following properties: Ebs, NoDevice, or VirtualName.

pub fn ebs(&self) -> Option<&Ebs>

Information to attach an EBS volume to an instance at launch.

pub fn no_device(&self) -> Option<bool>

Setting this value to true prevents a volume that is included in the block device mapping of the AMI from being mapped to the specified device name at launch.

If NoDevice is true for the root device, instances might fail the EC2 health check. In that case, Amazon EC2 Auto Scaling launches replacement instances.

impl BlockDeviceMapping

pub fn builder() -> BlockDeviceMappingBuilder

Creates a new builder-style object to manufacture BlockDeviceMapping.

Trait Implementations

impl Clone for BlockDeviceMapping

fn clone(&self) -> BlockDeviceMapping

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BlockDeviceMapping

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

Formats the value using the given formatter.

impl PartialEq for BlockDeviceMapping

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