Struct InstanceRequirementsRequest 

#[non_exhaustive]
pub struct InstanceRequirementsRequest {

    pub v_cpu_count: Option<VCpuCountRangeRequest>,
    pub memory_mib: Option<MemoryMiBRequest>,
    pub cpu_manufacturers: Option<Vec<CpuManufacturer>>,
    pub memory_gib_per_v_cpu: Option<MemoryGiBPerVCpuRequest>,
    pub excluded_instance_types: Option<Vec<String>>,
    pub instance_generations: Option<Vec<InstanceGeneration>>,
    pub spot_max_price_percentage_over_lowest_price: Option<i32>,
    pub on_demand_max_price_percentage_over_lowest_price: Option<i32>,
    pub bare_metal: Option<BareMetal>,
    pub burstable_performance: Option<BurstablePerformance>,
    pub require_hibernate_support: Option<bool>,
    pub network_interface_count: Option<NetworkInterfaceCountRequest>,
    pub local_storage: Option<LocalStorage>,
    pub local_storage_types: Option<Vec<LocalStorageType>>,
    pub total_local_storage_gb: Option<TotalLocalStorageGbRequest>,
    pub baseline_ebs_bandwidth_mbps: Option<BaselineEbsBandwidthMbpsRequest>,
    pub accelerator_types: Option<Vec<AcceleratorType>>,
    pub accelerator_count: Option<AcceleratorCountRequest>,
    pub accelerator_manufacturers: Option<Vec<AcceleratorManufacturer>>,
    pub accelerator_names: Option<Vec<AcceleratorName>>,
    pub accelerator_total_memory_mib: Option<AcceleratorTotalMemoryMiBRequest>,
    pub network_bandwidth_gbps: Option<NetworkBandwidthGbpsRequest>,
    pub allowed_instance_types: Option<Vec<String>>,
    pub max_spot_price_as_percentage_of_optimal_on_demand_price: Option<i32>,
}

The instance requirements for attribute-based instance type selection. Instead of specifying exact instance types, you define requirements such as vCPU count, memory size, network performance, and accelerator specifications. Amazon ECS automatically selects Amazon EC2 instance types that match these requirements, providing flexibility and helping to mitigate capacity constraints.

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.

v_cpu_count: Option<VCpuCountRangeRequest>

The minimum and maximum number of vCPUs for the instance types. Amazon ECS selects instance types that have vCPU counts within this range.

memory_mib: Option<MemoryMiBRequest>

The minimum and maximum amount of memory in mebibytes (MiB) for the instance types. Amazon ECS selects instance types that have memory within this range.

cpu_manufacturers: Option<Vec<CpuManufacturer>>

The CPU manufacturers to include or exclude. You can specify intel, amd, or amazon-web-services to control which CPU types are used for your workloads.

memory_gib_per_v_cpu: Option<MemoryGiBPerVCpuRequest>

The minimum and maximum amount of memory per vCPU in gibibytes (GiB). This helps ensure that instance types have the appropriate memory-to-CPU ratio for your workloads.

excluded_instance_types: Option<Vec<String>>

The instance types to exclude from selection. Use this to prevent Amazon ECS from selecting specific instance types that may not be suitable for your workloads.

instance_generations: Option<Vec<InstanceGeneration>>

The instance generations to include. You can specify current to use the latest generation instances, or previous to include previous generation instances for cost optimization.

spot_max_price_percentage_over_lowest_price: Option<i32>

The maximum price for Spot instances as a percentage over the lowest priced On-Demand instance. This helps control Spot instance costs while maintaining access to capacity.

on_demand_max_price_percentage_over_lowest_price: Option<i32>

The price protection threshold for On-Demand Instances, as a percentage higher than an identified On-Demand price. The identified On-Demand price is the price of the lowest priced current generation C, M, or R instance type with your specified attributes. If no current generation C, M, or R instance type matches your attributes, then the identified price is from either the lowest priced current generation instance types or, failing that, the lowest priced previous generation instance types that match your attributes. When Amazon ECS selects instance types with your attributes, we will exclude instance types whose price exceeds your specified threshold.

bare_metal: Option<BareMetal>

Indicates whether to include bare metal instance types. Set to included to allow bare metal instances, excluded to exclude them, or required to use only bare metal instances.

burstable_performance: Option<BurstablePerformance>

