Class: Aws::EC2::Types::InstanceRequirements

Inherits:
Struct
  • Object
show all
Includes:
Structure
Defined in:
lib/aws-sdk-ec2/types.rb

Overview

The attributes for the instance types. When you specify instance attributes, Amazon EC2 will identify instance types with these attributes.

You must specify ‘VCpuCount` and `MemoryMiB`. All other attributes are optional. Any unspecified optional attribute is set to its default.

When you specify multiple attributes, you get instance types that satisfy all of the specified attributes. If you specify multiple values for an attribute, you get instance types that satisfy any of the specified values.

To limit the list of instance types from which Amazon EC2 can identify matching instance types, you can use one of the following parameters, but not both in the same request:

  • ‘AllowedInstanceTypes` - The instance types to include in the list. All other instance types are ignored, even if they match your specified attributes.

  • ‘ExcludedInstanceTypes` - The instance types to exclude from the list, even if they match your specified attributes.

<note markdown=“1”> If you specify ‘InstanceRequirements`, you can’t specify ‘InstanceType`.

Attribute-based instance type selection is only supported when using

Auto Scaling groups, EC2 Fleet, and Spot Fleet to launch instances. If you plan to use the launch template in the [launch instance wizard] or with the [RunInstances API], you can’t specify ‘InstanceRequirements`.

</note>

For more information, see [Create a mixed instances group using attribute-based instance type selection] in the *Amazon EC2 Auto Scaling User Guide*, and also [Attribute-based instance type selection for EC2 Fleet], [Attribute-based instance type selection for Spot Fleet], and [Spot placement score] in the *Amazon EC2 User Guide*.

[1]: docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-instance-wizard.html [2]: docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html [3]: docs.aws.amazon.com/autoscaling/ec2/userguide/create-mixed-instances-group-attribute-based-instance-type-selection.html [4]: docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-fleet-attribute-based-instance-type-selection.html [5]: docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-fleet-attribute-based-instance-type-selection.html [6]: docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-placement-score.html

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#accelerator_countTypes::AcceleratorCount

The minimum and maximum number of accelerators (GPUs, FPGAs, or Amazon Web Services Inferentia chips) on an instance.

To exclude accelerator-enabled instance types, set ‘Max` to `0`.

Default: No minimum or maximum limits



40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#accelerator_manufacturersArray<String>

Indicates whether instance types must have accelerators by specific manufacturers.

  • For instance types with NVIDIA devices, specify ‘nvidia`.

  • For instance types with AMD devices, specify ‘amd`.

  • For instance types with Amazon Web Services devices, specify ‘amazon-web-services`.

  • For instance types with Xilinx devices, specify ‘xilinx`.

Default: Any manufacturer

Returns:

  • (Array<String>)


40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#accelerator_namesArray<String>

The accelerators that must be on the instance type.

  • For instance types with NVIDIA A100 GPUs, specify ‘a100`.

  • For instance types with NVIDIA V100 GPUs, specify ‘v100`.

  • For instance types with NVIDIA K80 GPUs, specify ‘k80`.

  • For instance types with NVIDIA T4 GPUs, specify ‘t4`.

  • For instance types with NVIDIA M60 GPUs, specify ‘m60`.

  • For instance types with AMD Radeon Pro V520 GPUs, specify ‘radeon-pro-v520`.

  • For instance types with Xilinx VU9P FPGAs, specify ‘vu9p`.

  • For instance types with Amazon Web Services Inferentia chips, specify ‘inferentia`.

  • For instance types with NVIDIA GRID K520 GPUs, specify ‘k520`.

Default: Any accelerator

Returns:

  • (Array<String>)


40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#accelerator_total_memory_mi_bTypes::AcceleratorTotalMemoryMiB

The minimum and maximum amount of total accelerator memory, in MiB.

Default: No minimum or maximum limits



40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#accelerator_typesArray<String>

The accelerator types that must be on the instance type.

  • For instance types with GPU accelerators, specify ‘gpu`.

  • For instance types with FPGA accelerators, specify ‘fpga`.

  • For instance types with inference accelerators, specify ‘inference`.

Default: Any accelerator type

Returns:

  • (Array<String>)


40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#allowed_instance_typesArray<String>

The instance types to apply your specified attributes against. All other instance types are ignored, even if they match your specified attributes.

You can use strings with one or more wild cards, represented by an asterisk (‘*`), to allow an instance type, size, or generation. The following are examples: `m5.8xlarge`, `c5*.*`, `m5a.*`, `r*`, `3`.

