Skip to content

ECS  >  Dictionaries  >  InstanceRequirementsRequestDict

InstanceRequirementsRequestDict

Dictionary Type

InstanceRequirementsRequestDict

Bases: TypedDict

Dictionary form of InstanceRequirementsRequest.

Attributes

accelerator_count instance-attribute

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 instance-attribute
accelerator_manufacturers: Sequence[str] | None

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

accelerator_names instance-attribute
accelerator_names: Sequence[str] | None

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

accelerator_total_memory_mi_b instance-attribute

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

accelerator_types instance-attribute
accelerator_types: Sequence[str] | None

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.

allowed_instance_types instance-attribute
allowed_instance_types: Sequence[str] | None

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

bare_metal instance-attribute
bare_metal: str | None

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.

baseline_ebs_bandwidth_mbps instance-attribute

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

burstable_performance instance-attribute
burstable_performance: str | None

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.

cpu_manufacturers instance-attribute
cpu_manufacturers: Sequence[str] | None

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.

excluded_instance_types instance-attribute
excluded_instance_types: Sequence[str] | None

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 instance-attribute
instance_generations: Sequence[str] | None

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.

local_storage instance-attribute
local_storage: str | None

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 instance-attribute
local_storage_types: Sequence[str] | None

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

max_spot_price_as_percentage_of_optimal_on_demand_price instance-attribute
max_spot_price_as_percentage_of_optimal_on_demand_price: int | None

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.

memory_gi_b_per_v_cpu instance-attribute
memory_gi_b_per_v_cpu: MemoryGiBPerVCpuRequest | MemoryGiBPerVCpuRequestDict | None

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.

memory_mi_b instance-attribute

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.

network_bandwidth_gbps instance-attribute

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

network_interface_count instance-attribute

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

on_demand_max_price_percentage_over_lowest_price instance-attribute
on_demand_max_price_percentage_over_lowest_price: int | None

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.

require_hibernate_support instance-attribute
require_hibernate_support: bool | None

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

spot_max_price_percentage_over_lowest_price instance-attribute
spot_max_price_percentage_over_lowest_price: int | None

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.

total_local_storage_gb instance-attribute

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

v_cpu_count instance-attribute

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