Indicates whether to include burstable performance instance types (T2, T3, T3a, T4g). Set to included to allow burstable instances, excluded to exclude them, or required to use only burstable instances.

require_hibernate_support: Option<bool>

Indicates whether the instance types must support hibernation. When set to true, only instance types that support hibernation are selected.

network_interface_count: Option<NetworkInterfaceCountRequest>

The minimum and maximum number of network interfaces for the instance types. This is useful for workloads that require multiple network interfaces.

local_storage: Option<LocalStorage>

Indicates whether to include instance types with local storage. Set to included to allow local storage, excluded to exclude it, or required to use only instances with local storage.

local_storage_types: Option<Vec<LocalStorageType>>

The local storage types to include. You can specify hdd for hard disk drives, ssd for solid state drives, or both.

total_local_storage_gb: Option<TotalLocalStorageGbRequest>

The minimum and maximum total local storage in gigabytes (GB) for instance types with local storage.

baseline_ebs_bandwidth_mbps: Option<BaselineEbsBandwidthMbpsRequest>

The minimum and maximum baseline Amazon EBS bandwidth in megabits per second (Mbps). This is important for workloads with high storage I/O requirements.

accelerator_types: Option<Vec<AcceleratorType>>

The accelerator types to include. You can specify gpu for graphics processing units, fpga for field programmable gate arrays, or inference for machine learning inference accelerators.

accelerator_count: Option<AcceleratorCountRequest>

The minimum and maximum number of accelerators for the instance types. This is used when you need instances with specific numbers of GPUs or other accelerators.

accelerator_manufacturers: Option<Vec<AcceleratorManufacturer>>

The accelerator manufacturers to include. You can specify nvidia, amd, amazon-web-services, or xilinx depending on your accelerator requirements.

accelerator_names: Option<Vec<AcceleratorName>>

The specific accelerator names to include. For example, you can specify a100, v100, k80, or other specific accelerator models.

accelerator_total_memory_mib: Option<AcceleratorTotalMemoryMiBRequest>

The minimum and maximum total accelerator memory in mebibytes (MiB). This is important for GPU workloads that require specific amounts of video memory.

network_bandwidth_gbps: Option<NetworkBandwidthGbpsRequest>

The minimum and maximum network bandwidth in gigabits per second (Gbps). This is crucial for network-intensive workloads that require high throughput.

allowed_instance_types: Option<Vec<String>>

The instance types to include in the selection. When specified, Amazon ECS only considers these instance types, subject to the other requirements specified.

max_spot_price_as_percentage_of_optimal_on_demand_price: Option<i32>

The maximum price for Spot instances as a percentage of the optimal On-Demand price. This provides more precise cost control for Spot instance selection.

Implementations

impl InstanceRequirementsRequest

pub fn v_cpu_count(&self) -> Option<&VCpuCountRangeRequest>

The minimum and maximum number of vCPUs for the instance types. Amazon ECS selects instance types that have vCPU counts within this range.

pub fn memory_mib(&self) -> Option<&MemoryMiBRequest>

The minimum and maximum amount of memory in mebibytes (MiB) for the instance types. Amazon ECS selects instance types that have memory within this range.

pub fn cpu_manufacturers(&self) -> &[CpuManufacturer]

The CPU manufacturers to include or exclude. You can specify intel, amd, or amazon-web-services to control which CPU types are used for your workloads.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .cpu_manufacturers.is_none().

pub fn memory_gib_per_v_cpu(&self) -> Option<&MemoryGiBPerVCpuRequest>

The minimum and maximum amount of memory per vCPU in gibibytes (GiB). This helps ensure that instance types have the appropriate memory-to-CPU ratio for your workloads.

pub fn excluded_instance_types(&self) -> &[String]

The instance types to exclude from selection. Use this to prevent Amazon ECS from selecting specific instance types that may not be suitable for your workloads.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .excluded_instance_types.is_none().

pub fn instance_generations(&self) -> &[InstanceGeneration]

The instance generations to include. You can specify current to use the latest generation instances, or previous to include previous generation instances for cost optimization.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .instance_generations.is_none().

pub fn spot_max_price_percentage_over_lowest_price(&self) -> Option<i32>

The maximum price for Spot instances as a percentage over the lowest priced On-Demand instance. This helps control Spot instance costs while maintaining access to capacity.

