Interface InstanceRequirements.Builder
-
- All Superinterfaces:
Buildable
,CopyableBuilder<InstanceRequirements.Builder,InstanceRequirements>
,SdkBuilder<InstanceRequirements.Builder,InstanceRequirements>
,SdkPojo
- Enclosing class:
- InstanceRequirements
public static interface InstanceRequirements.Builder extends SdkPojo, CopyableBuilder<InstanceRequirements.Builder,InstanceRequirements>
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description default InstanceRequirements.Builder
acceleratorCount(Consumer<AcceleratorCount.Builder> acceleratorCount)
The minimum and maximum number of accelerators (GPUs, FPGAs, or Amazon Web Services Inferentia chips) on an instance.InstanceRequirements.Builder
acceleratorCount(AcceleratorCount acceleratorCount)
The minimum and maximum number of accelerators (GPUs, FPGAs, or Amazon Web Services Inferentia chips) on an instance.InstanceRequirements.Builder
acceleratorManufacturers(Collection<AcceleratorManufacturer> acceleratorManufacturers)
Indicates whether instance types must have accelerators by specific manufacturers.InstanceRequirements.Builder
acceleratorManufacturers(AcceleratorManufacturer... acceleratorManufacturers)
Indicates whether instance types must have accelerators by specific manufacturers.InstanceRequirements.Builder
acceleratorManufacturersWithStrings(String... acceleratorManufacturers)
Indicates whether instance types must have accelerators by specific manufacturers.InstanceRequirements.Builder
acceleratorManufacturersWithStrings(Collection<String> acceleratorManufacturers)
Indicates whether instance types must have accelerators by specific manufacturers.InstanceRequirements.Builder
acceleratorNames(Collection<AcceleratorName> acceleratorNames)
The accelerators that must be on the instance type.InstanceRequirements.Builder
acceleratorNames(AcceleratorName... acceleratorNames)
The accelerators that must be on the instance type.InstanceRequirements.Builder
acceleratorNamesWithStrings(String... acceleratorNames)
The accelerators that must be on the instance type.InstanceRequirements.Builder
acceleratorNamesWithStrings(Collection<String> acceleratorNames)
The accelerators that must be on the instance type.default InstanceRequirements.Builder
acceleratorTotalMemoryMiB(Consumer<AcceleratorTotalMemoryMiB.Builder> acceleratorTotalMemoryMiB)
The minimum and maximum amount of total accelerator memory, in MiB.InstanceRequirements.Builder
acceleratorTotalMemoryMiB(AcceleratorTotalMemoryMiB acceleratorTotalMemoryMiB)
The minimum and maximum amount of total accelerator memory, in MiB.InstanceRequirements.Builder
acceleratorTypes(Collection<AcceleratorType> acceleratorTypes)
The accelerator types that must be on the instance type.InstanceRequirements.Builder
acceleratorTypes(AcceleratorType... acceleratorTypes)
The accelerator types that must be on the instance type.InstanceRequirements.Builder
acceleratorTypesWithStrings(String... acceleratorTypes)
The accelerator types that must be on the instance type.InstanceRequirements.Builder
acceleratorTypesWithStrings(Collection<String> acceleratorTypes)
The accelerator types that must be on the instance type.InstanceRequirements.Builder
allowedInstanceTypes(String... allowedInstanceTypes)
The instance types to apply your specified attributes against.InstanceRequirements.Builder
allowedInstanceTypes(Collection<String> allowedInstanceTypes)
The instance types to apply your specified attributes against.InstanceRequirements.Builder
bareMetal(String bareMetal)
Indicates whether bare metal instance types must be included, excluded, or required.InstanceRequirements.Builder
bareMetal(BareMetal bareMetal)
Indicates whether bare metal instance types must be included, excluded, or required.default InstanceRequirements.Builder
baselineEbsBandwidthMbps(Consumer<BaselineEbsBandwidthMbps.Builder> baselineEbsBandwidthMbps)
The minimum and maximum baseline bandwidth to Amazon EBS, in Mbps.InstanceRequirements.Builder
baselineEbsBandwidthMbps(BaselineEbsBandwidthMbps baselineEbsBandwidthMbps)
The minimum and maximum baseline bandwidth to Amazon EBS, in Mbps.InstanceRequirements.Builder
burstablePerformance(String burstablePerformance)
Indicates whether burstable performance T instance types are included, excluded, or required.InstanceRequirements.Builder
burstablePerformance(BurstablePerformance burstablePerformance)
Indicates whether burstable performance T instance types are included, excluded, or required.InstanceRequirements.Builder
cpuManufacturers(Collection<CpuManufacturer> cpuManufacturers)
The CPU manufacturers to include.InstanceRequirements.Builder
cpuManufacturers(CpuManufacturer... cpuManufacturers)
The CPU manufacturers to include.InstanceRequirements.Builder
cpuManufacturersWithStrings(String... cpuManufacturers)
The CPU manufacturers to include.InstanceRequirements.Builder
cpuManufacturersWithStrings(Collection<String> cpuManufacturers)
The CPU manufacturers to include.InstanceRequirements.Builder
excludedInstanceTypes(String... excludedInstanceTypes)
The instance types to exclude.InstanceRequirements.Builder
excludedInstanceTypes(Collection<String> excludedInstanceTypes)
The instance types to exclude.InstanceRequirements.Builder
instanceGenerations(Collection<InstanceGeneration> instanceGenerations)
Indicates whether current or previous generation instance types are included.InstanceRequirements.Builder
instanceGenerations(InstanceGeneration... instanceGenerations)
Indicates whether current or previous generation instance types are included.InstanceRequirements.Builder
instanceGenerationsWithStrings(String... instanceGenerations)
Indicates whether current or previous generation instance types are included.InstanceRequirements.Builder
instanceGenerationsWithStrings(Collection<String> instanceGenerations)
Indicates whether current or previous generation instance types are included.InstanceRequirements.Builder
localStorage(String localStorage)
Indicates whether instance types with instance store volumes are included, excluded, or required.InstanceRequirements.Builder
localStorage(LocalStorage localStorage)
Indicates whether instance types with instance store volumes are included, excluded, or required.InstanceRequirements.Builder
localStorageTypes(Collection<LocalStorageType> localStorageTypes)
The type of local storage that is required.InstanceRequirements.Builder
localStorageTypes(LocalStorageType... localStorageTypes)
The type of local storage that is required.InstanceRequirements.Builder
localStorageTypesWithStrings(String... localStorageTypes)
The type of local storage that is required.InstanceRequirements.Builder
localStorageTypesWithStrings(Collection<String> localStorageTypes)
The type of local storage that is required.InstanceRequirements.Builder
maxSpotPriceAsPercentageOfOptimalOnDemandPrice(Integer maxSpotPriceAsPercentageOfOptimalOnDemandPrice)
[Price protection] The price protection threshold for Spot Instances, as a percentage of an identified On-Demand price.default InstanceRequirements.Builder
memoryGiBPerVCpu(Consumer<MemoryGiBPerVCpu.Builder> memoryGiBPerVCpu)
The minimum and maximum amount of memory per vCPU, in GiB.InstanceRequirements.Builder
memoryGiBPerVCpu(MemoryGiBPerVCpu memoryGiBPerVCpu)
The minimum and maximum amount of memory per vCPU, in GiB.default InstanceRequirements.Builder
memoryMiB(Consumer<MemoryMiB.Builder> memoryMiB)
The minimum and maximum amount of memory, in MiB.InstanceRequirements.Builder
memoryMiB(MemoryMiB memoryMiB)
The minimum and maximum amount of memory, in MiB.default InstanceRequirements.Builder
networkBandwidthGbps(Consumer<NetworkBandwidthGbps.Builder> networkBandwidthGbps)
The minimum and maximum amount of network bandwidth, in gigabits per second (Gbps).InstanceRequirements.Builder
networkBandwidthGbps(NetworkBandwidthGbps networkBandwidthGbps)
The minimum and maximum amount of network bandwidth, in gigabits per second (Gbps).default InstanceRequirements.Builder
networkInterfaceCount(Consumer<NetworkInterfaceCount.Builder> networkInterfaceCount)
The minimum and maximum number of network interfaces.InstanceRequirements.Builder
networkInterfaceCount(NetworkInterfaceCount networkInterfaceCount)
The minimum and maximum number of network interfaces.InstanceRequirements.Builder
onDemandMaxPricePercentageOverLowestPrice(Integer onDemandMaxPricePercentageOverLowestPrice)
[Price protection] The price protection threshold for On-Demand Instances, as a percentage higher than an identified On-Demand price.InstanceRequirements.Builder
requireHibernateSupport(Boolean requireHibernateSupport)
Indicates whether instance types must support hibernation for On-Demand Instances.InstanceRequirements.Builder
spotMaxPricePercentageOverLowestPrice(Integer spotMaxPricePercentageOverLowestPrice)
[Price protection] The price protection threshold for Spot Instances, as a percentage higher than an identified Spot price.default InstanceRequirements.Builder
totalLocalStorageGB(Consumer<TotalLocalStorageGB.Builder> totalLocalStorageGB)
The minimum and maximum amount of total local storage, in GB.InstanceRequirements.Builder
totalLocalStorageGB(TotalLocalStorageGB totalLocalStorageGB)
The minimum and maximum amount of total local storage, in GB.default InstanceRequirements.Builder
vCpuCount(Consumer<VCpuCountRange.Builder> vCpuCount)
The minimum and maximum number of vCPUs.InstanceRequirements.Builder
vCpuCount(VCpuCountRange vCpuCount)
The minimum and maximum number of vCPUs.-
Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
-
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
-
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
-
-
-
Method Detail
-
vCpuCount
InstanceRequirements.Builder vCpuCount(VCpuCountRange vCpuCount)
The minimum and maximum number of vCPUs.
- Parameters:
vCpuCount
- The minimum and maximum number of vCPUs.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
vCpuCount
default InstanceRequirements.Builder vCpuCount(Consumer<VCpuCountRange.Builder> vCpuCount)
The minimum and maximum number of vCPUs.
This is a convenience method that creates an instance of theVCpuCountRange.Builder
avoiding the need to create one manually viaVCpuCountRange.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tovCpuCount(VCpuCountRange)
.- Parameters:
vCpuCount
- a consumer that will call methods onVCpuCountRange.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
vCpuCount(VCpuCountRange)
-
memoryMiB
InstanceRequirements.Builder memoryMiB(MemoryMiB memoryMiB)
The minimum and maximum amount of memory, in MiB.
- Parameters:
memoryMiB
- The minimum and maximum amount of memory, in MiB.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
memoryMiB
default InstanceRequirements.Builder memoryMiB(Consumer<MemoryMiB.Builder> memoryMiB)
The minimum and maximum amount of memory, in MiB.
This is a convenience method that creates an instance of theMemoryMiB.Builder
avoiding the need to create one manually viaMemoryMiB.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tomemoryMiB(MemoryMiB)
.- Parameters:
memoryMiB
- a consumer that will call methods onMemoryMiB.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
memoryMiB(MemoryMiB)
-
cpuManufacturersWithStrings
InstanceRequirements.Builder cpuManufacturersWithStrings(Collection<String> cpuManufacturers)
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
.
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.
Default: Any manufacturer
- Parameters:
cpuManufacturers
- 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
.
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.
Default: Any manufacturer
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
cpuManufacturersWithStrings
InstanceRequirements.Builder cpuManufacturersWithStrings(String... cpuManufacturers)
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
.
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.
Default: Any manufacturer
- Parameters:
cpuManufacturers
- 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
.
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.
Default: Any manufacturer
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
cpuManufacturers
InstanceRequirements.Builder cpuManufacturers(Collection<CpuManufacturer> cpuManufacturers)
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
.
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.
Default: Any manufacturer
- Parameters:
cpuManufacturers
- 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
.
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.
Default: Any manufacturer
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
cpuManufacturers
InstanceRequirements.Builder cpuManufacturers(CpuManufacturer... cpuManufacturers)
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
.
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.
Default: Any manufacturer
- Parameters:
cpuManufacturers
- 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
.
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.
Default: Any manufacturer
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
memoryGiBPerVCpu
InstanceRequirements.Builder memoryGiBPerVCpu(MemoryGiBPerVCpu memoryGiBPerVCpu)
The minimum and maximum amount of memory per vCPU, in GiB.
Default: No minimum or maximum limits
- Parameters:
memoryGiBPerVCpu
- The minimum and maximum amount of memory per vCPU, in GiB.Default: No minimum or maximum limits
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
memoryGiBPerVCpu
default InstanceRequirements.Builder memoryGiBPerVCpu(Consumer<MemoryGiBPerVCpu.Builder> memoryGiBPerVCpu)
The minimum and maximum amount of memory per vCPU, in GiB.
Default: No minimum or maximum limits
This is a convenience method that creates an instance of theMemoryGiBPerVCpu.Builder
avoiding the need to create one manually viaMemoryGiBPerVCpu.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tomemoryGiBPerVCpu(MemoryGiBPerVCpu)
.- Parameters:
memoryGiBPerVCpu
- a consumer that will call methods onMemoryGiBPerVCpu.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
memoryGiBPerVCpu(MemoryGiBPerVCpu)
-
excludedInstanceTypes
InstanceRequirements.Builder excludedInstanceTypes(Collection<String> excludedInstanceTypes)
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 specifym5a.*
, Amazon EC2 will exclude all the M5a instance types, but not the M5n instance types.If you specify
ExcludedInstanceTypes
, you can't specifyAllowedInstanceTypes
.Default: No excluded instance types
- Parameters:
excludedInstanceTypes
- 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 specifym5a.*
, Amazon EC2 will exclude all the M5a instance types, but not the M5n instance types.If you specify
ExcludedInstanceTypes
, you can't specifyAllowedInstanceTypes
.Default: No excluded instance types
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
excludedInstanceTypes
InstanceRequirements.Builder excludedInstanceTypes(String... excludedInstanceTypes)
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 specifym5a.*
, Amazon EC2 will exclude all the M5a instance types, but not the M5n instance types.If you specify
ExcludedInstanceTypes
, you can't specifyAllowedInstanceTypes
.Default: No excluded instance types
- Parameters:
excludedInstanceTypes
- 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 specifym5a.*
, Amazon EC2 will exclude all the M5a instance types, but not the M5n instance types.If you specify
ExcludedInstanceTypes
, you can't specifyAllowedInstanceTypes
.Default: No excluded instance types
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
instanceGenerationsWithStrings
InstanceRequirements.Builder instanceGenerationsWithStrings(Collection<String> instanceGenerations)
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
- Parameters:
instanceGenerations
- 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
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
instanceGenerationsWithStrings
InstanceRequirements.Builder instanceGenerationsWithStrings(String... instanceGenerations)
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
- Parameters:
instanceGenerations
- 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
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
instanceGenerations
InstanceRequirements.Builder instanceGenerations(Collection<InstanceGeneration> instanceGenerations)
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
- Parameters:
instanceGenerations
- 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
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
instanceGenerations
InstanceRequirements.Builder instanceGenerations(InstanceGeneration... instanceGenerations)
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
- Parameters:
instanceGenerations
- 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
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
spotMaxPricePercentageOverLowestPrice
InstanceRequirements.Builder spotMaxPricePercentageOverLowestPrice(Integer spotMaxPricePercentageOverLowestPrice)
[Price protection] The price protection threshold for Spot Instances, as a percentage higher than an identified Spot price. The identified Spot price is the Spot 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 Spot price is from the lowest priced current generation instance types, and failing that, from the lowest priced previous generation instance types that match your attributes. When Amazon EC2 selects instance types with your attributes, it will exclude instance types whose Spot price exceeds your specified threshold.
The parameter accepts an integer, which Amazon EC2 interprets as a percentage.
If you set
TargetCapacityUnitType
tovcpu
ormemory-mib
, the price protection threshold is applied based on the per-vCPU or per-memory price instead of the per-instance price.This parameter is not supported for GetSpotPlacementScores and GetInstanceTypesFromInstanceRequirements.
Only one of
SpotMaxPricePercentageOverLowestPrice
orMaxSpotPriceAsPercentageOfOptimalOnDemandPrice
can be specified. If you don't specify either, Amazon EC2 will automatically apply optimal price protection to consistently select from a wide range of instance types. To indicate no price protection threshold for Spot Instances, meaning you want to consider all instance types that match your attributes, include one of these parameters and specify a high value, such as999999
.Default:
100
- Parameters:
spotMaxPricePercentageOverLowestPrice
- [Price protection] The price protection threshold for Spot Instances, as a percentage higher than an identified Spot price. The identified Spot price is the Spot 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 Spot price is from the lowest priced current generation instance types, and failing that, from the lowest priced previous generation instance types that match your attributes. When Amazon EC2 selects instance types with your attributes, it will exclude instance types whose Spot price exceeds your specified threshold.The parameter accepts an integer, which Amazon EC2 interprets as a percentage.
If you set
TargetCapacityUnitType
tovcpu
ormemory-mib
, the price protection threshold is applied based on the per-vCPU or per-memory price instead of the per-instance price.This parameter is not supported for GetSpotPlacementScores and GetInstanceTypesFromInstanceRequirements.
Only one of
SpotMaxPricePercentageOverLowestPrice
orMaxSpotPriceAsPercentageOfOptimalOnDemandPrice
can be specified. If you don't specify either, Amazon EC2 will automatically apply optimal price protection to consistently select from a wide range of instance types. To indicate no price protection threshold for Spot Instances, meaning you want to consider all instance types that match your attributes, include one of these parameters and specify a high value, such as999999
.Default:
100
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
onDemandMaxPricePercentageOverLowestPrice
InstanceRequirements.Builder onDemandMaxPricePercentageOverLowestPrice(Integer onDemandMaxPricePercentageOverLowestPrice)
[Price protection] 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. When Amazon EC2 selects instance types with your attributes, it will exclude instance types whose price exceeds your specified 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.
If you set
TargetCapacityUnitType
tovcpu
ormemory-mib
, the price protection threshold is applied based on the per-vCPU or per-memory price instead of the per-instance price.Default:
20
- Parameters:
onDemandMaxPricePercentageOverLowestPrice
- [Price protection] 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. When Amazon EC2 selects instance types with your attributes, it will exclude instance types whose price exceeds your specified 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.
If you set
TargetCapacityUnitType
tovcpu
ormemory-mib
, the price protection threshold is applied based on the per-vCPU or per-memory price instead of the per-instance price.Default:
20
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
bareMetal
InstanceRequirements.Builder bareMetal(String bareMetal)
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
- Parameters:
bareMetal
- 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:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
BareMetal
,BareMetal
-
-
bareMetal
InstanceRequirements.Builder bareMetal(BareMetal bareMetal)
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
- Parameters:
bareMetal
- 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:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
BareMetal
,BareMetal
-
-
burstablePerformance
InstanceRequirements.Builder burstablePerformance(String burstablePerformance)
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
- Parameters:
burstablePerformance
- 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
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
BurstablePerformance
,BurstablePerformance
-
-
burstablePerformance
InstanceRequirements.Builder burstablePerformance(BurstablePerformance burstablePerformance)
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
- Parameters:
burstablePerformance
- 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
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
BurstablePerformance
,BurstablePerformance
-
-
requireHibernateSupport
InstanceRequirements.Builder requireHibernateSupport(Boolean requireHibernateSupport)
Indicates whether instance types must support hibernation for On-Demand Instances.
This parameter is not supported for GetSpotPlacementScores.
Default:
false
- Parameters:
requireHibernateSupport
- Indicates whether instance types must support hibernation for On-Demand Instances.This parameter is not supported for GetSpotPlacementScores.
Default:
false
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
networkInterfaceCount
InstanceRequirements.Builder networkInterfaceCount(NetworkInterfaceCount networkInterfaceCount)
The minimum and maximum number of network interfaces.
Default: No minimum or maximum limits
- Parameters:
networkInterfaceCount
- The minimum and maximum number of network interfaces.Default: No minimum or maximum limits
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
networkInterfaceCount
default InstanceRequirements.Builder networkInterfaceCount(Consumer<NetworkInterfaceCount.Builder> networkInterfaceCount)
The minimum and maximum number of network interfaces.
Default: No minimum or maximum limits
This is a convenience method that creates an instance of theNetworkInterfaceCount.Builder
avoiding the need to create one manually viaNetworkInterfaceCount.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tonetworkInterfaceCount(NetworkInterfaceCount)
.- Parameters:
networkInterfaceCount
- a consumer that will call methods onNetworkInterfaceCount.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
networkInterfaceCount(NetworkInterfaceCount)
-
localStorage
InstanceRequirements.Builder localStorage(String localStorage)
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
- Parameters:
localStorage
- 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
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
LocalStorage
,LocalStorage
-
-
localStorage
InstanceRequirements.Builder localStorage(LocalStorage localStorage)
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
- Parameters:
localStorage
- 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
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
LocalStorage
,LocalStorage
-
-
localStorageTypesWithStrings
InstanceRequirements.Builder localStorageTypesWithStrings(Collection<String> localStorageTypes)
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
andssd
- Parameters:
localStorageTypes
- 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
andssd
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
localStorageTypesWithStrings
InstanceRequirements.Builder localStorageTypesWithStrings(String... localStorageTypes)
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
andssd
- Parameters:
localStorageTypes
- 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
andssd
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
localStorageTypes
InstanceRequirements.Builder localStorageTypes(Collection<LocalStorageType> localStorageTypes)
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
andssd
- Parameters:
localStorageTypes
- 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
andssd
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
localStorageTypes
InstanceRequirements.Builder localStorageTypes(LocalStorageType... localStorageTypes)
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
andssd
- Parameters:
localStorageTypes
- 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
andssd
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
totalLocalStorageGB
InstanceRequirements.Builder totalLocalStorageGB(TotalLocalStorageGB totalLocalStorageGB)
The minimum and maximum amount of total local storage, in GB.
Default: No minimum or maximum limits
- Parameters:
totalLocalStorageGB
- The minimum and maximum amount of total local storage, in GB.Default: No minimum or maximum limits
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
totalLocalStorageGB
default InstanceRequirements.Builder totalLocalStorageGB(Consumer<TotalLocalStorageGB.Builder> totalLocalStorageGB)
The minimum and maximum amount of total local storage, in GB.
Default: No minimum or maximum limits
This is a convenience method that creates an instance of theTotalLocalStorageGB.Builder
avoiding the need to create one manually viaTotalLocalStorageGB.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tototalLocalStorageGB(TotalLocalStorageGB)
.- Parameters:
totalLocalStorageGB
- a consumer that will call methods onTotalLocalStorageGB.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
totalLocalStorageGB(TotalLocalStorageGB)
-
baselineEbsBandwidthMbps
InstanceRequirements.Builder baselineEbsBandwidthMbps(BaselineEbsBandwidthMbps 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
- Parameters:
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
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
baselineEbsBandwidthMbps
default InstanceRequirements.Builder baselineEbsBandwidthMbps(Consumer<BaselineEbsBandwidthMbps.Builder> 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
This is a convenience method that creates an instance of theBaselineEbsBandwidthMbps.Builder
avoiding the need to create one manually viaBaselineEbsBandwidthMbps.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tobaselineEbsBandwidthMbps(BaselineEbsBandwidthMbps)
.- Parameters:
baselineEbsBandwidthMbps
- a consumer that will call methods onBaselineEbsBandwidthMbps.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
baselineEbsBandwidthMbps(BaselineEbsBandwidthMbps)
-
acceleratorTypesWithStrings
InstanceRequirements.Builder acceleratorTypesWithStrings(Collection<String> acceleratorTypes)
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
- Parameters:
acceleratorTypes
- 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:
- Returns a reference to this object so that method calls can be chained together.
-
-
acceleratorTypesWithStrings
InstanceRequirements.Builder acceleratorTypesWithStrings(String... acceleratorTypes)
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
- Parameters:
acceleratorTypes
- 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:
- Returns a reference to this object so that method calls can be chained together.
-
-
acceleratorTypes
InstanceRequirements.Builder acceleratorTypes(Collection<AcceleratorType> acceleratorTypes)
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
- Parameters:
acceleratorTypes
- 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:
- Returns a reference to this object so that method calls can be chained together.
-
-
acceleratorTypes
InstanceRequirements.Builder acceleratorTypes(AcceleratorType... acceleratorTypes)
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
- Parameters:
acceleratorTypes
- 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:
- Returns a reference to this object so that method calls can be chained together.
-
-
acceleratorCount
InstanceRequirements.Builder acceleratorCount(AcceleratorCount 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
to0
.Default: No minimum or maximum limits
- Parameters:
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
to0
.Default: No minimum or maximum limits
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
acceleratorCount
default InstanceRequirements.Builder acceleratorCount(Consumer<AcceleratorCount.Builder> 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
to0
.Default: No minimum or maximum limits
This is a convenience method that creates an instance of theAcceleratorCount.Builder
avoiding the need to create one manually viaAcceleratorCount.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toacceleratorCount(AcceleratorCount)
.- Parameters:
acceleratorCount
- a consumer that will call methods onAcceleratorCount.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
acceleratorCount(AcceleratorCount)
-
acceleratorManufacturersWithStrings
InstanceRequirements.Builder acceleratorManufacturersWithStrings(Collection<String> acceleratorManufacturers)
Indicates whether instance types must have accelerators by specific manufacturers.
-
For instance types with Amazon Web Services devices, specify
amazon-web-services
. -
For instance types with AMD devices, specify
amd
. -
For instance types with Habana devices, specify
habana
. -
For instance types with NVIDIA devices, specify
nvidia
. -
For instance types with Xilinx devices, specify
xilinx
.
Default: Any manufacturer
- Parameters:
acceleratorManufacturers
- Indicates whether instance types must have accelerators by specific manufacturers.-
For instance types with Amazon Web Services devices, specify
amazon-web-services
. -
For instance types with AMD devices, specify
amd
. -
For instance types with Habana devices, specify
habana
. -
For instance types with NVIDIA devices, specify
nvidia
. -
For instance types with Xilinx devices, specify
xilinx
.
Default: Any manufacturer
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
acceleratorManufacturersWithStrings
InstanceRequirements.Builder acceleratorManufacturersWithStrings(String... acceleratorManufacturers)
Indicates whether instance types must have accelerators by specific manufacturers.
-
For instance types with Amazon Web Services devices, specify
amazon-web-services
. -
For instance types with AMD devices, specify
amd
. -
For instance types with Habana devices, specify
habana
. -
For instance types with NVIDIA devices, specify
nvidia
. -
For instance types with Xilinx devices, specify
xilinx
.
Default: Any manufacturer
- Parameters:
acceleratorManufacturers
- Indicates whether instance types must have accelerators by specific manufacturers.-
For instance types with Amazon Web Services devices, specify
amazon-web-services
. -
For instance types with AMD devices, specify
amd
. -
For instance types with Habana devices, specify
habana
. -
For instance types with NVIDIA devices, specify
nvidia
. -
For instance types with Xilinx devices, specify
xilinx
.
Default: Any manufacturer
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
acceleratorManufacturers
InstanceRequirements.Builder acceleratorManufacturers(Collection<AcceleratorManufacturer> acceleratorManufacturers)
Indicates whether instance types must have accelerators by specific manufacturers.
-
For instance types with Amazon Web Services devices, specify
amazon-web-services
. -
For instance types with AMD devices, specify
amd
. -
For instance types with Habana devices, specify
habana
. -
For instance types with NVIDIA devices, specify
nvidia
. -
For instance types with Xilinx devices, specify
xilinx
.
Default: Any manufacturer
- Parameters:
acceleratorManufacturers
- Indicates whether instance types must have accelerators by specific manufacturers.-
For instance types with Amazon Web Services devices, specify
amazon-web-services
. -
For instance types with AMD devices, specify
amd
. -
For instance types with Habana devices, specify
habana
. -
For instance types with NVIDIA devices, specify
nvidia
. -
For instance types with Xilinx devices, specify
xilinx
.
Default: Any manufacturer
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
acceleratorManufacturers
InstanceRequirements.Builder acceleratorManufacturers(AcceleratorManufacturer... acceleratorManufacturers)
Indicates whether instance types must have accelerators by specific manufacturers.
-
For instance types with Amazon Web Services devices, specify
amazon-web-services
. -
For instance types with AMD devices, specify
amd
. -
For instance types with Habana devices, specify
habana
. -
For instance types with NVIDIA devices, specify
nvidia
. -
For instance types with Xilinx devices, specify
xilinx
.
Default: Any manufacturer
- Parameters:
acceleratorManufacturers
- Indicates whether instance types must have accelerators by specific manufacturers.-
For instance types with Amazon Web Services devices, specify
amazon-web-services
. -
For instance types with AMD devices, specify
amd
. -
For instance types with Habana devices, specify
habana
. -
For instance types with NVIDIA devices, specify
nvidia
. -
For instance types with Xilinx devices, specify
xilinx
.
Default: Any manufacturer
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
acceleratorNamesWithStrings
InstanceRequirements.Builder acceleratorNamesWithStrings(Collection<String> acceleratorNames)
The accelerators that must be on the instance type.
-
For instance types with NVIDIA A10G GPUs, specify
a10g
. -
For instance types with NVIDIA A100 GPUs, specify
a100
. -
For instance types with NVIDIA H100 GPUs, specify
h100
. -
For instance types with Amazon Web Services Inferentia chips, specify
inferentia
. -
For instance types with NVIDIA GRID K520 GPUs, specify
k520
. -
For instance types with NVIDIA K80 GPUs, specify
k80
. -
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 NVIDIA T4 GPUs, specify
t4
. -
For instance types with NVIDIA T4G GPUs, specify
t4g
. -
For instance types with Xilinx VU9P FPGAs, specify
vu9p
. -
For instance types with NVIDIA V100 GPUs, specify
v100
.
Default: Any accelerator
- Parameters:
acceleratorNames
- The accelerators that must be on the instance type.-
For instance types with NVIDIA A10G GPUs, specify
a10g
. -
For instance types with NVIDIA A100 GPUs, specify
a100
. -
For instance types with NVIDIA H100 GPUs, specify
h100
. -
For instance types with Amazon Web Services Inferentia chips, specify
inferentia
. -
For instance types with NVIDIA GRID K520 GPUs, specify
k520
. -
For instance types with NVIDIA K80 GPUs, specify
k80
. -
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 NVIDIA T4 GPUs, specify
t4
. -
For instance types with NVIDIA T4G GPUs, specify
t4g
. -
For instance types with Xilinx VU9P FPGAs, specify
vu9p
. -
For instance types with NVIDIA V100 GPUs, specify
v100
.
Default: Any accelerator
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
acceleratorNamesWithStrings
InstanceRequirements.Builder acceleratorNamesWithStrings(String... acceleratorNames)
The accelerators that must be on the instance type.
-
For instance types with NVIDIA A10G GPUs, specify
a10g
. -
For instance types with NVIDIA A100 GPUs, specify
a100
. -
For instance types with NVIDIA H100 GPUs, specify
h100
. -
For instance types with Amazon Web Services Inferentia chips, specify
inferentia
. -
For instance types with NVIDIA GRID K520 GPUs, specify
k520
. -
For instance types with NVIDIA K80 GPUs, specify
k80
. -
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 NVIDIA T4 GPUs, specify
t4
. -
For instance types with NVIDIA T4G GPUs, specify
t4g
. -
For instance types with Xilinx VU9P FPGAs, specify
vu9p
. -
For instance types with NVIDIA V100 GPUs, specify
v100
.
Default: Any accelerator
- Parameters:
acceleratorNames
- The accelerators that must be on the instance type.-
For instance types with NVIDIA A10G GPUs, specify
a10g
. -
For instance types with NVIDIA A100 GPUs, specify
a100
. -
For instance types with NVIDIA H100 GPUs, specify
h100
. -
For instance types with Amazon Web Services Inferentia chips, specify
inferentia
. -
For instance types with NVIDIA GRID K520 GPUs, specify
k520
. -
For instance types with NVIDIA K80 GPUs, specify
k80
. -
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 NVIDIA T4 GPUs, specify
t4
. -
For instance types with NVIDIA T4G GPUs, specify
t4g
. -
For instance types with Xilinx VU9P FPGAs, specify
vu9p
. -
For instance types with NVIDIA V100 GPUs, specify
v100
.
Default: Any accelerator
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
acceleratorNames
InstanceRequirements.Builder acceleratorNames(Collection<AcceleratorName> acceleratorNames)
The accelerators that must be on the instance type.
-
For instance types with NVIDIA A10G GPUs, specify
a10g
. -
For instance types with NVIDIA A100 GPUs, specify
a100
. -
For instance types with NVIDIA H100 GPUs, specify
h100
. -
For instance types with Amazon Web Services Inferentia chips, specify
inferentia
. -
For instance types with NVIDIA GRID K520 GPUs, specify
k520
. -
For instance types with NVIDIA K80 GPUs, specify
k80
. -
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 NVIDIA T4 GPUs, specify
t4
. -
For instance types with NVIDIA T4G GPUs, specify
t4g
. -
For instance types with Xilinx VU9P FPGAs, specify
vu9p
. -
For instance types with NVIDIA V100 GPUs, specify
v100
.
Default: Any accelerator
- Parameters:
acceleratorNames
- The accelerators that must be on the instance type.-
For instance types with NVIDIA A10G GPUs, specify
a10g
. -
For instance types with NVIDIA A100 GPUs, specify
a100
. -
For instance types with NVIDIA H100 GPUs, specify
h100
. -
For instance types with Amazon Web Services Inferentia chips, specify
inferentia
. -
For instance types with NVIDIA GRID K520 GPUs, specify
k520
. -
For instance types with NVIDIA K80 GPUs, specify
k80
. -
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 NVIDIA T4 GPUs, specify
t4
. -
For instance types with NVIDIA T4G GPUs, specify
t4g
. -
For instance types with Xilinx VU9P FPGAs, specify
vu9p
. -
For instance types with NVIDIA V100 GPUs, specify
v100
.
Default: Any accelerator
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
acceleratorNames
InstanceRequirements.Builder acceleratorNames(AcceleratorName... acceleratorNames)
The accelerators that must be on the instance type.
-
For instance types with NVIDIA A10G GPUs, specify
a10g
. -
For instance types with NVIDIA A100 GPUs, specify
a100
. -
For instance types with NVIDIA H100 GPUs, specify
h100
. -
For instance types with Amazon Web Services Inferentia chips, specify
inferentia
. -
For instance types with NVIDIA GRID K520 GPUs, specify
k520
. -
For instance types with NVIDIA K80 GPUs, specify
k80
. -
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 NVIDIA T4 GPUs, specify
t4
. -
For instance types with NVIDIA T4G GPUs, specify
t4g
. -
For instance types with Xilinx VU9P FPGAs, specify
vu9p
. -
For instance types with NVIDIA V100 GPUs, specify
v100
.
Default: Any accelerator
- Parameters:
acceleratorNames
- The accelerators that must be on the instance type.-
For instance types with NVIDIA A10G GPUs, specify
a10g
. -
For instance types with NVIDIA A100 GPUs, specify
a100
. -
For instance types with NVIDIA H100 GPUs, specify
h100
. -
For instance types with Amazon Web Services Inferentia chips, specify
inferentia
. -
For instance types with NVIDIA GRID K520 GPUs, specify
k520
. -
For instance types with NVIDIA K80 GPUs, specify
k80
. -
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 NVIDIA T4 GPUs, specify
t4
. -
For instance types with NVIDIA T4G GPUs, specify
t4g
. -
For instance types with Xilinx VU9P FPGAs, specify
vu9p
. -
For instance types with NVIDIA V100 GPUs, specify
v100
.
Default: Any accelerator
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
acceleratorTotalMemoryMiB
InstanceRequirements.Builder acceleratorTotalMemoryMiB(AcceleratorTotalMemoryMiB acceleratorTotalMemoryMiB)
The minimum and maximum amount of total accelerator memory, in MiB.
Default: No minimum or maximum limits
- Parameters:
acceleratorTotalMemoryMiB
- The minimum and maximum amount of total accelerator memory, in MiB.Default: No minimum or maximum limits
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
acceleratorTotalMemoryMiB
default InstanceRequirements.Builder acceleratorTotalMemoryMiB(Consumer<AcceleratorTotalMemoryMiB.Builder> acceleratorTotalMemoryMiB)
The minimum and maximum amount of total accelerator memory, in MiB.
Default: No minimum or maximum limits
This is a convenience method that creates an instance of theAcceleratorTotalMemoryMiB.Builder
avoiding the need to create one manually viaAcceleratorTotalMemoryMiB.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toacceleratorTotalMemoryMiB(AcceleratorTotalMemoryMiB)
.- Parameters:
acceleratorTotalMemoryMiB
- a consumer that will call methods onAcceleratorTotalMemoryMiB.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
acceleratorTotalMemoryMiB(AcceleratorTotalMemoryMiB)
-
networkBandwidthGbps
InstanceRequirements.Builder networkBandwidthGbps(NetworkBandwidthGbps networkBandwidthGbps)
The minimum and maximum amount of network bandwidth, in gigabits per second (Gbps).
Default: No minimum or maximum limits
- Parameters:
networkBandwidthGbps
- The minimum and maximum amount of network bandwidth, in gigabits per second (Gbps).Default: No minimum or maximum limits
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
networkBandwidthGbps
default InstanceRequirements.Builder networkBandwidthGbps(Consumer<NetworkBandwidthGbps.Builder> networkBandwidthGbps)
The minimum and maximum amount of network bandwidth, in gigabits per second (Gbps).
Default: No minimum or maximum limits
This is a convenience method that creates an instance of theNetworkBandwidthGbps.Builder
avoiding the need to create one manually viaNetworkBandwidthGbps.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tonetworkBandwidthGbps(NetworkBandwidthGbps)
.- Parameters:
networkBandwidthGbps
- a consumer that will call methods onNetworkBandwidthGbps.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
networkBandwidthGbps(NetworkBandwidthGbps)
-
allowedInstanceTypes
InstanceRequirements.Builder allowedInstanceTypes(Collection<String> allowedInstanceTypes)
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 specifym5a.*
, Amazon EC2 will allow all the M5a instance types, but not the M5n instance types.If you specify
AllowedInstanceTypes
, you can't specifyExcludedInstanceTypes
.Default: All instance types
- Parameters:
allowedInstanceTypes
- 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 specifym5a.*
, Amazon EC2 will allow all the M5a instance types, but not the M5n instance types.If you specify
AllowedInstanceTypes
, you can't specifyExcludedInstanceTypes
.Default: All instance types
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
allowedInstanceTypes
InstanceRequirements.Builder allowedInstanceTypes(String... allowedInstanceTypes)
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 specifym5a.*
, Amazon EC2 will allow all the M5a instance types, but not the M5n instance types.If you specify
AllowedInstanceTypes
, you can't specifyExcludedInstanceTypes
.Default: All instance types
- Parameters:
allowedInstanceTypes
- 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 specifym5a.*
, Amazon EC2 will allow all the M5a instance types, but not the M5n instance types.If you specify
AllowedInstanceTypes
, you can't specifyExcludedInstanceTypes
.Default: All instance types
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
maxSpotPriceAsPercentageOfOptimalOnDemandPrice
InstanceRequirements.Builder maxSpotPriceAsPercentageOfOptimalOnDemandPrice(Integer maxSpotPriceAsPercentageOfOptimalOnDemandPrice)
[Price protection] The price protection threshold for Spot Instances, as a percentage of 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 the lowest priced current generation instance types, and failing that, from the lowest priced previous generation instance types that match your attributes. When Amazon EC2 selects instance types with your attributes, it will exclude instance types whose price exceeds your specified threshold.
The parameter accepts an integer, which Amazon EC2 interprets as a percentage.
If you set
DesiredCapacityType
tovcpu
ormemory-mib
, the price protection threshold is based on the per vCPU or per memory price instead of the per instance price.Only one of
SpotMaxPricePercentageOverLowestPrice
orMaxSpotPriceAsPercentageOfOptimalOnDemandPrice
can be specified. If you don't specify either, Amazon EC2 will automatically apply optimal price protection to consistently select from a wide range of instance types. To indicate no price protection threshold for Spot Instances, meaning you want to consider all instance types that match your attributes, include one of these parameters and specify a high value, such as999999
.- Parameters:
maxSpotPriceAsPercentageOfOptimalOnDemandPrice
- [Price protection] The price protection threshold for Spot Instances, as a percentage of 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 the lowest priced current generation instance types, and failing that, from the lowest priced previous generation instance types that match your attributes. When Amazon EC2 selects instance types with your attributes, it will exclude instance types whose price exceeds your specified threshold.The parameter accepts an integer, which Amazon EC2 interprets as a percentage.
If you set
DesiredCapacityType
tovcpu
ormemory-mib
, the price protection threshold is based on the per vCPU or per memory price instead of the per instance price.Only one of
SpotMaxPricePercentageOverLowestPrice
orMaxSpotPriceAsPercentageOfOptimalOnDemandPrice
can be specified. If you don't specify either, Amazon EC2 will automatically apply optimal price protection to consistently select from a wide range of instance types. To indicate no price protection threshold for Spot Instances, meaning you want to consider all instance types that match your attributes, include one of these parameters and specify a high value, such as999999
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-