For example, if you specify ‘c5*`,Amazon EC2 will allow the entire C5 instance family, which includes all C5a and C5n instance types. If you specify `m5a.*`, Amazon EC2 will allow all the M5a instance types, but not the M5n instance types.

<note markdown=“1”> If you specify ‘AllowedInstanceTypes`, you can’t specify ‘ExcludedInstanceTypes`.

</note>

Default: All instance types

Returns:

  • (Array<String>)


40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#bare_metalString

Indicates whether bare metal instance types must be included, excluded, or required.

  • To include bare metal instance types, specify ‘included`.

  • To require only bare metal instance types, specify ‘required`.

  • To exclude bare metal instance types, specify ‘excluded`.

Default: ‘excluded`

Returns:

  • (String)


40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#baseline_ebs_bandwidth_mbpsTypes::BaselineEbsBandwidthMbps

The minimum and maximum baseline bandwidth to Amazon EBS, in Mbps. For more information, see [Amazon EBS–optimized instances] in the *Amazon EC2 User Guide*.

Default: No minimum or maximum limits

[1]: docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-optimized.html



40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#burstable_performanceString

Indicates whether burstable performance T instance types are included, excluded, or required. For more information, see [Burstable performance instances].

  • To include burstable performance instance types, specify ‘included`.

  • To require only burstable performance instance types, specify ‘required`.

  • To exclude burstable performance instance types, specify ‘excluded`.

Default: ‘excluded`

[1]: docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances.html

Returns:

  • (String)


40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#cpu_manufacturersArray<String>

The CPU manufacturers to include.

  • For instance types with Intel CPUs, specify ‘intel`.

  • For instance types with AMD CPUs, specify ‘amd`.

  • For instance types with Amazon Web Services CPUs, specify ‘amazon-web-services`.

<note markdown=“1”> Don’t confuse the CPU manufacturer with the CPU architecture. Instances will be launched with a compatible CPU architecture based on the Amazon Machine Image (AMI) that you specify in your launch template.

</note>

Default: Any manufacturer

Returns:

  • (Array<String>)


40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#excluded_instance_typesArray<String>

The instance types to exclude.