pub fn on_demand_max_price_percentage_over_lowest_price(&self) -> Option<i32>

The price protection threshold for On-Demand Instances, as a percentage higher than an identified On-Demand price. The identified On-Demand price is the price of the lowest priced current generation C, M, or R instance type with your specified attributes. If no current generation C, M, or R instance type matches your attributes, then the identified price is from either the lowest priced current generation instance types or, failing that, the lowest priced previous generation instance types that match your attributes. When Amazon ECS selects instance types with your attributes, we will exclude instance types whose price exceeds your specified threshold.

pub fn bare_metal(&self) -> Option<&BareMetal>

Indicates whether to include bare metal instance types. Set to included to allow bare metal instances, excluded to exclude them, or required to use only bare metal instances.

pub fn burstable_performance(&self) -> Option<&BurstablePerformance>

Indicates whether to include burstable performance instance types (T2, T3, T3a, T4g). Set to included to allow burstable instances, excluded to exclude them, or required to use only burstable instances.

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

Indicates whether the instance types must support hibernation. When set to true, only instance types that support hibernation are selected.

pub fn network_interface_count(&self) -> Option<&NetworkInterfaceCountRequest>

The minimum and maximum number of network interfaces for the instance types. This is useful for workloads that require multiple network interfaces.

pub fn local_storage(&self) -> Option<&LocalStorage>

Indicates whether to include instance types with local storage. Set to included to allow local storage, excluded to exclude it, or required to use only instances with local storage.

pub fn local_storage_types(&self) -> &[LocalStorageType]

The local storage types to include. You can specify hdd for hard disk drives, ssd for solid state drives, or both.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .local_storage_types.is_none().

pub fn total_local_storage_gb(&self) -> Option<&TotalLocalStorageGbRequest>

The minimum and maximum total local storage in gigabytes (GB) for instance types with local storage.

pub fn baseline_ebs_bandwidth_mbps( &self, ) -> Option<&BaselineEbsBandwidthMbpsRequest>

The minimum and maximum baseline Amazon EBS bandwidth in megabits per second (Mbps). This is important for workloads with high storage I/O requirements.

pub fn accelerator_types(&self) -> &[AcceleratorType]

The accelerator types to include. You can specify gpu for graphics processing units, fpga for field programmable gate arrays, or inference for machine learning inference accelerators.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .accelerator_types.is_none().

pub fn accelerator_count(&self) -> Option<&AcceleratorCountRequest>

The minimum and maximum number of accelerators for the instance types. This is used when you need instances with specific numbers of GPUs or other accelerators.

pub fn accelerator_manufacturers(&self) -> &[AcceleratorManufacturer]

The accelerator manufacturers to include. You can specify nvidia, amd, amazon-web-services, or xilinx depending on your accelerator requirements.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .accelerator_manufacturers.is_none().

pub fn accelerator_names(&self) -> &[AcceleratorName]

The specific accelerator names to include. For example, you can specify a100, v100, k80, or other specific accelerator models.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .accelerator_names.is_none().

pub fn accelerator_total_memory_mib( &self, ) -> Option<&AcceleratorTotalMemoryMiBRequest>

The minimum and maximum total accelerator memory in mebibytes (MiB). This is important for GPU workloads that require specific amounts of video memory.

pub fn network_bandwidth_gbps(&self) -> Option<&NetworkBandwidthGbpsRequest>

The minimum and maximum network bandwidth in gigabits per second (Gbps). This is crucial for network-intensive workloads that require high throughput.

pub fn allowed_instance_types(&self) -> &[String]

The instance types to include in the selection. When specified, Amazon ECS only considers these instance types, subject to the other requirements specified.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .allowed_instance_types.is_none().

pub fn max_spot_price_as_percentage_of_optimal_on_demand_price( &self, ) -> Option<i32>

The maximum price for Spot instances as a percentage of the optimal On-Demand price. This provides more precise cost control for Spot instance selection.

impl InstanceRequirementsRequest

pub fn builder() -> InstanceRequirementsRequestBuilder

Creates a new builder-style object to manufacture InstanceRequirementsRequest.

Trait Implementations

impl Clone for InstanceRequirementsRequest

fn clone(&self) -> InstanceRequirementsRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InstanceRequirementsRequest

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

Formats the value using the given formatter.

impl PartialEq for InstanceRequirementsRequest

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