Package software.amazon.awssdk.services.ecs.model

Interface InstanceRequirementsRequest.Builder

    • Method Detail

      • vCpuCount

        InstanceRequirementsRequest.Builder vCpuCount​(VCpuCountRangeRequest vCpuCount)

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

        Parameters:
        vCpuCount - The minimum and maximum number of vCPUs for the instance types. Amazon ECS selects instance types that have vCPU counts within this range.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • memoryMiB

        InstanceRequirementsRequest.Builder memoryMiB​(MemoryMiBRequest memoryMiB)

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

        Parameters:
        memoryMiB - The minimum and maximum amount of memory in mebibytes (MiB) for the instance types. Amazon ECS selects instance types that have memory within this range.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • cpuManufacturersWithStrings

        InstanceRequirementsRequest.Builder cpuManufacturersWithStrings​(Collection<String> cpuManufacturers)

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

        Parameters:
        cpuManufacturers - The CPU manufacturers to include or exclude. You can specify intel, amd, or amazon-web-services to control which CPU types are used for your workloads.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • cpuManufacturersWithStrings

        InstanceRequirementsRequest.Builder cpuManufacturersWithStrings​(String... cpuManufacturers)

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

        Parameters:
        cpuManufacturers - The CPU manufacturers to include or exclude. You can specify intel, amd, or amazon-web-services to control which CPU types are used for your workloads.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • cpuManufacturers

        InstanceRequirementsRequest.Builder cpuManufacturers​(Collection<CpuManufacturer> cpuManufacturers)

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

        Parameters:
        cpuManufacturers - The CPU manufacturers to include or exclude. You can specify intel, amd, or amazon-web-services to control which CPU types are used for your workloads.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • cpuManufacturers

        InstanceRequirementsRequest.Builder cpuManufacturers​(CpuManufacturer... cpuManufacturers)

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

        Parameters:
        cpuManufacturers - The CPU manufacturers to include or exclude. You can specify intel, amd, or amazon-web-services to control which CPU types are used for your workloads.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • memoryGiBPerVCpu

        InstanceRequirementsRequest.Builder memoryGiBPerVCpu​(MemoryGiBPerVCpuRequest memoryGiBPerVCpu)

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

        Parameters:
        memoryGiBPerVCpu - The minimum and maximum amount of memory per vCPU in gibibytes (GiB). This helps ensure that instance types have the appropriate memory-to-CPU ratio for your workloads.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • excludedInstanceTypes

        InstanceRequirementsRequest.Builder excludedInstanceTypes​(Collection<String> excludedInstanceTypes)

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

        Parameters:
        excludedInstanceTypes - The instance types to exclude from selection. Use this to prevent Amazon ECS from selecting specific instance types that may not be suitable for your workloads.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • excludedInstanceTypes

        InstanceRequirementsRequest.Builder excludedInstanceTypes​(String... excludedInstanceTypes)

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

        Parameters:
        excludedInstanceTypes - The instance types to exclude from selection. Use this to prevent Amazon ECS from selecting specific instance types that may not be suitable for your workloads.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • instanceGenerationsWithStrings

        InstanceRequirementsRequest.Builder instanceGenerationsWithStrings​(Collection<String> instanceGenerations)

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

        Parameters:
        instanceGenerations - The instance generations to include. You can specify current to use the latest generation instances, or previous to include previous generation instances for cost optimization.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • instanceGenerationsWithStrings

        InstanceRequirementsRequest.Builder instanceGenerationsWithStrings​(String... instanceGenerations)

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

        Parameters:
        instanceGenerations - The instance generations to include. You can specify current to use the latest generation instances, or previous to include previous generation instances for cost optimization.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • instanceGenerations

        InstanceRequirementsRequest.Builder instanceGenerations​(Collection<InstanceGeneration> instanceGenerations)

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

        Parameters:
        instanceGenerations - The instance generations to include. You can specify current to use the latest generation instances, or previous to include previous generation instances for cost optimization.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • instanceGenerations

        InstanceRequirementsRequest.Builder instanceGenerations​(InstanceGeneration... instanceGenerations)

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

        Parameters:
        instanceGenerations - The instance generations to include. You can specify current to use the latest generation instances, or previous to include previous generation instances for cost optimization.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • spotMaxPricePercentageOverLowestPrice

        InstanceRequirementsRequest.Builder spotMaxPricePercentageOverLowestPrice​(Integer spotMaxPricePercentageOverLowestPrice)

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

        Parameters:
        spotMaxPricePercentageOverLowestPrice - The maximum price for Spot instances as a percentage over the lowest priced On-Demand instance. This helps control Spot instance costs while maintaining access to capacity.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • onDemandMaxPricePercentageOverLowestPrice

        InstanceRequirementsRequest.Builder onDemandMaxPricePercentageOverLowestPrice​(Integer onDemandMaxPricePercentageOverLowestPrice)

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

        Parameters:
        onDemandMaxPricePercentageOverLowestPrice - The price protection threshold for On-Demand Instances, as a percentage higher than an identified On-Demand price. The identified On-Demand price is the price of the lowest priced current generation C, M, or R instance type with your specified attributes. If no current generation C, M, or R instance type matches your attributes, then the identified price is from either the lowest priced current generation instance types or, failing that, the lowest priced previous generation instance types that match your attributes. When Amazon ECS selects instance types with your attributes, we will exclude instance types whose price exceeds your specified threshold.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • bareMetal

        InstanceRequirementsRequest.Builder bareMetal​(String bareMetal)

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

        Parameters:
        bareMetal - Indicates whether to include bare metal instance types. Set to included to allow bare metal instances, excluded to exclude them, or required to use only bare metal instances.
        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        BareMetal, BareMetal

      • bareMetal

        InstanceRequirementsRequest.Builder bareMetal​(BareMetal bareMetal)

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

        Parameters:
        bareMetal - Indicates whether to include bare metal instance types. Set to included to allow bare metal instances, excluded to exclude them, or required to use only bare metal instances.
        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        BareMetal, BareMetal

      • burstablePerformance

        InstanceRequirementsRequest.Builder burstablePerformance​(String burstablePerformance)

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

        Parameters:
        burstablePerformance - Indicates whether to include burstable performance instance types (T2, T3, T3a, T4g). Set to included to allow burstable instances, excluded to exclude them, or required to use only burstable instances.
        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        BurstablePerformance, BurstablePerformance

      • burstablePerformance

        InstanceRequirementsRequest.Builder burstablePerformance​(BurstablePerformance burstablePerformance)

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

        Parameters:
        burstablePerformance - Indicates whether to include burstable performance instance types (T2, T3, T3a, T4g). Set to included to allow burstable instances, excluded to exclude them, or required to use only burstable instances.
        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        BurstablePerformance, BurstablePerformance

      • requireHibernateSupport

        InstanceRequirementsRequest.Builder requireHibernateSupport​(Boolean requireHibernateSupport)

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

        Parameters:
        requireHibernateSupport - Indicates whether the instance types must support hibernation. When set to true, only instance types that support hibernation are selected.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • networkInterfaceCount

        InstanceRequirementsRequest.Builder networkInterfaceCount​(NetworkInterfaceCountRequest networkInterfaceCount)

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

        Parameters:
        networkInterfaceCount - The minimum and maximum number of network interfaces for the instance types. This is useful for workloads that require multiple network interfaces.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • localStorage

        InstanceRequirementsRequest.Builder localStorage​(String localStorage)

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

        Parameters:
        localStorage - Indicates whether to include instance types with local storage. Set to included to allow local storage, excluded to exclude it, or required to use only instances with local storage.
        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        LocalStorage, LocalStorage

      • localStorage

        InstanceRequirementsRequest.Builder localStorage​(LocalStorage localStorage)

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

        Parameters:
        localStorage - Indicates whether to include instance types with local storage. Set to included to allow local storage, excluded to exclude it, or required to use only instances with local storage.
        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        LocalStorage, LocalStorage

      • localStorageTypesWithStrings

        InstanceRequirementsRequest.Builder localStorageTypesWithStrings​(Collection<String> localStorageTypes)

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

        Parameters:
        localStorageTypes - The local storage types to include. You can specify hdd for hard disk drives, ssd for solid state drives, or both.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • localStorageTypesWithStrings

        InstanceRequirementsRequest.Builder localStorageTypesWithStrings​(String... localStorageTypes)

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

        Parameters:
        localStorageTypes - The local storage types to include. You can specify hdd for hard disk drives, ssd for solid state drives, or both.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • localStorageTypes

        InstanceRequirementsRequest.Builder localStorageTypes​(Collection<LocalStorageType> localStorageTypes)

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

        Parameters:
        localStorageTypes - The local storage types to include. You can specify hdd for hard disk drives, ssd for solid state drives, or both.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • localStorageTypes

        InstanceRequirementsRequest.Builder localStorageTypes​(LocalStorageType... localStorageTypes)

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

        Parameters:
        localStorageTypes - The local storage types to include. You can specify hdd for hard disk drives, ssd for solid state drives, or both.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • totalLocalStorageGB

        InstanceRequirementsRequest.Builder totalLocalStorageGB​(TotalLocalStorageGBRequest totalLocalStorageGB)

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

        Parameters:
        totalLocalStorageGB - The minimum and maximum total local storage in gigabytes (GB) for instance types with local storage.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • baselineEbsBandwidthMbps

        InstanceRequirementsRequest.Builder baselineEbsBandwidthMbps​(BaselineEbsBandwidthMbpsRequest baselineEbsBandwidthMbps)

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

        Parameters:
        baselineEbsBandwidthMbps - The minimum and maximum baseline Amazon EBS bandwidth in megabits per second (Mbps). This is important for workloads with high storage I/O requirements.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • acceleratorTypesWithStrings

        InstanceRequirementsRequest.Builder acceleratorTypesWithStrings​(Collection<String> acceleratorTypes)

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

        Parameters:
        acceleratorTypes - The accelerator types to include. You can specify gpu for graphics processing units, fpga for field programmable gate arrays, or inference for machine learning inference accelerators.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • acceleratorTypesWithStrings

        InstanceRequirementsRequest.Builder acceleratorTypesWithStrings​(String... acceleratorTypes)

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

        Parameters:
        acceleratorTypes - The accelerator types to include. You can specify gpu for graphics processing units, fpga for field programmable gate arrays, or inference for machine learning inference accelerators.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • acceleratorTypes

        InstanceRequirementsRequest.Builder acceleratorTypes​(Collection<AcceleratorType> acceleratorTypes)

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

        Parameters:
        acceleratorTypes - The accelerator types to include. You can specify gpu for graphics processing units, fpga for field programmable gate arrays, or inference for machine learning inference accelerators.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • acceleratorTypes

        InstanceRequirementsRequest.Builder acceleratorTypes​(AcceleratorType... acceleratorTypes)

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

        Parameters:
        acceleratorTypes - The accelerator types to include. You can specify gpu for graphics processing units, fpga for field programmable gate arrays, or inference for machine learning inference accelerators.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • acceleratorCount

        InstanceRequirementsRequest.Builder acceleratorCount​(AcceleratorCountRequest acceleratorCount)

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

        Parameters:
        acceleratorCount - The minimum and maximum number of accelerators for the instance types. This is used when you need instances with specific numbers of GPUs or other accelerators.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • acceleratorManufacturersWithStrings

        InstanceRequirementsRequest.Builder acceleratorManufacturersWithStrings​(Collection<String> acceleratorManufacturers)

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

        Parameters:
        acceleratorManufacturers - The accelerator manufacturers to include. You can specify nvidia, amd, amazon-web-services, or xilinx depending on your accelerator requirements.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • acceleratorManufacturersWithStrings

        InstanceRequirementsRequest.Builder acceleratorManufacturersWithStrings​(String... acceleratorManufacturers)

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

        Parameters:
        acceleratorManufacturers - The accelerator manufacturers to include. You can specify nvidia, amd, amazon-web-services, or xilinx depending on your accelerator requirements.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • acceleratorManufacturers

        InstanceRequirementsRequest.Builder acceleratorManufacturers​(Collection<AcceleratorManufacturer> acceleratorManufacturers)

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

        Parameters:
        acceleratorManufacturers - The accelerator manufacturers to include. You can specify nvidia, amd, amazon-web-services, or xilinx depending on your accelerator requirements.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • acceleratorManufacturers

        InstanceRequirementsRequest.Builder acceleratorManufacturers​(AcceleratorManufacturer... acceleratorManufacturers)

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

        Parameters:
        acceleratorManufacturers - The accelerator manufacturers to include. You can specify nvidia, amd, amazon-web-services, or xilinx depending on your accelerator requirements.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • acceleratorNamesWithStrings

        InstanceRequirementsRequest.Builder acceleratorNamesWithStrings​(Collection<String> acceleratorNames)

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

        Parameters:
        acceleratorNames - The specific accelerator names to include. For example, you can specify a100, v100, k80, or other specific accelerator models.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • acceleratorNamesWithStrings

        InstanceRequirementsRequest.Builder acceleratorNamesWithStrings​(String... acceleratorNames)

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

        Parameters:
        acceleratorNames - The specific accelerator names to include. For example, you can specify a100, v100, k80, or other specific accelerator models.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • acceleratorNames

        InstanceRequirementsRequest.Builder acceleratorNames​(Collection<AcceleratorName> acceleratorNames)

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

        Parameters:
        acceleratorNames - The specific accelerator names to include. For example, you can specify a100, v100, k80, or other specific accelerator models.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • acceleratorNames

        InstanceRequirementsRequest.Builder acceleratorNames​(AcceleratorName... acceleratorNames)

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

        Parameters:
        acceleratorNames - The specific accelerator names to include. For example, you can specify a100, v100, k80, or other specific accelerator models.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • acceleratorTotalMemoryMiB

        InstanceRequirementsRequest.Builder acceleratorTotalMemoryMiB​(AcceleratorTotalMemoryMiBRequest acceleratorTotalMemoryMiB)

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

        Parameters:
        acceleratorTotalMemoryMiB - The minimum and maximum total accelerator memory in mebibytes (MiB). This is important for GPU workloads that require specific amounts of video memory.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • networkBandwidthGbps

        InstanceRequirementsRequest.Builder networkBandwidthGbps​(NetworkBandwidthGbpsRequest networkBandwidthGbps)

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

        Parameters:
        networkBandwidthGbps - The minimum and maximum network bandwidth in gigabits per second (Gbps). This is crucial for network-intensive workloads that require high throughput.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • allowedInstanceTypes

        InstanceRequirementsRequest.Builder allowedInstanceTypes​(Collection<String> allowedInstanceTypes)

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

        Parameters:
        allowedInstanceTypes - The instance types to include in the selection. When specified, Amazon ECS only considers these instance types, subject to the other requirements specified.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • allowedInstanceTypes

        InstanceRequirementsRequest.Builder allowedInstanceTypes​(String... allowedInstanceTypes)

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

        Parameters:
        allowedInstanceTypes - The instance types to include in the selection. When specified, Amazon ECS only considers these instance types, subject to the other requirements specified.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • maxSpotPriceAsPercentageOfOptimalOnDemandPrice

        InstanceRequirementsRequest.Builder maxSpotPriceAsPercentageOfOptimalOnDemandPrice​(Integer maxSpotPriceAsPercentageOfOptimalOnDemandPrice)

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

        Parameters:
        maxSpotPriceAsPercentageOfOptimalOnDemandPrice - The maximum price for Spot instances as a percentage of the optimal On-Demand price. This provides more precise cost control for Spot instance selection.
        Returns:
        Returns a reference to this object so that method calls can be chained together.