You can use strings with one or more wild cards, represented by an asterisk (‘*`), to exclude an instance type, size, or generation. The following are examples: `m5.8xlarge`, `c5*.*`, `m5a.*`, `r*`, `3`.

For example, if you specify ‘c5*`,Amazon EC2 will exclude the entire C5 instance family, which includes all C5a and C5n instance types. If you specify `m5a.*`, Amazon EC2 will exclude all the M5a instance types, but not the M5n instance types.

<note markdown=“1”> If you specify ‘ExcludedInstanceTypes`, you can’t specify ‘AllowedInstanceTypes`.

</note>

Default: No excluded instance types

Returns:

  • (Array<String>)


40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#instance_generationsArray<String>

Indicates whether current or previous generation instance types are included. The current generation instance types are recommended for use. Current generation instance types are typically the latest two to three generations in each instance family. For more information, see [Instance types] in the *Amazon EC2 User Guide*.

For current generation instance types, specify ‘current`.

For previous generation instance types, specify ‘previous`.

Default: Current and previous generation instance types

[1]: docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html

Returns:

  • (Array<String>)


40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#local_storageString

Indicates whether instance types with instance store volumes are included, excluded, or required. For more information, [Amazon EC2 instance store] in the *Amazon EC2 User Guide*.

  • To include instance types with instance store volumes, specify ‘included`.

  • To require only instance types with instance store volumes, specify ‘required`.

  • To exclude instance types with instance store volumes, specify ‘excluded`.

Default: ‘included`

[1]: docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html

Returns:

  • (String)


40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#local_storage_typesArray<String>

The type of local storage that is required.

  • For instance types with hard disk drive (HDD) storage, specify ‘hdd`.

  • For instance types with solid state drive (SSD) storage, specify ‘ssd`.

Default: ‘hdd` and `ssd`

Returns:

  • (Array<String>)


40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#memory_gi_b_per_v_cpuTypes::MemoryGiBPerVCpu

The minimum and maximum amount of memory per vCPU, in GiB.

Default: No minimum or maximum limits



40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#memory_mi_bTypes::MemoryMiB

The minimum and maximum amount of memory, in MiB.

Returns:



40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#network_bandwidth_gbpsTypes::NetworkBandwidthGbps

The minimum and maximum amount of network bandwidth, in gigabits per second (Gbps).

Default: No minimum or maximum limits



40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#network_interface_countTypes::NetworkInterfaceCount

The minimum and maximum number of network interfaces.

Default: No minimum or maximum limits



40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#on_demand_max_price_percentage_over_lowest_priceInteger

The price protection threshold for On-Demand Instances. This is the maximum you’ll pay for an On-Demand Instance, expressed as a percentage above the least expensive current generation M, C, or R instance type with your specified attributes. When Amazon EC2 selects instance types with your attributes, it excludes instance types priced above your threshold.

The parameter accepts an integer, which Amazon EC2 interprets as a percentage.

To turn off price protection, specify a high value, such as ‘999999`.

This parameter is not supported for [GetSpotPlacementScores] and [GetInstanceTypesFromInstanceRequirements].

<note markdown=“1”> If you set ‘TargetCapacityUnitType` to `vcpu` or `memory-mib`, the price protection threshold is applied based on the per-vCPU or per-memory price instead of the per-instance price.

</note>

Default: ‘20`

[1]: docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetSpotPlacementScores.html [2]: docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetInstanceTypesFromInstanceRequirements.html

Returns:

  • (Integer)


40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#require_hibernate_supportBoolean

Indicates whether instance types must support hibernation for On-Demand Instances.

This parameter is not supported for [GetSpotPlacementScores].

Default: ‘false`

[1]: docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetSpotPlacementScores.html

Returns:

  • (Boolean)


40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#spot_max_price_percentage_over_lowest_priceInteger

The price protection threshold for Spot Instances. This is the maximum you’ll pay for a Spot Instance, expressed as a percentage above the least expensive current generation M, C, or R instance type with your specified attributes. When Amazon EC2 selects instance types with your attributes, it excludes instance types priced above your threshold.

The parameter accepts an integer, which Amazon EC2 interprets as a percentage.

To turn off price protection, specify a high value, such as ‘999999`.

This parameter is not supported for [GetSpotPlacementScores] and [GetInstanceTypesFromInstanceRequirements].

<note markdown=“1”> If you set ‘TargetCapacityUnitType` to `vcpu` or `memory-mib`, the price protection threshold is applied based on the per-vCPU or per-memory price instead of the per-instance price.

</note>

Default: ‘100`

[1]: docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetSpotPlacementScores.html [2]: docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetInstanceTypesFromInstanceRequirements.html

Returns:

  • (Integer)


40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#total_local_storage_gbTypes::TotalLocalStorageGB

The minimum and maximum amount of total local storage, in GB.

Default: No minimum or maximum limits



40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end

#v_cpu_countTypes::VCpuCountRange

The minimum and maximum number of vCPUs.



40292
40293
40294
40295
40296
40297
40298
40299
40300
40301
40302
40303
40304
40305
40306
40307
40308
40309
40310
40311
40312
40313
40314
40315
40316
40317
40318
# File 'lib/aws-sdk-ec2/types.rb', line 40292

class InstanceRequirements < Struct.new(
  :v_cpu_count,
  :memory_mi_b,
  :cpu_manufacturers,
  :memory_gi_b_per_v_cpu,
  :excluded_instance_types,
  :instance_generations,
  :spot_max_price_percentage_over_lowest_price,
  :on_demand_max_price_percentage_over_lowest_price,
  :bare_metal,
  :burstable_performance,
  :require_hibernate_support,
  :network_interface_count,
  :local_storage,
  :local_storage_types,
  :total_local_storage_gb,
  :baseline_ebs_bandwidth_mbps,
  :accelerator_types,
  :accelerator_count,
  :accelerator_manufacturers,
  :accelerator_names,
  :accelerator_total_memory_mi_b,
  :network_bandwidth_gbps,
  :allowed_instance_types)
  SENSITIVE = []
  include Aws::Structure
end