This is the new *CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html). # AWS::EC2::EC2Fleet Specifies the configuration information to launch a fleet--or group--of instances. An EC2 Fleet can launch multiple instance types across multiple Availability Zones, using the On-Demand Instance, Reserved Instance, and Spot Instance purchasing models together. Using EC2 Fleet, you can define separate On-Demand and Spot capacity targets, specify the instance types that work best for your applications, and specify how Amazon EC2 should distribute your fleet capacity within each purchasing model. For more information, see [Launching an EC2 Fleet](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-fleet.html) in the *Amazon EC2 User Guide*. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "Type" : "AWS::EC2::EC2Fleet", "Properties" : { "[Context](#cfn-ec2-ec2fleet-context)" : String, "[ExcessCapacityTerminationPolicy](#cfn-ec2-ec2fleet-excesscapacityterminationpolicy)" : String, "[LaunchTemplateConfigs](#cfn-ec2-ec2fleet-launchtemplateconfigs)" : [ FleetLaunchTemplateConfigRequest, ... ], "[OnDemandOptions](#cfn-ec2-ec2fleet-ondemandoptions)" : OnDemandOptionsRequest, "[ReplaceUnhealthyInstances](#cfn-ec2-ec2fleet-replaceunhealthyinstances)" : Boolean, "[ReservedCapacityOptions](#cfn-ec2-ec2fleet-reservedcapacityoptions)" : ReservedCapacityOptionsRequest, "[SpotOptions](#cfn-ec2-ec2fleet-spotoptions)" : SpotOptionsRequest, "[TagSpecifications](#cfn-ec2-ec2fleet-tagspecifications)" : [ TagSpecification, ... ], "[TargetCapacitySpecification](#cfn-ec2-ec2fleet-targetcapacityspecification)" : TargetCapacitySpecificationRequest, "[TerminateInstancesWithExpiration](#cfn-ec2-ec2fleet-terminateinstanceswithexpiration)" : Boolean, "[Type](#cfn-ec2-ec2fleet-type)" : String, "[ValidFrom](#cfn-ec2-ec2fleet-validfrom)" : String, "[ValidUntil](#cfn-ec2-ec2fleet-validuntil)" : String } } ``` ### YAML ``` Type: AWS::EC2::EC2Fleet Properties: [Context](#cfn-ec2-ec2fleet-context): String [ExcessCapacityTerminationPolicy](#cfn-ec2-ec2fleet-excesscapacityterminationpolicy): String [LaunchTemplateConfigs](#cfn-ec2-ec2fleet-launchtemplateconfigs): - FleetLaunchTemplateConfigRequest [OnDemandOptions](#cfn-ec2-ec2fleet-ondemandoptions): OnDemandOptionsRequest [ReplaceUnhealthyInstances](#cfn-ec2-ec2fleet-replaceunhealthyinstances): Boolean [ReservedCapacityOptions](#cfn-ec2-ec2fleet-reservedcapacityoptions): ReservedCapacityOptionsRequest [SpotOptions](#cfn-ec2-ec2fleet-spotoptions): SpotOptionsRequest [TagSpecifications](#cfn-ec2-ec2fleet-tagspecifications): - TagSpecification [TargetCapacitySpecification](#cfn-ec2-ec2fleet-targetcapacityspecification): TargetCapacitySpecificationRequest [TerminateInstancesWithExpiration](#cfn-ec2-ec2fleet-terminateinstanceswithexpiration): Boolean [Type](#cfn-ec2-ec2fleet-type): String [ValidFrom](#cfn-ec2-ec2fleet-validfrom): String [ValidUntil](#cfn-ec2-ec2fleet-validuntil): String ``` ## Properties `Context` Reserved. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `ExcessCapacityTerminationPolicy` Indicates whether running instances should be terminated if the total target capacity of the EC2 Fleet is decreased below the current size of the EC2 Fleet. Supported only for fleets of type `maintain`. *Required*: No *Type*: String *Allowed values*: `termination | no-termination` *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `LaunchTemplateConfigs` The configuration for the EC2 Fleet. *Required*: Yes *Type*: Array of [FleetLaunchTemplateConfigRequest](aws-properties-ec2-ec2fleet-fleetlaunchtemplateconfigrequest.md) *Maximum*: `50` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `OnDemandOptions` Describes the configuration of On-Demand Instances in an EC2 Fleet. *Required*: No *Type*: [OnDemandOptionsRequest](aws-properties-ec2-ec2fleet-ondemandoptionsrequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `ReplaceUnhealthyInstances` Indicates whether EC2 Fleet should replace unhealthy Spot Instances. Supported only for fleets of type `maintain`. For more information, see [EC2 Fleet health checks](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/manage-ec2-fleet.html#ec2-fleet-health-checks) in the *Amazon EC2 User Guide*. *Required*: No *Type*: Boolean *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `ReservedCapacityOptions` Defines EC2 Fleet preferences for utilizing reserved capacity when DefaultTargetCapacityType is set to `reserved-capacity`. *Required*: No *Type*: [ReservedCapacityOptionsRequest](aws-properties-ec2-ec2fleet-reservedcapacityoptionsrequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `SpotOptions` Describes the configuration of Spot Instances in an EC2 Fleet. *Required*: No *Type*: [SpotOptionsRequest](aws-properties-ec2-ec2fleet-spotoptionsrequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `TagSpecifications` The key-value pair for tagging the EC2 Fleet request on creation. For more information, see [Tag your resources](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-resources). If the fleet type is `instant`, specify a resource type of `fleet` to tag the fleet or `instance` to tag the instances at launch. If the fleet type is `maintain` or `request`, specify a resource type of `fleet` to tag the fleet. You cannot specify a resource type of `instance`. To tag instances at launch, specify the tags in a [launch template](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#create-launch-template). *Required*: No *Type*: Array of [TagSpecification](aws-properties-ec2-ec2fleet-tagspecification.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `TargetCapacitySpecification` The number of units to request. *Required*: Yes *Type*: [TargetCapacitySpecificationRequest](aws-properties-ec2-ec2fleet-targetcapacityspecificationrequest.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `TerminateInstancesWithExpiration` Indicates whether running instances should be terminated when the EC2 Fleet expires. *Required*: No *Type*: Boolean *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Type` The fleet type. The default value is `maintain`. + `maintain` - The EC2 Fleet places an asynchronous request for your desired capacity, and continues to maintain your desired Spot capacity by replenishing interrupted Spot Instances. + `request` - The EC2 Fleet places an asynchronous one-time request for your desired capacity, but does submit Spot requests in alternative capacity pools if Spot capacity is unavailable, and does not maintain Spot capacity if Spot Instances are interrupted. + `instant` - The EC2 Fleet places a synchronous one-time request for your desired capacity, and returns errors for any instances that could not be launched. For more information, see [EC2 Fleet request types](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-fleet-request-type.html) in the *Amazon EC2 User Guide*. *Required*: No *Type*: String *Allowed values*: `maintain | request | instant` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `ValidFrom` The start date and time of the request, in UTC format (for example, *YYYY*-*MM*-*DD*T*HH*:*MM*:*SS*Z). The default is to start fulfilling the request immediately. *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `ValidUntil` The end date and time of the request, in UTC format (for example, *YYYY*-*MM*-*DD*T*HH*:*MM*:*SS*Z). At this point, no new EC2 Fleet requests are placed or able to fulfill the request. If no value is specified, the request remains until you cancel it. *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) ## Return values ### Ref When you pass the logical ID of this resource to the intrinsic `Ref` function, `Ref` returns the fleet ID, such as `fleet-1fe24079-d272-4023-8e7c-70e10784cb0e`. For more information about using the `Ref` function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html). ### Fn::GetAtt The `Fn::GetAtt` intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values. For more information about using the `Fn::GetAtt` intrinsic function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html). #### `FleetId` The ID of the EC2 Fleet. ## See also + [CreateFleet](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateFleet.html) in the *Amazon EC2 API Reference* # AWS::EC2::EC2Fleet AcceleratorCountRequest The minimum and maximum number of accelerators (GPUs, FPGAs, or AWS Inferentia chips) on an instance. To exclude accelerator-enabled instance types, set `Max` to `0`. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Max](#cfn-ec2-ec2fleet-acceleratorcountrequest-max)" : Integer, "[Min](#cfn-ec2-ec2fleet-acceleratorcountrequest-min)" : Integer } ``` ### YAML ``` [Max](#cfn-ec2-ec2fleet-acceleratorcountrequest-max): Integer [Min](#cfn-ec2-ec2fleet-acceleratorcountrequest-min): Integer ``` ## Properties `Max` The maximum number of accelerators. To specify no maximum limit, omit this parameter. To exclude accelerator-enabled instance types, set `Max` to `0`. *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Min` The minimum number of accelerators. To specify no minimum limit, omit this parameter. *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet AcceleratorTotalMemoryMiBRequest The minimum and maximum amount of total accelerator memory, in MiB. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Max](#cfn-ec2-ec2fleet-acceleratortotalmemorymibrequest-max)" : Integer, "[Min](#cfn-ec2-ec2fleet-acceleratortotalmemorymibrequest-min)" : Integer } ``` ### YAML ``` [Max](#cfn-ec2-ec2fleet-acceleratortotalmemorymibrequest-max): Integer [Min](#cfn-ec2-ec2fleet-acceleratortotalmemorymibrequest-min): Integer ``` ## Properties `Max` The maximum amount of accelerator memory, in MiB. To specify no maximum limit, omit this parameter. *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Min` The minimum amount of accelerator memory, in MiB. To specify no minimum limit, omit this parameter. *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet BaselineEbsBandwidthMbpsRequest The minimum and maximum baseline bandwidth to Amazon EBS, in Mbps. For more information, see [Amazon EBS–optimized instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-optimized.html) in the *Amazon EC2 User Guide*. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Max](#cfn-ec2-ec2fleet-baselineebsbandwidthmbpsrequest-max)" : Integer, "[Min](#cfn-ec2-ec2fleet-baselineebsbandwidthmbpsrequest-min)" : Integer } ``` ### YAML ``` [Max](#cfn-ec2-ec2fleet-baselineebsbandwidthmbpsrequest-max): Integer [Min](#cfn-ec2-ec2fleet-baselineebsbandwidthmbpsrequest-min): Integer ``` ## Properties `Max` The maximum baseline bandwidth, in Mbps. To specify no maximum limit, omit this parameter. *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Min` The minimum baseline bandwidth, in Mbps. To specify no minimum limit, omit this parameter. *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet BaselinePerformanceFactorsRequest The baseline performance to consider, using an instance family as a baseline reference. The instance family establishes the lowest acceptable level of performance. Amazon EC2 uses this baseline to guide instance type selection, but there is no guarantee that the selected instance types will always exceed the baseline for every application. Currently, this parameter only supports CPU performance as a baseline performance factor. For example, specifying `c6i` would use the CPU performance of the `c6i` family as the baseline reference. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Cpu](#cfn-ec2-ec2fleet-baselineperformancefactorsrequest-cpu)" : CpuPerformanceFactorRequest } ``` ### YAML ``` [Cpu](#cfn-ec2-ec2fleet-baselineperformancefactorsrequest-cpu): CpuPerformanceFactorRequest ``` ## Properties `Cpu` The CPU performance to consider, using an instance family as the baseline reference. *Required*: No *Type*: [CpuPerformanceFactorRequest](aws-properties-ec2-ec2fleet-cpuperformancefactorrequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet BlockDeviceMapping Describes a block device mapping, which defines the EBS volumes and instance store volumes to attach to an instance at launch. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[DeviceName](#cfn-ec2-ec2fleet-blockdevicemapping-devicename)" : String, "[Ebs](#cfn-ec2-ec2fleet-blockdevicemapping-ebs)" : EbsBlockDevice, "[NoDevice](#cfn-ec2-ec2fleet-blockdevicemapping-nodevice)" : String, "[VirtualName](#cfn-ec2-ec2fleet-blockdevicemapping-virtualname)" : String } ``` ### YAML ``` [DeviceName](#cfn-ec2-ec2fleet-blockdevicemapping-devicename): String [Ebs](#cfn-ec2-ec2fleet-blockdevicemapping-ebs): EbsBlockDevice [NoDevice](#cfn-ec2-ec2fleet-blockdevicemapping-nodevice): String [VirtualName](#cfn-ec2-ec2fleet-blockdevicemapping-virtualname): String ``` ## Properties `DeviceName` The device name. For available device names, see [Device names for volumes](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/device_naming.html). *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Ebs` Parameters used to automatically set up EBS volumes when the instance is launched. *Required*: No *Type*: [EbsBlockDevice](aws-properties-ec2-ec2fleet-ebsblockdevice.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `NoDevice` To omit the device from the block device mapping, specify an empty string. When this property is specified, the device is removed from the block device mapping regardless of the assigned value. *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `VirtualName` The virtual device name (`ephemeral`N). Instance store volumes are numbered starting from 0. An instance type with 2 available instance store volumes can specify mappings for `ephemeral0` and `ephemeral1`. The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume. NVMe instance store volumes are automatically enumerated and assigned a device name. Including them in your block device mapping has no effect. Constraints: For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI. *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet CapacityRebalance The Spot Instance replacement strategy to use when Amazon EC2 emits a rebalance notification signal that your Spot Instance is at an elevated risk of being interrupted. For more information, see [Capacity rebalancing](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-fleet-capacity-rebalance.html) in the *Amazon EC2 User Guide*. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[ReplacementStrategy](#cfn-ec2-ec2fleet-capacityrebalance-replacementstrategy)" : String, "[TerminationDelay](#cfn-ec2-ec2fleet-capacityrebalance-terminationdelay)" : Integer } ``` ### YAML ``` [ReplacementStrategy](#cfn-ec2-ec2fleet-capacityrebalance-replacementstrategy): String [TerminationDelay](#cfn-ec2-ec2fleet-capacityrebalance-terminationdelay): Integer ``` ## Properties `ReplacementStrategy` The replacement strategy to use. Only available for fleets of type `maintain`. `launch` - EC2 Fleet launches a replacement Spot Instance when a rebalance notification is emitted for an existing Spot Instance in the fleet. EC2 Fleet does not terminate the instances that receive a rebalance notification. You can terminate the old instances, or you can leave them running. You are charged for all instances while they are running. `launch-before-terminate` - EC2 Fleet launches a replacement Spot Instance when a rebalance notification is emitted for an existing Spot Instance in the fleet, and then, after a delay that you specify (in `TerminationDelay`), terminates the instances that received a rebalance notification. *Required*: No *Type*: String *Allowed values*: `launch | launch-before-terminate` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `TerminationDelay` The amount of time (in seconds) that Amazon EC2 waits before terminating the old Spot Instance after launching a new replacement Spot Instance. Required when `ReplacementStrategy` is set to `launch-before-terminate`. Not valid when `ReplacementStrategy` is set to `launch`. Valid values: Minimum value of `120` seconds. Maximum value of `7200` seconds. *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet CapacityReservationOptionsRequest Describes the strategy for using unused Capacity Reservations for fulfilling On-Demand capacity. **Note** This strategy can only be used if the EC2 Fleet is of type `instant`. For more information about Capacity Reservations, see [On-Demand Capacity Reservations](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-capacity-reservations.html) in the *Amazon EC2 User Guide*. For examples of using Capacity Reservations in an EC2 Fleet, see [EC2 Fleet example configurations](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-fleet-examples.html) in the *Amazon EC2 User Guide*. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[UsageStrategy](#cfn-ec2-ec2fleet-capacityreservationoptionsrequest-usagestrategy)" : String } ``` ### YAML ``` [UsageStrategy](#cfn-ec2-ec2fleet-capacityreservationoptionsrequest-usagestrategy): String ``` ## Properties `UsageStrategy` Indicates whether to use unused Capacity Reservations for fulfilling On-Demand capacity. If you specify `use-capacity-reservations-first`, the fleet uses unused Capacity Reservations to fulfill On-Demand capacity up to the target On-Demand capacity. If multiple instance pools have unused Capacity Reservations, the On-Demand allocation strategy (`lowest-price` or `prioritized`) is applied. If the number of unused Capacity Reservations is less than the On-Demand target capacity, the remaining On-Demand target capacity is launched according to the On-Demand allocation strategy (`lowest-price` or `prioritized`). If you do not specify a value, the fleet fulfils the On-Demand capacity according to the chosen On-Demand allocation strategy. *Required*: No *Type*: String *Allowed values*: `use-capacity-reservations-first` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet CpuPerformanceFactorRequest The CPU performance to consider, using an instance family as the baseline reference. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[References](#cfn-ec2-ec2fleet-cpuperformancefactorrequest-references)" : [ PerformanceFactorReferenceRequest, ... ] } ``` ### YAML ``` [References](#cfn-ec2-ec2fleet-cpuperformancefactorrequest-references): - PerformanceFactorReferenceRequest ``` ## Properties `References` Specify an instance family to use as the baseline reference for CPU performance. All instance types that match your specified attributes will be compared against the CPU performance of the referenced instance family, regardless of CPU manufacturer or architecture differences. Currently, only one instance family can be specified in the list. *Required*: No *Type*: Array of [PerformanceFactorReferenceRequest](aws-properties-ec2-ec2fleet-performancefactorreferencerequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet EbsBlockDevice Describes a block device for an EBS volume. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[DeleteOnTermination](#cfn-ec2-ec2fleet-ebsblockdevice-deleteontermination)" : Boolean, "[Encrypted](#cfn-ec2-ec2fleet-ebsblockdevice-encrypted)" : Boolean, "[Iops](#cfn-ec2-ec2fleet-ebsblockdevice-iops)" : Integer, "[KmsKeyId](#cfn-ec2-ec2fleet-ebsblockdevice-kmskeyid)" : String, "[SnapshotId](#cfn-ec2-ec2fleet-ebsblockdevice-snapshotid)" : String, "[VolumeSize](#cfn-ec2-ec2fleet-ebsblockdevice-volumesize)" : Integer, "[VolumeType](#cfn-ec2-ec2fleet-ebsblockdevice-volumetype)" : String } ``` ### YAML ``` [DeleteOnTermination](#cfn-ec2-ec2fleet-ebsblockdevice-deleteontermination): Boolean [Encrypted](#cfn-ec2-ec2fleet-ebsblockdevice-encrypted): Boolean [Iops](#cfn-ec2-ec2fleet-ebsblockdevice-iops): Integer [KmsKeyId](#cfn-ec2-ec2fleet-ebsblockdevice-kmskeyid): String [SnapshotId](#cfn-ec2-ec2fleet-ebsblockdevice-snapshotid): String [VolumeSize](#cfn-ec2-ec2fleet-ebsblockdevice-volumesize): Integer [VolumeType](#cfn-ec2-ec2fleet-ebsblockdevice-volumetype): String ``` ## Properties `DeleteOnTermination` Indicates whether the EBS volume is deleted on instance termination. For more information, see [Preserving Amazon EBS volumes on instance termination](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html#preserving-volumes-on-termination) in the *Amazon EC2 User Guide*. *Required*: No *Type*: Boolean *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Encrypted` Indicates whether the encryption state of an EBS volume is changed while being restored from a backing snapshot. The effect of setting the encryption state to `true` depends on the volume origin (new or from a snapshot), starting encryption state, ownership, and whether encryption by default is enabled. For more information, see [Amazon EBS encryption](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-encryption.html#encryption-parameters) in the *Amazon EBS User Guide*. In no case can you remove encryption from an encrypted volume. Encrypted volumes can only be attached to instances that support Amazon EBS encryption. For more information, see [Supported instance types](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-encryption-requirements.html#ebs-encryption_supported_instances). + If you are creating a block device mapping for a **new (empty) volume**, you can include this parameter, and specify either `true` for an encrypted volume, or `false` for an unencrypted volume. If you omit this parameter, it defaults to `false` (unencrypted). + If you are creating a block device mapping from an **existing encrypted or unencrypted snapshot**, you must omit this parameter. If you include this parameter, the request will fail, regardless of the value that you specify. + If you are creating a block device mapping from an **existing unencrypted volume**, you can include this parameter, but you must specify `false`. If you specify `true`, the request will fail. In this case, we recommend that you omit the parameter. + If you are creating a block device mapping from an **existing encrypted volume**, you can include this parameter, and specify either `true` or `false`. However, if you specify `false`, the parameter is ignored and the block device mapping is always encrypted. In this case, we recommend that you omit the parameter. *Required*: No *Type*: Boolean *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Iops` The number of I/O operations per second (IOPS). For `gp3`, `io1`, and `io2` volumes, this represents the number of IOPS that are provisioned for the volume. For `gp2` volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. The following are the supported values for each volume type: + `gp3`: 3,000 - 80,000 IOPS + `io1`: 100 - 64,000 IOPS + `io2`: 100 - 256,000 IOPS For `io2` volumes, you can achieve up to 256,000 IOPS on [instances built on the Nitro System](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances). On other instances, you can achieve performance up to 32,000 IOPS. This parameter is required for `io1` and `io2` volumes. The default for `gp3` volumes is 3,000 IOPS. *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `KmsKeyId` Identifier (key ID, key alias, key ARN, or alias ARN) of the customer managed KMS key to use for EBS encryption. This parameter is only supported on `BlockDeviceMapping` objects called by [RunInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html), [RequestSpotFleet](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotFleet.html), and [RequestSpotInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotInstances.html). *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `SnapshotId` The ID of the snapshot. *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `VolumeSize` The size of the volume, in GiBs. You must specify either a snapshot ID or a volume size. If you specify a snapshot, the default is the snapshot size. You can specify a volume size that is equal to or larger than the snapshot size. The following are the supported sizes for each volume type: + `gp2`: 1 - 16,384 GiB + `gp3`: 1 - 65,536 GiB + `io1`: 4 - 16,384 GiB + `io2`: 4 - 65,536 GiB + `st1` and `sc1`: 125 - 16,384 GiB + `standard`: 1 - 1024 GiB *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `VolumeType` The volume type. For more information, see [Amazon EBS volume types](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html) in the *Amazon EBS User Guide*. *Required*: No *Type*: String *Allowed values*: `gp2 | gp3 | io1 | io2 | sc1 | st1 | standard` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet FleetLaunchTemplateConfigRequest Specifies a launch template and overrides for an EC2 Fleet. `FleetLaunchTemplateConfigRequest` is a property of the [AWS::EC2::EC2Fleet](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-ec2fleet.html) resource. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[LaunchTemplateSpecification](#cfn-ec2-ec2fleet-fleetlaunchtemplateconfigrequest-launchtemplatespecification)" : FleetLaunchTemplateSpecificationRequest, "[Overrides](#cfn-ec2-ec2fleet-fleetlaunchtemplateconfigrequest-overrides)" : [ FleetLaunchTemplateOverridesRequest, ... ] } ``` ### YAML ``` [LaunchTemplateSpecification](#cfn-ec2-ec2fleet-fleetlaunchtemplateconfigrequest-launchtemplatespecification): FleetLaunchTemplateSpecificationRequest [Overrides](#cfn-ec2-ec2fleet-fleetlaunchtemplateconfigrequest-overrides): - FleetLaunchTemplateOverridesRequest ``` ## Properties `LaunchTemplateSpecification` The launch template to use. You must specify either the launch template ID or launch template name in the request. *Required*: No *Type*: [FleetLaunchTemplateSpecificationRequest](aws-properties-ec2-ec2fleet-fleetlaunchtemplatespecificationrequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Overrides` Any parameters that you specify override the same parameters in the launch template. For fleets of type `request` and `maintain`, a maximum of 300 items is allowed across all launch templates. *Required*: No *Type*: Array of [FleetLaunchTemplateOverridesRequest](aws-properties-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) ## See also + [ FleetLaunchTemplateConfigRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_FleetLaunchTemplateConfigRequest.html) in the *Amazon EC2 API Reference* # AWS::EC2::EC2Fleet FleetLaunchTemplateOverridesRequest Specifies overrides for a launch template for an EC2 Fleet. `FleetLaunchTemplateOverridesRequest` is a property of the [FleetLaunchTemplateConfigRequest](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-fleetlaunchtemplateconfigrequest.html) property type. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[AvailabilityZone](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-availabilityzone)" : String, "[AvailabilityZoneId](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-availabilityzoneid)" : String, "[BlockDeviceMappings](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-blockdevicemappings)" : [ BlockDeviceMapping, ... ], "[InstanceRequirements](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-instancerequirements)" : InstanceRequirementsRequest, "[InstanceType](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-instancetype)" : String, "[MaxPrice](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-maxprice)" : String, "[Placement](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-placement)" : Placement, "[Priority](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-priority)" : Number, "[SubnetId](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-subnetid)" : String, "[WeightedCapacity](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-weightedcapacity)" : Number } ``` ### YAML ``` [AvailabilityZone](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-availabilityzone): String [AvailabilityZoneId](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-availabilityzoneid): String [BlockDeviceMappings](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-blockdevicemappings): - BlockDeviceMapping [InstanceRequirements](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-instancerequirements): InstanceRequirementsRequest [InstanceType](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-instancetype): String [MaxPrice](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-maxprice): String [Placement](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-placement): Placement [Priority](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-priority): Number [SubnetId](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-subnetid): String [WeightedCapacity](#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-weightedcapacity): Number ``` ## Properties `AvailabilityZone` The Availability Zone in which to launch the instances. For example, `us-east-2a`. Either `AvailabilityZone` or `AvailabilityZoneId` must be specified in the request, but not both. *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `AvailabilityZoneId` The ID of the Availability Zone in which to launch the instances. For example, `use2-az1`. Either `AvailabilityZone` or `AvailabilityZoneId` must be specified in the request, but not both. *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `BlockDeviceMappings` The block device mappings, which define the EBS volumes and instance store volumes to attach to the instance at launch. Supported only for fleets of type `instant`. For more information, see [Block device mappings for volumes on Amazon EC2 instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html) in the *Amazon EC2 User Guide*. *Required*: No *Type*: Array of [BlockDeviceMapping](aws-properties-ec2-ec2fleet-blockdevicemapping.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `InstanceRequirements` The attributes for the instance types. When you specify instance attributes, Amazon EC2 will identify instance types with those attributes. If you specify `InstanceRequirements`, you can't specify `InstanceType`. *Required*: No *Type*: [InstanceRequirementsRequest](aws-properties-ec2-ec2fleet-instancerequirementsrequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `InstanceType` The instance type. `mac1.metal` is not supported as a launch template override. If you specify `InstanceType`, you can't specify `InstanceRequirements`. *Required*: No *Type*: String *Allowed values*: `a1.medium | a1.large | a1.xlarge | a1.2xlarge | a1.4xlarge | a1.metal | c1.medium | c1.xlarge | c3.large | c3.xlarge | c3.2xlarge | c3.4xlarge | c3.8xlarge | c4.large | c4.xlarge | c4.2xlarge | c4.4xlarge | c4.8xlarge | c5.large | c5.xlarge | c5.2xlarge | c5.4xlarge | c5.9xlarge | c5.12xlarge | c5.18xlarge | c5.24xlarge | c5.metal | c5a.large | c5a.xlarge | c5a.2xlarge | c5a.4xlarge | c5a.8xlarge | c5a.12xlarge | c5a.16xlarge | c5a.24xlarge | c5ad.large | c5ad.xlarge | c5ad.2xlarge | c5ad.4xlarge | c5ad.8xlarge | c5ad.12xlarge | c5ad.16xlarge | c5ad.24xlarge | c5d.large | c5d.xlarge | c5d.2xlarge | c5d.4xlarge | c5d.9xlarge | c5d.12xlarge | c5d.18xlarge | c5d.24xlarge | c5d.metal | c5n.large | c5n.xlarge | c5n.2xlarge | c5n.4xlarge | c5n.9xlarge | c5n.18xlarge | c5n.metal | c6g.medium | c6g.large | c6g.xlarge | c6g.2xlarge | c6g.4xlarge | c6g.8xlarge | c6g.12xlarge | c6g.16xlarge | c6g.metal | c6gd.medium | c6gd.large | c6gd.xlarge | c6gd.2xlarge | c6gd.4xlarge | c6gd.8xlarge | c6gd.12xlarge | c6gd.16xlarge | c6gd.metal | c6gn.medium | c6gn.large | c6gn.xlarge | c6gn.2xlarge | c6gn.4xlarge | c6gn.8xlarge | c6gn.12xlarge | c6gn.16xlarge | c6i.large | c6i.xlarge | c6i.2xlarge | c6i.4xlarge | c6i.8xlarge | c6i.12xlarge | c6i.16xlarge | c6i.24xlarge | c6i.32xlarge | c6i.metal | cc1.4xlarge | cc2.8xlarge | cg1.4xlarge | cr1.8xlarge | d2.xlarge | d2.2xlarge | d2.4xlarge | d2.8xlarge | d3.xlarge | d3.2xlarge | d3.4xlarge | d3.8xlarge | d3en.xlarge | d3en.2xlarge | d3en.4xlarge | d3en.6xlarge | d3en.8xlarge | d3en.12xlarge | dl1.24xlarge | f1.2xlarge | f1.4xlarge | f1.16xlarge | g2.2xlarge | g2.8xlarge | g3.4xlarge | g3.8xlarge | g3.16xlarge | g3s.xlarge | g4ad.xlarge | g4ad.2xlarge | g4ad.4xlarge | g4ad.8xlarge | g4ad.16xlarge | g4dn.xlarge | g4dn.2xlarge | g4dn.4xlarge | g4dn.8xlarge | g4dn.12xlarge | g4dn.16xlarge | g4dn.metal | g5.xlarge | g5.2xlarge | g5.4xlarge | g5.8xlarge | g5.12xlarge | g5.16xlarge | g5.24xlarge | g5.48xlarge | g5g.xlarge | g5g.2xlarge | g5g.4xlarge | g5g.8xlarge | g5g.16xlarge | g5g.metal | hi1.4xlarge | hpc6a.48xlarge | hs1.8xlarge | h1.2xlarge | h1.4xlarge | h1.8xlarge | h1.16xlarge | i2.xlarge | i2.2xlarge | i2.4xlarge | i2.8xlarge | i3.large | i3.xlarge | i3.2xlarge | i3.4xlarge | i3.8xlarge | i3.16xlarge | i3.metal | i3en.large | i3en.xlarge | i3en.2xlarge | i3en.3xlarge | i3en.6xlarge | i3en.12xlarge | i3en.24xlarge | i3en.metal | im4gn.large | im4gn.xlarge | im4gn.2xlarge | im4gn.4xlarge | im4gn.8xlarge | im4gn.16xlarge | inf1.xlarge | inf1.2xlarge | inf1.6xlarge | inf1.24xlarge | is4gen.medium | is4gen.large | is4gen.xlarge | is4gen.2xlarge | is4gen.4xlarge | is4gen.8xlarge | m1.small | m1.medium | m1.large | m1.xlarge | m2.xlarge | m2.2xlarge | m2.4xlarge | m3.medium | m3.large | m3.xlarge | m3.2xlarge | m4.large | m4.xlarge | m4.2xlarge | m4.4xlarge | m4.10xlarge | m4.16xlarge | m5.large | m5.xlarge | m5.2xlarge | m5.4xlarge | m5.8xlarge | m5.12xlarge | m5.16xlarge | m5.24xlarge | m5.metal | m5a.large | m5a.xlarge | m5a.2xlarge | m5a.4xlarge | m5a.8xlarge | m5a.12xlarge | m5a.16xlarge | m5a.24xlarge | m5ad.large | m5ad.xlarge | m5ad.2xlarge | m5ad.4xlarge | m5ad.8xlarge | m5ad.12xlarge | m5ad.16xlarge | m5ad.24xlarge | m5d.large | m5d.xlarge | m5d.2xlarge | m5d.4xlarge | m5d.8xlarge | m5d.12xlarge | m5d.16xlarge | m5d.24xlarge | m5d.metal | m5dn.large | m5dn.xlarge | m5dn.2xlarge | m5dn.4xlarge | m5dn.8xlarge | m5dn.12xlarge | m5dn.16xlarge | m5dn.24xlarge | m5dn.metal | m5n.large | m5n.xlarge | m5n.2xlarge | m5n.4xlarge | m5n.8xlarge | m5n.12xlarge | m5n.16xlarge | m5n.24xlarge | m5n.metal | m5zn.large | m5zn.xlarge | m5zn.2xlarge | m5zn.3xlarge | m5zn.6xlarge | m5zn.12xlarge | m5zn.metal | m6a.large | m6a.xlarge | m6a.2xlarge | m6a.4xlarge | m6a.8xlarge | m6a.12xlarge | m6a.16xlarge | m6a.24xlarge | m6a.32xlarge | m6a.48xlarge | m6g.metal | m6g.medium | m6g.large | m6g.xlarge | m6g.2xlarge | m6g.4xlarge | m6g.8xlarge | m6g.12xlarge | m6g.16xlarge | m6gd.metal | m6gd.medium | m6gd.large | m6gd.xlarge | m6gd.2xlarge | m6gd.4xlarge | m6gd.8xlarge | m6gd.12xlarge | m6gd.16xlarge | m6i.large | m6i.xlarge | m6i.2xlarge | m6i.4xlarge | m6i.8xlarge | m6i.12xlarge | m6i.16xlarge | m6i.24xlarge | m6i.32xlarge | m6i.metal | mac1.metal | p2.xlarge | p2.8xlarge | p2.16xlarge | p3.2xlarge | p3.8xlarge | p3.16xlarge | p3dn.24xlarge | p4d.24xlarge | r3.large | r3.xlarge | r3.2xlarge | r3.4xlarge | r3.8xlarge | r4.large | r4.xlarge | r4.2xlarge | r4.4xlarge | r4.8xlarge | r4.16xlarge | r5.large | r5.xlarge | r5.2xlarge | r5.4xlarge | r5.8xlarge | r5.12xlarge | r5.16xlarge | r5.24xlarge | r5.metal | r5a.large | r5a.xlarge | r5a.2xlarge | r5a.4xlarge | r5a.8xlarge | r5a.12xlarge | r5a.16xlarge | r5a.24xlarge | r5ad.large | r5ad.xlarge | r5ad.2xlarge | r5ad.4xlarge | r5ad.8xlarge | r5ad.12xlarge | r5ad.16xlarge | r5ad.24xlarge | r5b.large | r5b.xlarge | r5b.2xlarge | r5b.4xlarge | r5b.8xlarge | r5b.12xlarge | r5b.16xlarge | r5b.24xlarge | r5b.metal | r5d.large | r5d.xlarge | r5d.2xlarge | r5d.4xlarge | r5d.8xlarge | r5d.12xlarge | r5d.16xlarge | r5d.24xlarge | r5d.metal | r5dn.large | r5dn.xlarge | r5dn.2xlarge | r5dn.4xlarge | r5dn.8xlarge | r5dn.12xlarge | r5dn.16xlarge | r5dn.24xlarge | r5dn.metal | r5n.large | r5n.xlarge | r5n.2xlarge | r5n.4xlarge | r5n.8xlarge | r5n.12xlarge | r5n.16xlarge | r5n.24xlarge | r5n.metal | r6g.medium | r6g.large | r6g.xlarge | r6g.2xlarge | r6g.4xlarge | r6g.8xlarge | r6g.12xlarge | r6g.16xlarge | r6g.metal | r6gd.medium | r6gd.large | r6gd.xlarge | r6gd.2xlarge | r6gd.4xlarge | r6gd.8xlarge | r6gd.12xlarge | r6gd.16xlarge | r6gd.metal | r6i.large | r6i.xlarge | r6i.2xlarge | r6i.4xlarge | r6i.8xlarge | r6i.12xlarge | r6i.16xlarge | r6i.24xlarge | r6i.32xlarge | r6i.metal | t1.micro | t2.nano | t2.micro | t2.small | t2.medium | t2.large | t2.xlarge | t2.2xlarge | t3.nano | t3.micro | t3.small | t3.medium | t3.large | t3.xlarge | t3.2xlarge | t3a.nano | t3a.micro | t3a.small | t3a.medium | t3a.large | t3a.xlarge | t3a.2xlarge | t4g.nano | t4g.micro | t4g.small | t4g.medium | t4g.large | t4g.xlarge | t4g.2xlarge | u-6tb1.56xlarge | u-6tb1.112xlarge | u-9tb1.112xlarge | u-12tb1.112xlarge | u-6tb1.metal | u-9tb1.metal | u-12tb1.metal | u-18tb1.metal | u-24tb1.metal | vt1.3xlarge | vt1.6xlarge | vt1.24xlarge | x1.16xlarge | x1.32xlarge | x1e.xlarge | x1e.2xlarge | x1e.4xlarge | x1e.8xlarge | x1e.16xlarge | x1e.32xlarge | x2iezn.2xlarge | x2iezn.4xlarge | x2iezn.6xlarge | x2iezn.8xlarge | x2iezn.12xlarge | x2iezn.metal | x2gd.medium | x2gd.large | x2gd.xlarge | x2gd.2xlarge | x2gd.4xlarge | x2gd.8xlarge | x2gd.12xlarge | x2gd.16xlarge | x2gd.metal | z1d.large | z1d.xlarge | z1d.2xlarge | z1d.3xlarge | z1d.6xlarge | z1d.12xlarge | z1d.metal | x2idn.16xlarge | x2idn.24xlarge | x2idn.32xlarge | x2iedn.xlarge | x2iedn.2xlarge | x2iedn.4xlarge | x2iedn.8xlarge | x2iedn.16xlarge | x2iedn.24xlarge | x2iedn.32xlarge | c6a.large | c6a.xlarge | c6a.2xlarge | c6a.4xlarge | c6a.8xlarge | c6a.12xlarge | c6a.16xlarge | c6a.24xlarge | c6a.32xlarge | c6a.48xlarge | c6a.metal | m6a.metal | i4i.large | i4i.xlarge | i4i.2xlarge | i4i.4xlarge | i4i.8xlarge | i4i.16xlarge | i4i.32xlarge | i4i.metal | x2idn.metal | x2iedn.metal | c7g.medium | c7g.large | c7g.xlarge | c7g.2xlarge | c7g.4xlarge | c7g.8xlarge | c7g.12xlarge | c7g.16xlarge | mac2.metal | c6id.large | c6id.xlarge | c6id.2xlarge | c6id.4xlarge | c6id.8xlarge | c6id.12xlarge | c6id.16xlarge | c6id.24xlarge | c6id.32xlarge | c6id.metal | m6id.large | m6id.xlarge | m6id.2xlarge | m6id.4xlarge | m6id.8xlarge | m6id.12xlarge | m6id.16xlarge | m6id.24xlarge | m6id.32xlarge | m6id.metal | r6id.large | r6id.xlarge | r6id.2xlarge | r6id.4xlarge | r6id.8xlarge | r6id.12xlarge | r6id.16xlarge | r6id.24xlarge | r6id.32xlarge | r6id.metal | r6a.large | r6a.xlarge | r6a.2xlarge | r6a.4xlarge | r6a.8xlarge | r6a.12xlarge | r6a.16xlarge | r6a.24xlarge | r6a.32xlarge | r6a.48xlarge | r6a.metal | p4de.24xlarge | u-3tb1.56xlarge | u-18tb1.112xlarge | u-24tb1.112xlarge | trn1.2xlarge | trn1.32xlarge | hpc6id.32xlarge | c6in.large | c6in.xlarge | c6in.2xlarge | c6in.4xlarge | c6in.8xlarge | c6in.12xlarge | c6in.16xlarge | c6in.24xlarge | c6in.32xlarge | m6in.large | m6in.xlarge | m6in.2xlarge | m6in.4xlarge | m6in.8xlarge | m6in.12xlarge | m6in.16xlarge | m6in.24xlarge | m6in.32xlarge | m6idn.large | m6idn.xlarge | m6idn.2xlarge | m6idn.4xlarge | m6idn.8xlarge | m6idn.12xlarge | m6idn.16xlarge | m6idn.24xlarge | m6idn.32xlarge | r6in.large | r6in.xlarge | r6in.2xlarge | r6in.4xlarge | r6in.8xlarge | r6in.12xlarge | r6in.16xlarge | r6in.24xlarge | r6in.32xlarge | r6idn.large | r6idn.xlarge | r6idn.2xlarge | r6idn.4xlarge | r6idn.8xlarge | r6idn.12xlarge | r6idn.16xlarge | r6idn.24xlarge | r6idn.32xlarge | c7g.metal | m7g.medium | m7g.large | m7g.xlarge | m7g.2xlarge | m7g.4xlarge | m7g.8xlarge | m7g.12xlarge | m7g.16xlarge | m7g.metal | r7g.medium | r7g.large | r7g.xlarge | r7g.2xlarge | r7g.4xlarge | r7g.8xlarge | r7g.12xlarge | r7g.16xlarge | r7g.metal | c6in.metal | m6in.metal | m6idn.metal | r6in.metal | r6idn.metal | inf2.xlarge | inf2.8xlarge | inf2.24xlarge | inf2.48xlarge | trn1n.32xlarge | i4g.large | i4g.xlarge | i4g.2xlarge | i4g.4xlarge | i4g.8xlarge | i4g.16xlarge | hpc7g.4xlarge | hpc7g.8xlarge | hpc7g.16xlarge | c7gn.medium | c7gn.large | c7gn.xlarge | c7gn.2xlarge | c7gn.4xlarge | c7gn.8xlarge | c7gn.12xlarge | c7gn.16xlarge | p5.48xlarge | m7i.large | m7i.xlarge | m7i.2xlarge | m7i.4xlarge | m7i.8xlarge | m7i.12xlarge | m7i.16xlarge | m7i.24xlarge | m7i.48xlarge | m7i-flex.large | m7i-flex.xlarge | m7i-flex.2xlarge | m7i-flex.4xlarge | m7i-flex.8xlarge | m7a.medium | m7a.large | m7a.xlarge | m7a.2xlarge | m7a.4xlarge | m7a.8xlarge | m7a.12xlarge | m7a.16xlarge | m7a.24xlarge | m7a.32xlarge | m7a.48xlarge | m7a.metal-48xl | hpc7a.12xlarge | hpc7a.24xlarge | hpc7a.48xlarge | hpc7a.96xlarge | c7gd.medium | c7gd.large | c7gd.xlarge | c7gd.2xlarge | c7gd.4xlarge | c7gd.8xlarge | c7gd.12xlarge | c7gd.16xlarge | m7gd.medium | m7gd.large | m7gd.xlarge | m7gd.2xlarge | m7gd.4xlarge | m7gd.8xlarge | m7gd.12xlarge | m7gd.16xlarge | r7gd.medium | r7gd.large | r7gd.xlarge | r7gd.2xlarge | r7gd.4xlarge | r7gd.8xlarge | r7gd.12xlarge | r7gd.16xlarge | r7a.medium | r7a.large | r7a.xlarge | r7a.2xlarge | r7a.4xlarge | r7a.8xlarge | r7a.12xlarge | r7a.16xlarge | r7a.24xlarge | r7a.32xlarge | r7a.48xlarge | c7i.large | c7i.xlarge | c7i.2xlarge | c7i.4xlarge | c7i.8xlarge | c7i.12xlarge | c7i.16xlarge | c7i.24xlarge | c7i.48xlarge | mac2-m2pro.metal | r7iz.large | r7iz.xlarge | r7iz.2xlarge | r7iz.4xlarge | r7iz.8xlarge | r7iz.12xlarge | r7iz.16xlarge | r7iz.32xlarge | c7a.medium | c7a.large | c7a.xlarge | c7a.2xlarge | c7a.4xlarge | c7a.8xlarge | c7a.12xlarge | c7a.16xlarge | c7a.24xlarge | c7a.32xlarge | c7a.48xlarge | c7a.metal-48xl | r7a.metal-48xl | r7i.large | r7i.xlarge | r7i.2xlarge | r7i.4xlarge | r7i.8xlarge | r7i.12xlarge | r7i.16xlarge | r7i.24xlarge | r7i.48xlarge | dl2q.24xlarge | mac2-m2.metal | i4i.12xlarge | i4i.24xlarge | c7i.metal-24xl | c7i.metal-48xl | m7i.metal-24xl | m7i.metal-48xl | r7i.metal-24xl | r7i.metal-48xl | r7iz.metal-16xl | r7iz.metal-32xl | c7gd.metal | m7gd.metal | r7gd.metal | g6.xlarge | g6.2xlarge | g6.4xlarge | g6.8xlarge | g6.12xlarge | g6.16xlarge | g6.24xlarge | g6.48xlarge | gr6.4xlarge | gr6.8xlarge | c7i-flex.large | c7i-flex.xlarge | c7i-flex.2xlarge | c7i-flex.4xlarge | c7i-flex.8xlarge | u7i-12tb.224xlarge | u7in-16tb.224xlarge | u7in-24tb.224xlarge | u7in-32tb.224xlarge | u7ib-12tb.224xlarge | c7gn.metal | r8g.medium | r8g.large | r8g.xlarge | r8g.2xlarge | r8g.4xlarge | r8g.8xlarge | r8g.12xlarge | r8g.16xlarge | r8g.24xlarge | r8g.48xlarge | r8g.metal-24xl | r8g.metal-48xl | mac2-m1ultra.metal | g6e.xlarge | g6e.2xlarge | g6e.4xlarge | g6e.8xlarge | g6e.12xlarge | g6e.16xlarge | g6e.24xlarge | g6e.48xlarge | c8g.medium | c8g.large | c8g.xlarge | c8g.2xlarge | c8g.4xlarge | c8g.8xlarge | c8g.12xlarge | c8g.16xlarge | c8g.24xlarge | c8g.48xlarge | c8g.metal-24xl | c8g.metal-48xl | m8g.medium | m8g.large | m8g.xlarge | m8g.2xlarge | m8g.4xlarge | m8g.8xlarge | m8g.12xlarge | m8g.16xlarge | m8g.24xlarge | m8g.48xlarge | m8g.metal-24xl | m8g.metal-48xl | x8g.medium | x8g.large | x8g.xlarge | x8g.2xlarge | x8g.4xlarge | x8g.8xlarge | x8g.12xlarge | x8g.16xlarge | x8g.24xlarge | x8g.48xlarge | x8g.metal-24xl | x8g.metal-48xl | i7ie.large | i7ie.xlarge | i7ie.2xlarge | i7ie.3xlarge | i7ie.6xlarge | i7ie.12xlarge | i7ie.18xlarge | i7ie.24xlarge | i7ie.48xlarge | i8g.large | i8g.xlarge | i8g.2xlarge | i8g.4xlarge | i8g.8xlarge | i8g.12xlarge | i8g.16xlarge | i8g.24xlarge | i8g.metal-24xl | u7i-6tb.112xlarge | u7i-8tb.112xlarge | u7inh-32tb.480xlarge | p5e.48xlarge | p5en.48xlarge | f2.12xlarge | f2.48xlarge | trn2.48xlarge | c7i-flex.12xlarge | c7i-flex.16xlarge | m7i-flex.12xlarge | m7i-flex.16xlarge | i7ie.metal-24xl | i7ie.metal-48xl | i8g.48xlarge | c8gd.medium | c8gd.large | c8gd.xlarge | c8gd.2xlarge | c8gd.4xlarge | c8gd.8xlarge | c8gd.12xlarge | c8gd.16xlarge | c8gd.24xlarge | c8gd.48xlarge | c8gd.metal-24xl | c8gd.metal-48xl | i7i.large | i7i.xlarge | i7i.2xlarge | i7i.4xlarge | i7i.8xlarge | i7i.12xlarge | i7i.16xlarge | i7i.24xlarge | i7i.48xlarge | i7i.metal-24xl | i7i.metal-48xl | p6-b200.48xlarge | m8gd.medium | m8gd.large | m8gd.xlarge | m8gd.2xlarge | m8gd.4xlarge | m8gd.8xlarge | m8gd.12xlarge | m8gd.16xlarge | m8gd.24xlarge | m8gd.48xlarge | m8gd.metal-24xl | m8gd.metal-48xl | r8gd.medium | r8gd.large | r8gd.xlarge | r8gd.2xlarge | r8gd.4xlarge | r8gd.8xlarge | r8gd.12xlarge | r8gd.16xlarge | r8gd.24xlarge | r8gd.48xlarge | r8gd.metal-24xl | r8gd.metal-48xl | c8gn.medium | c8gn.large | c8gn.xlarge | c8gn.2xlarge | c8gn.4xlarge | c8gn.8xlarge | c8gn.12xlarge | c8gn.16xlarge | c8gn.24xlarge | c8gn.48xlarge | c8gn.metal-24xl | c8gn.metal-48xl | f2.6xlarge | p6e-gb200.36xlarge | g6f.large | g6f.xlarge | g6f.2xlarge | g6f.4xlarge | gr6f.4xlarge | p5.4xlarge | r8i.large | r8i.xlarge | r8i.2xlarge | r8i.4xlarge | r8i.8xlarge | r8i.12xlarge | r8i.16xlarge | r8i.24xlarge | r8i.32xlarge | r8i.48xlarge | r8i.96xlarge | r8i.metal-48xl | r8i.metal-96xl | r8i-flex.large | r8i-flex.xlarge | r8i-flex.2xlarge | r8i-flex.4xlarge | r8i-flex.8xlarge | r8i-flex.12xlarge | r8i-flex.16xlarge` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `MaxPrice` The maximum price per unit hour that you are willing to pay for a Spot Instance. We do not recommend using this parameter because it can lead to increased interruptions. If you do not specify this parameter, you will pay the current Spot price. If you specify a maximum price, your instances will be interrupted more frequently than if you do not specify this parameter. If you specify a maximum price, it must be more than USD \$10.001. Specifying a value below USD \$10.001 will result in an `InvalidParameterValue` error message. *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Placement` The location where the instance launched, if applicable. *Required*: No *Type*: [Placement](aws-properties-ec2-ec2fleet-placement.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Priority` The priority for the launch template override. The highest priority is launched first. If the On-Demand `AllocationStrategy` is set to `prioritized`, EC2 Fleet uses priority to determine which launch template override to use first in fulfilling On-Demand capacity. If the Spot `AllocationStrategy` is set to `capacity-optimized-prioritized`, EC2 Fleet uses priority on a best-effort basis to determine which launch template override to use in fulfilling Spot capacity, but optimizes for capacity first. Valid values are whole numbers starting at `0`. The lower the number, the higher the priority. If no number is set, the launch template override has the lowest priority. You can set the same priority for different launch template overrides. *Required*: No *Type*: Number *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `SubnetId` The IDs of the subnets in which to launch the instances. Separate multiple subnet IDs using commas (for example, `subnet-1234abcdeexample1, subnet-0987cdef6example2`). A request of type `instant` can have only one subnet ID. *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `WeightedCapacity` The number of units provided by the specified instance type. These are the same units that you chose to set the target capacity in terms of instances, or a performance characteristic such as vCPUs, memory, or I/O. If the target capacity divided by this value is not a whole number, Amazon EC2 rounds the number of instances to the next whole number. If this value is not specified, the default is 1. When specifying weights, the price used in the `lowest-price` and `price-capacity-optimized` allocation strategies is per *unit* hour (where the instance price is divided by the specified weight). However, if all the specified weights are above the requested `TargetCapacity`, resulting in only 1 instance being launched, the price used is per *instance* hour. *Required*: No *Type*: Number *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) ## See also + [ FleetLaunchTemplateOverridesRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_FleetLaunchTemplateOverridesRequest.html) in the *Amazon EC2 API Reference* # AWS::EC2::EC2Fleet FleetLaunchTemplateSpecificationRequest Specifies the launch template to be used by the EC2 Fleet for configuring Amazon EC2 instances. You must specify the following: + The ID or the name of the launch template, but not both. + The version of the launch template. `FleetLaunchTemplateSpecificationRequest` is a property of the [FleetLaunchTemplateConfigRequest](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-fleetlaunchtemplateconfigrequest.html) property type. For information about creating a launch template, see [AWS::EC2::LaunchTemplate](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-launchtemplate.html) and [Create a launch template](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#create-launch-template) in the *Amazon EC2 User Guide*. For examples of launch templates, see [Examples](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-launchtemplate.html#aws-resource-ec2-launchtemplate--examples). ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[LaunchTemplateId](#cfn-ec2-ec2fleet-fleetlaunchtemplatespecificationrequest-launchtemplateid)" : String, "[LaunchTemplateName](#cfn-ec2-ec2fleet-fleetlaunchtemplatespecificationrequest-launchtemplatename)" : String, "[Version](#cfn-ec2-ec2fleet-fleetlaunchtemplatespecificationrequest-version)" : String } ``` ### YAML ``` [LaunchTemplateId](#cfn-ec2-ec2fleet-fleetlaunchtemplatespecificationrequest-launchtemplateid): String [LaunchTemplateName](#cfn-ec2-ec2fleet-fleetlaunchtemplatespecificationrequest-launchtemplatename): String [Version](#cfn-ec2-ec2fleet-fleetlaunchtemplatespecificationrequest-version): String ``` ## Properties `LaunchTemplateId` The ID of the launch template. You must specify the `LaunchTemplateId` or the `LaunchTemplateName`, but not both. *Required*: Conditional *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `LaunchTemplateName` The name of the launch template. You must specify the `LaunchTemplateName` or the `LaunchTemplateId`, but not both. *Required*: Conditional *Type*: String *Pattern*: `[a-zA-Z0-9\.\-/_]+` *Minimum*: `3` *Maximum*: `128` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Version` The launch template version number, `$Latest`, or `$Default`. You must specify a value, otherwise the request fails. If the value is `$Latest`, Amazon EC2 uses the latest version of the launch template. If the value is `$Default`, Amazon EC2 uses the default version of the launch template. *Required*: Yes *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) ## See also + [ FleetLaunchTemplateSpecificationRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_FleetLaunchTemplateSpecificationRequest.html) in the *Amazon EC2 API Reference* # AWS::EC2::EC2Fleet InstanceRequirementsRequest The attributes for the instance types. When you specify instance attributes, Amazon EC2 will identify instance types with these attributes. You must specify `VCpuCount` and `MemoryMiB`. All other attributes are optional. Any unspecified optional attribute is set to its default. When you specify multiple attributes, you get instance types that satisfy all of the specified attributes. If you specify multiple values for an attribute, you get instance types that satisfy any of the specified values. To limit the list of instance types from which Amazon EC2 can identify matching instance types, you can use one of the following parameters, but not both in the same request: + `AllowedInstanceTypes` - The instance types to include in the list. All other instance types are ignored, even if they match your specified attributes. + `ExcludedInstanceTypes` - The instance types to exclude from the list, even if they match your specified attributes. **Note** If you specify `InstanceRequirements`, you can't specify `InstanceType`. Attribute-based instance type selection is only supported when using Auto Scaling groups, EC2 Fleet, and Spot Fleet to launch instances. If you plan to use the launch template in the [launch instance wizard](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-instance-wizard.html), or with the [RunInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html) API or [AWS::EC2::Instance](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html)AWS CloudFormation resource, you can't specify `InstanceRequirements`. For more information, see [Specify attributes for instance type selection for EC2 Fleet or Spot Fleet](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-fleet-attribute-based-instance-type-selection.html) and [Spot placement score](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-placement-score.html) in the *Amazon EC2 User Guide*. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[AcceleratorCount](#cfn-ec2-ec2fleet-instancerequirementsrequest-acceleratorcount)" : AcceleratorCountRequest, "[AcceleratorManufacturers](#cfn-ec2-ec2fleet-instancerequirementsrequest-acceleratormanufacturers)" : [ String, ... ], "[AcceleratorNames](#cfn-ec2-ec2fleet-instancerequirementsrequest-acceleratornames)" : [ String, ... ], "[AcceleratorTotalMemoryMiB](#cfn-ec2-ec2fleet-instancerequirementsrequest-acceleratortotalmemorymib)" : AcceleratorTotalMemoryMiBRequest, "[AcceleratorTypes](#cfn-ec2-ec2fleet-instancerequirementsrequest-acceleratortypes)" : [ String, ... ], "[AllowedInstanceTypes](#cfn-ec2-ec2fleet-instancerequirementsrequest-allowedinstancetypes)" : [ String, ... ], "[BareMetal](#cfn-ec2-ec2fleet-instancerequirementsrequest-baremetal)" : String, "[BaselineEbsBandwidthMbps](#cfn-ec2-ec2fleet-instancerequirementsrequest-baselineebsbandwidthmbps)" : BaselineEbsBandwidthMbpsRequest, "[BaselinePerformanceFactors](#cfn-ec2-ec2fleet-instancerequirementsrequest-baselineperformancefactors)" : BaselinePerformanceFactorsRequest, "[BurstablePerformance](#cfn-ec2-ec2fleet-instancerequirementsrequest-burstableperformance)" : String, "[CpuManufacturers](#cfn-ec2-ec2fleet-instancerequirementsrequest-cpumanufacturers)" : [ String, ... ], "[ExcludedInstanceTypes](#cfn-ec2-ec2fleet-instancerequirementsrequest-excludedinstancetypes)" : [ String, ... ], "[InstanceGenerations](#cfn-ec2-ec2fleet-instancerequirementsrequest-instancegenerations)" : [ String, ... ], "[LocalStorage](#cfn-ec2-ec2fleet-instancerequirementsrequest-localstorage)" : String, "[LocalStorageTypes](#cfn-ec2-ec2fleet-instancerequirementsrequest-localstoragetypes)" : [ String, ... ], "[MaxSpotPriceAsPercentageOfOptimalOnDemandPrice](#cfn-ec2-ec2fleet-instancerequirementsrequest-maxspotpriceaspercentageofoptimalondemandprice)" : Integer, "[MemoryGiBPerVCpu](#cfn-ec2-ec2fleet-instancerequirementsrequest-memorygibpervcpu)" : MemoryGiBPerVCpuRequest, "[MemoryMiB](#cfn-ec2-ec2fleet-instancerequirementsrequest-memorymib)" : MemoryMiBRequest, "[NetworkBandwidthGbps](#cfn-ec2-ec2fleet-instancerequirementsrequest-networkbandwidthgbps)" : NetworkBandwidthGbpsRequest, "[NetworkInterfaceCount](#cfn-ec2-ec2fleet-instancerequirementsrequest-networkinterfacecount)" : NetworkInterfaceCountRequest, "[OnDemandMaxPricePercentageOverLowestPrice](#cfn-ec2-ec2fleet-instancerequirementsrequest-ondemandmaxpricepercentageoverlowestprice)" : Integer, "[RequireEncryptionInTransit](#cfn-ec2-ec2fleet-instancerequirementsrequest-requireencryptionintransit)" : Boolean, "[RequireHibernateSupport](#cfn-ec2-ec2fleet-instancerequirementsrequest-requirehibernatesupport)" : Boolean, "[SpotMaxPricePercentageOverLowestPrice](#cfn-ec2-ec2fleet-instancerequirementsrequest-spotmaxpricepercentageoverlowestprice)" : Integer, "[TotalLocalStorageGB](#cfn-ec2-ec2fleet-instancerequirementsrequest-totallocalstoragegb)" : TotalLocalStorageGBRequest, "[VCpuCount](#cfn-ec2-ec2fleet-instancerequirementsrequest-vcpucount)" : VCpuCountRangeRequest } ``` ### YAML ``` [AcceleratorCount](#cfn-ec2-ec2fleet-instancerequirementsrequest-acceleratorcount): AcceleratorCountRequest [AcceleratorManufacturers](#cfn-ec2-ec2fleet-instancerequirementsrequest-acceleratormanufacturers): - String [AcceleratorNames](#cfn-ec2-ec2fleet-instancerequirementsrequest-acceleratornames): - String [AcceleratorTotalMemoryMiB](#cfn-ec2-ec2fleet-instancerequirementsrequest-acceleratortotalmemorymib): AcceleratorTotalMemoryMiBRequest [AcceleratorTypes](#cfn-ec2-ec2fleet-instancerequirementsrequest-acceleratortypes): - String [AllowedInstanceTypes](#cfn-ec2-ec2fleet-instancerequirementsrequest-allowedinstancetypes): - String [BareMetal](#cfn-ec2-ec2fleet-instancerequirementsrequest-baremetal): String [BaselineEbsBandwidthMbps](#cfn-ec2-ec2fleet-instancerequirementsrequest-baselineebsbandwidthmbps): BaselineEbsBandwidthMbpsRequest [BaselinePerformanceFactors](#cfn-ec2-ec2fleet-instancerequirementsrequest-baselineperformancefactors): BaselinePerformanceFactorsRequest [BurstablePerformance](#cfn-ec2-ec2fleet-instancerequirementsrequest-burstableperformance): String [CpuManufacturers](#cfn-ec2-ec2fleet-instancerequirementsrequest-cpumanufacturers): - String [ExcludedInstanceTypes](#cfn-ec2-ec2fleet-instancerequirementsrequest-excludedinstancetypes): - String [InstanceGenerations](#cfn-ec2-ec2fleet-instancerequirementsrequest-instancegenerations): - String [LocalStorage](#cfn-ec2-ec2fleet-instancerequirementsrequest-localstorage): String [LocalStorageTypes](#cfn-ec2-ec2fleet-instancerequirementsrequest-localstoragetypes): - String [MaxSpotPriceAsPercentageOfOptimalOnDemandPrice](#cfn-ec2-ec2fleet-instancerequirementsrequest-maxspotpriceaspercentageofoptimalondemandprice): Integer [MemoryGiBPerVCpu](#cfn-ec2-ec2fleet-instancerequirementsrequest-memorygibpervcpu): MemoryGiBPerVCpuRequest [MemoryMiB](#cfn-ec2-ec2fleet-instancerequirementsrequest-memorymib): MemoryMiBRequest [NetworkBandwidthGbps](#cfn-ec2-ec2fleet-instancerequirementsrequest-networkbandwidthgbps): NetworkBandwidthGbpsRequest [NetworkInterfaceCount](#cfn-ec2-ec2fleet-instancerequirementsrequest-networkinterfacecount): NetworkInterfaceCountRequest [OnDemandMaxPricePercentageOverLowestPrice](#cfn-ec2-ec2fleet-instancerequirementsrequest-ondemandmaxpricepercentageoverlowestprice): Integer [RequireEncryptionInTransit](#cfn-ec2-ec2fleet-instancerequirementsrequest-requireencryptionintransit): Boolean [RequireHibernateSupport](#cfn-ec2-ec2fleet-instancerequirementsrequest-requirehibernatesupport): Boolean [SpotMaxPricePercentageOverLowestPrice](#cfn-ec2-ec2fleet-instancerequirementsrequest-spotmaxpricepercentageoverlowestprice): Integer [TotalLocalStorageGB](#cfn-ec2-ec2fleet-instancerequirementsrequest-totallocalstoragegb): TotalLocalStorageGBRequest [VCpuCount](#cfn-ec2-ec2fleet-instancerequirementsrequest-vcpucount): VCpuCountRangeRequest ``` ## Properties `AcceleratorCount` The minimum and maximum number of accelerators (GPUs, FPGAs, or AWS Inferentia chips) on an instance. To exclude accelerator-enabled instance types, set `Max` to `0`. Default: No minimum or maximum limits *Required*: No *Type*: [AcceleratorCountRequest](aws-properties-ec2-ec2fleet-acceleratorcountrequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `AcceleratorManufacturers` Indicates whether instance types must have accelerators by specific manufacturers. + For instance types with AWS 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 *Required*: No *Type*: Array of String *Allowed values*: `amazon-web-services | amd | habana | nvidia | xilinx` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `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 AWS Inferentia chips, specify `inferentia`. + For instance types with AWS Inferentia2 chips, specify `inferentia2`. + For instance types with Habana Gaudi HL-205 GPUs, specify `gaudi-hl-205`. + For instance types with NVIDIA GRID K520 GPUs, specify `k520`. + For instance types with NVIDIA K80 GPUs, specify `k80`. + For instance types with NVIDIA L4 GPUs, specify `l4`. + For instance types with NVIDIA L40S GPUs, specify `l40s`. + 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 AWS Trainium chips, specify `trainium`. + For instance types with AWS Trainium2 chips, specify `trainium2`. + For instance types with NVIDIA T4 GPUs, specify `t4`. + For instance types with NVIDIA T4G GPUs, specify `t4g`. + For instance types with Xilinx U30 cards, specify `u30`. + For instance types with Xilinx VU9P FPGAs, specify `vu9p`. + For instance types with NVIDIA V100 GPUs, specify `v100`. Default: Any accelerator *Required*: No *Type*: Array of String *Allowed values*: `a10g | a100 | h100 | inferentia | k520 | k80 | m60 | radeon-pro-v520 | t4 | t4g | vu9p | v100 | l40s | l4 | gaudi-hl-205 | inferentia2 | trainium | trainium2 | u30` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `AcceleratorTotalMemoryMiB` The minimum and maximum amount of total accelerator memory, in MiB. Default: No minimum or maximum limits *Required*: No *Type*: [AcceleratorTotalMemoryMiBRequest](aws-properties-ec2-ec2fleet-acceleratortotalmemorymibrequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `AcceleratorTypes` The accelerator types that must be on the instance type. + For instance types with FPGA accelerators, specify `fpga`. + For instance types with GPU accelerators, specify `gpu`. + For instance types with Inference accelerators, specify `inference`. + For instance types with Media accelerators, specify `media`. Default: Any accelerator type *Required*: No *Type*: Array of String *Allowed values*: `gpu | fpga | inference | media` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `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 specify `m5a.*`, Amazon EC2 will allow all the M5a instance types, but not the M5n instance types. If you specify `AllowedInstanceTypes`, you can't specify `ExcludedInstanceTypes`. Default: All instance types *Required*: No *Type*: Array of String *Minimum*: `1` *Maximum*: `30` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `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` *Required*: No *Type*: String *Allowed values*: `included | required | excluded` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `BaselineEbsBandwidthMbps` The minimum and maximum baseline bandwidth to Amazon EBS, in Mbps. For more information, see [Amazon EBS–optimized instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-optimized.html) in the *Amazon EC2 User Guide*. Default: No minimum or maximum limits *Required*: No *Type*: [BaselineEbsBandwidthMbpsRequest](aws-properties-ec2-ec2fleet-baselineebsbandwidthmbpsrequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `BaselinePerformanceFactors` The baseline performance to consider, using an instance family as a baseline reference. The instance family establishes the lowest acceptable level of performance. Amazon EC2 uses this baseline to guide instance type selection, but there is no guarantee that the selected instance types will always exceed the baseline for every application. Currently, this parameter only supports CPU performance as a baseline performance factor. For more information, see [Performance protection](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-fleet-attribute-based-instance-type-selection.html#ec2fleet-abis-performance-protection) in the *Amazon EC2 User Guide*. *Required*: No *Type*: [BaselinePerformanceFactorsRequest](aws-properties-ec2-ec2fleet-baselineperformancefactorsrequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `BurstablePerformance` Indicates whether burstable performance T instance types are included, excluded, or required. For more information, see [Burstable performance instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances.html). + 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` *Required*: No *Type*: String *Allowed values*: `included | required | excluded` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `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 AWS CPUs, specify `amazon-web-services`. + For instance types with Apple CPUs, specify `apple`. 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 *Required*: No *Type*: Array of String *Allowed values*: `intel | amd | amazon-web-services | apple` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `ExcludedInstanceTypes` The instance types to exclude. You can use strings with one or more wild cards, represented by an asterisk (`*`), to exclude an instance family, type, size, or generation. The following are examples: `m5.8xlarge`, `c5*.*`, `m5a.*`, `r*`, `*3*`. For example, if you specify `c5*`,Amazon EC2 will exclude the entire C5 instance family, which includes all C5a and C5n instance types. If you specify `m5a.*`, Amazon EC2 will exclude all the M5a instance types, but not the M5n instance types. If you specify `ExcludedInstanceTypes`, you can't specify `AllowedInstanceTypes`. Default: No excluded instance types *Required*: No *Type*: Array of String *Minimum*: `1` *Maximum*: `30` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `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](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html) 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 *Required*: No *Type*: Array of String *Allowed values*: `current | previous` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `LocalStorage` Indicates whether instance types with instance store volumes are included, excluded, or required. For more information, [Amazon EC2 instance store](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html) 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` *Required*: No *Type*: String *Allowed values*: `included | required | excluded` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `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` and `ssd` *Required*: No *Type*: Array of String *Allowed values*: `hdd | ssd` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `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 `TargetCapacityUnitType` to `vcpu` or `memory-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` or `MaxSpotPriceAsPercentageOfOptimalOnDemandPrice` 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 as `999999`. *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `MemoryGiBPerVCpu` The minimum and maximum amount of memory per vCPU, in GiB. Default: No minimum or maximum limits *Required*: No *Type*: [MemoryGiBPerVCpuRequest](aws-properties-ec2-ec2fleet-memorygibpervcpurequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `MemoryMiB` The minimum and maximum amount of memory, in MiB. *Required*: No *Type*: [MemoryMiBRequest](aws-properties-ec2-ec2fleet-memorymibrequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `NetworkBandwidthGbps` The minimum and maximum amount of baseline network bandwidth, in gigabits per second (Gbps). For more information, see [Amazon EC2 instance network bandwidth](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-network-bandwidth.html) in the *Amazon EC2 User Guide*. Default: No minimum or maximum limits *Required*: No *Type*: [NetworkBandwidthGbpsRequest](aws-properties-ec2-ec2fleet-networkbandwidthgbpsrequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `NetworkInterfaceCount` The minimum and maximum number of network interfaces. Default: No minimum or maximum limits *Required*: No *Type*: [NetworkInterfaceCountRequest](aws-properties-ec2-ec2fleet-networkinterfacecountrequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `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 indicate no price protection threshold, specify a high value, such as `999999`. This parameter is not supported for [GetSpotPlacementScores](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetSpotPlacementScores.html) and [GetInstanceTypesFromInstanceRequirements](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetInstanceTypesFromInstanceRequirements.html). If you set `TargetCapacityUnitType` to `vcpu` or `memory-mib`, the price protection threshold is applied based on the per-vCPU or per-memory price instead of the per-instance price. Default: `20` *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `RequireEncryptionInTransit` Specifies whether instance types must support encrypting in-transit traffic between instances. For more information, including the supported instance types, see [Encryption in transit](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/data-protection.html#encryption-transit) in the *Amazon EC2 User Guide*. Default: `false` *Required*: No *Type*: Boolean *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `RequireHibernateSupport` Indicates whether instance types must support hibernation for On-Demand Instances. This parameter is not supported for [GetSpotPlacementScores](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetSpotPlacementScores.html). Default: `false` *Required*: No *Type*: Boolean *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `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` to `vcpu` or `memory-mib`, the price protection threshold is applied based on the per-vCPU or per-memory price instead of the per-instance price. This parameter is not supported for [GetSpotPlacementScores](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetSpotPlacementScores.html) and [GetInstanceTypesFromInstanceRequirements](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetInstanceTypesFromInstanceRequirements.html). Only one of `SpotMaxPricePercentageOverLowestPrice` or `MaxSpotPriceAsPercentageOfOptimalOnDemandPrice` 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 as `999999`. Default: `100` *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `TotalLocalStorageGB` The minimum and maximum amount of total local storage, in GB. Default: No minimum or maximum limits *Required*: No *Type*: [TotalLocalStorageGBRequest](aws-properties-ec2-ec2fleet-totallocalstoragegbrequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `VCpuCount` The minimum and maximum number of vCPUs. *Required*: No *Type*: [VCpuCountRangeRequest](aws-properties-ec2-ec2fleet-vcpucountrangerequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet MaintenanceStrategies The strategies for managing your Spot Instances that are at an elevated risk of being interrupted. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[CapacityRebalance](#cfn-ec2-ec2fleet-maintenancestrategies-capacityrebalance)" : CapacityRebalance } ``` ### YAML ``` [CapacityRebalance](#cfn-ec2-ec2fleet-maintenancestrategies-capacityrebalance): CapacityRebalance ``` ## Properties `CapacityRebalance` The strategy to use when Amazon EC2 emits a signal that your Spot Instance is at an elevated risk of being interrupted. *Required*: No *Type*: [CapacityRebalance](aws-properties-ec2-ec2fleet-capacityrebalance.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet MemoryGiBPerVCpuRequest The minimum and maximum amount of memory per vCPU, in GiB. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Max](#cfn-ec2-ec2fleet-memorygibpervcpurequest-max)" : Number, "[Min](#cfn-ec2-ec2fleet-memorygibpervcpurequest-min)" : Number } ``` ### YAML ``` [Max](#cfn-ec2-ec2fleet-memorygibpervcpurequest-max): Number [Min](#cfn-ec2-ec2fleet-memorygibpervcpurequest-min): Number ``` ## Properties `Max` The maximum amount of memory per vCPU, in GiB. To specify no maximum limit, omit this parameter. *Required*: No *Type*: Number *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Min` The minimum amount of memory per vCPU, in GiB. To specify no minimum limit, omit this parameter. *Required*: No *Type*: Number *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet MemoryMiBRequest The minimum and maximum amount of memory, in MiB. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Max](#cfn-ec2-ec2fleet-memorymibrequest-max)" : Integer, "[Min](#cfn-ec2-ec2fleet-memorymibrequest-min)" : Integer } ``` ### YAML ``` [Max](#cfn-ec2-ec2fleet-memorymibrequest-max): Integer [Min](#cfn-ec2-ec2fleet-memorymibrequest-min): Integer ``` ## Properties `Max` The maximum amount of memory, in MiB. To specify no maximum limit, omit this parameter. *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Min` The minimum amount of memory, in MiB. To specify no minimum limit, specify `0`. *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet NetworkBandwidthGbpsRequest The minimum and maximum amount of network bandwidth, in gigabits per second (Gbps). **Note** Setting the minimum bandwidth does not guarantee that your instance will achieve the minimum bandwidth. Amazon EC2 will identify instance types that support the specified minimum bandwidth, but the actual bandwidth of your instance might go below the specified minimum at times. For more information, see [Available instance bandwidth](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-network-bandwidth.html#available-instance-bandwidth) in the *Amazon EC2 User Guide*. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Max](#cfn-ec2-ec2fleet-networkbandwidthgbpsrequest-max)" : Number, "[Min](#cfn-ec2-ec2fleet-networkbandwidthgbpsrequest-min)" : Number } ``` ### YAML ``` [Max](#cfn-ec2-ec2fleet-networkbandwidthgbpsrequest-max): Number [Min](#cfn-ec2-ec2fleet-networkbandwidthgbpsrequest-min): Number ``` ## Properties `Max` The maximum amount of network bandwidth, in Gbps. To specify no maximum limit, omit this parameter. *Required*: No *Type*: Number *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Min` The minimum amount of network bandwidth, in Gbps. To specify no minimum limit, omit this parameter. *Required*: No *Type*: Number *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet NetworkInterfaceCountRequest The minimum and maximum number of network interfaces. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Max](#cfn-ec2-ec2fleet-networkinterfacecountrequest-max)" : Integer, "[Min](#cfn-ec2-ec2fleet-networkinterfacecountrequest-min)" : Integer } ``` ### YAML ``` [Max](#cfn-ec2-ec2fleet-networkinterfacecountrequest-max): Integer [Min](#cfn-ec2-ec2fleet-networkinterfacecountrequest-min): Integer ``` ## Properties `Max` The maximum number of network interfaces. To specify no maximum limit, omit this parameter. *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Min` The minimum number of network interfaces. To specify no minimum limit, omit this parameter. *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet OnDemandOptionsRequest Specifies the allocation strategy of On-Demand Instances in an EC2 Fleet. `OnDemandOptionsRequest` is a property of the [AWS::EC2::EC2Fleet](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-ec2fleet.html) resource. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[AllocationStrategy](#cfn-ec2-ec2fleet-ondemandoptionsrequest-allocationstrategy)" : String, "[CapacityReservationOptions](#cfn-ec2-ec2fleet-ondemandoptionsrequest-capacityreservationoptions)" : CapacityReservationOptionsRequest, "[MaxTotalPrice](#cfn-ec2-ec2fleet-ondemandoptionsrequest-maxtotalprice)" : String, "[MinTargetCapacity](#cfn-ec2-ec2fleet-ondemandoptionsrequest-mintargetcapacity)" : Integer, "[SingleAvailabilityZone](#cfn-ec2-ec2fleet-ondemandoptionsrequest-singleavailabilityzone)" : Boolean, "[SingleInstanceType](#cfn-ec2-ec2fleet-ondemandoptionsrequest-singleinstancetype)" : Boolean } ``` ### YAML ``` [AllocationStrategy](#cfn-ec2-ec2fleet-ondemandoptionsrequest-allocationstrategy): String [CapacityReservationOptions](#cfn-ec2-ec2fleet-ondemandoptionsrequest-capacityreservationoptions): CapacityReservationOptionsRequest [MaxTotalPrice](#cfn-ec2-ec2fleet-ondemandoptionsrequest-maxtotalprice): String [MinTargetCapacity](#cfn-ec2-ec2fleet-ondemandoptionsrequest-mintargetcapacity): Integer [SingleAvailabilityZone](#cfn-ec2-ec2fleet-ondemandoptionsrequest-singleavailabilityzone): Boolean [SingleInstanceType](#cfn-ec2-ec2fleet-ondemandoptionsrequest-singleinstancetype): Boolean ``` ## Properties `AllocationStrategy` The strategy that determines the order of the launch template overrides to use in fulfilling On-Demand capacity. `lowest-price` - EC2 Fleet uses price to determine the order, launching the lowest price first. `prioritized` - EC2 Fleet uses the priority that you assigned to each launch template override, launching the highest priority first. Default: `lowest-price` *Required*: No *Type*: String *Allowed values*: `lowest-price | prioritized` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `CapacityReservationOptions` The strategy for using unused Capacity Reservations for fulfilling On-Demand capacity. Supported only for fleets of type `instant`. *Required*: No *Type*: [CapacityReservationOptionsRequest](aws-properties-ec2-ec2fleet-capacityreservationoptionsrequest.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `MaxTotalPrice` The maximum amount per hour for On-Demand Instances that you're willing to pay. If your fleet includes T instances that are configured as `unlimited`, and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The `MaxTotalPrice` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for `MaxTotalPrice`. For more information, see [Surplus credits can incur charges](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits) in the *Amazon EC2 User Guide*. *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `MinTargetCapacity` The minimum target capacity for On-Demand Instances in the fleet. If this minimum capacity isn't reached, no instances are launched. Constraints: Maximum value of `1000`. Supported only for fleets of type `instant`. At least one of the following must be specified: `SingleAvailabilityZone` \$1 `SingleInstanceType` *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `SingleAvailabilityZone` Indicates that the fleet launches all On-Demand Instances into a single Availability Zone. Supported only for fleets of type `instant`. *Required*: No *Type*: Boolean *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `SingleInstanceType` Indicates that the fleet uses a single instance type to launch all On-Demand Instances in the fleet. Supported only for fleets of type `instant`. *Required*: No *Type*: Boolean *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) ## See also + [ OnDemandOptionsRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_OnDemandOptionsRequest.html) in the *Amazon EC2 API Reference* # AWS::EC2::EC2Fleet PerformanceFactorReferenceRequest Specify an instance family to use as the baseline reference for CPU performance. All instance types that match your specified attributes will be compared against the CPU performance of the referenced instance family, regardless of CPU manufacturer or architecture. **Note** Currently, only one instance family can be specified in the list. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[InstanceFamily](#cfn-ec2-ec2fleet-performancefactorreferencerequest-instancefamily)" : String } ``` ### YAML ``` [InstanceFamily](#cfn-ec2-ec2fleet-performancefactorreferencerequest-instancefamily): String ``` ## Properties `InstanceFamily` The instance family to use as a baseline reference. Ensure that you specify the correct value for the instance family. The instance family is everything before the period (`.`) in the instance type name. For example, in the instance type `c6i.large`, the instance family is `c6i`, not `c6`. For more information, see [Amazon EC2 instance type naming conventions](https://docs.aws.amazon.com/ec2/latest/instancetypes/instance-type-names.html) in *Amazon EC2 Instance Types*. The following instance families are *not supported* for performance protection: + `c1` + `g3` \$1 `g3s` + `hpc7g` + `m1` \$1 `m2` + `mac1` \$1 `mac2` \$1 `mac2-m1ultra` \$1 `mac2-m2` \$1 `mac2-m2pro` + `p3dn` \$1 `p4d` \$1 `p5` + `t1` + `u-12tb1` \$1 `u-18tb1` \$1 `u-24tb1` \$1 `u-3tb1` \$1 `u-6tb1` \$1 `u-9tb1` \$1 `u7i-12tb` \$1 `u7in-16tb` \$1 `u7in-24tb` \$1 `u7in-32tb` If you enable performance protection by specifying a supported instance family, the returned instance types will exclude the above unsupported instance families. If you specify an unsupported instance family as a value for baseline performance, the API returns an empty response response for [GetInstanceTypesFromInstanceRequirements](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetInstanceTypesFromInstanceRequirements.html) and an exception for [CreateFleet](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateFleet.html), [RequestSpotFleet](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotFleet.html), [ModifyFleet](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyFleet.html), and [ModifySpotFleetRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifySpotFleetRequest.html). *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet Placement Describes the placement of an instance. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Affinity](#cfn-ec2-ec2fleet-placement-affinity)" : String, "[AvailabilityZone](#cfn-ec2-ec2fleet-placement-availabilityzone)" : String, "[GroupName](#cfn-ec2-ec2fleet-placement-groupname)" : String, "[HostId](#cfn-ec2-ec2fleet-placement-hostid)" : String, "[HostResourceGroupArn](#cfn-ec2-ec2fleet-placement-hostresourcegrouparn)" : String, "[PartitionNumber](#cfn-ec2-ec2fleet-placement-partitionnumber)" : Integer, "[SpreadDomain](#cfn-ec2-ec2fleet-placement-spreaddomain)" : String, "[Tenancy](#cfn-ec2-ec2fleet-placement-tenancy)" : String } ``` ### YAML ``` [Affinity](#cfn-ec2-ec2fleet-placement-affinity): String [AvailabilityZone](#cfn-ec2-ec2fleet-placement-availabilityzone): String [GroupName](#cfn-ec2-ec2fleet-placement-groupname): String [HostId](#cfn-ec2-ec2fleet-placement-hostid): String [HostResourceGroupArn](#cfn-ec2-ec2fleet-placement-hostresourcegrouparn): String [PartitionNumber](#cfn-ec2-ec2fleet-placement-partitionnumber): Integer [SpreadDomain](#cfn-ec2-ec2fleet-placement-spreaddomain): String [Tenancy](#cfn-ec2-ec2fleet-placement-tenancy): String ``` ## Properties `Affinity` The affinity setting for the instance on the Dedicated Host. This parameter is not supported for [CreateFleet](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateFleet) or [ImportInstance](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ImportInstance.html). *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `AvailabilityZone` The Availability Zone of the instance. On input, you can specify `AvailabilityZone` or `AvailabilityZoneId`, but not both. If you specify neither one, Amazon EC2 automatically selects an Availability Zone for you. This parameter is not supported for [CreateFleet](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateFleet). *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `GroupName` The name of the placement group that the instance is in. On input, you can specify `GroupId` or `GroupName`, but not both. *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `HostId` The ID of the Dedicated Host on which the instance resides. This parameter is not supported for [CreateFleet](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateFleet) or [ImportInstance](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ImportInstance.html). *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `HostResourceGroupArn` The ARN of the host resource group in which to launch the instances. On input, if you specify this parameter, either omit the **Tenancy** parameter or set it to `host`. This parameter is not supported for [CreateFleet](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateFleet). *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `PartitionNumber` The number of the partition that the instance is in. Valid only if the placement group strategy is set to `partition`. This parameter is not supported for [CreateFleet](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateFleet). *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `SpreadDomain` Reserved for future use. *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Tenancy` The tenancy of the instance. An instance with a tenancy of `dedicated` runs on single-tenant hardware. This parameter is not supported for [CreateFleet](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateFleet). The `host` tenancy is not supported for [ImportInstance](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ImportInstance.html) or for T3 instances that are configured for the `unlimited` CPU credit option. *Required*: No *Type*: String *Allowed values*: `default | dedicated | host` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet ReservedCapacityOptionsRequest Defines EC2 Fleet preferences for utilizing reserved capacity when DefaultTargetCapacityType is set to `reserved-capacity`. **Note** This configuration can only be used if the EC2 Fleet is of type `instant`. When you specify `ReservedCapacityOptions`, you must also set `DefaultTargetCapacityType` to `reserved-capacity` in the `TargetCapacitySpecification`. For more information about Interruptible Capacity Reservations, see [Launch instances into an Interruptible Capacity Reservation](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-fleet-launch-instances-interruptible-cr-walkthrough.html) in the *Amazon EC2 User Guide*. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[ReservationTypes](#cfn-ec2-ec2fleet-reservedcapacityoptionsrequest-reservationtypes)" : [ String, ... ] } ``` ### YAML ``` [ReservationTypes](#cfn-ec2-ec2fleet-reservedcapacityoptionsrequest-reservationtypes): - String ``` ## Properties `ReservationTypes` The types of Capacity Reservations to use for fulfilling the EC2 Fleet request. *Required*: No *Type*: Array of String *Allowed values*: `interruptible-capacity-reservation` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet SpotOptionsRequest Specifies the configuration of Spot Instances for an EC2 Fleet. `SpotOptionsRequest` is a property of the [ AWS::EC2::EC2Fleet](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-resource-ec2-ec2fleet.html) resource. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[AllocationStrategy](#cfn-ec2-ec2fleet-spotoptionsrequest-allocationstrategy)" : String, "[InstanceInterruptionBehavior](#cfn-ec2-ec2fleet-spotoptionsrequest-instanceinterruptionbehavior)" : String, "[InstancePoolsToUseCount](#cfn-ec2-ec2fleet-spotoptionsrequest-instancepoolstousecount)" : Integer, "[MaintenanceStrategies](#cfn-ec2-ec2fleet-spotoptionsrequest-maintenancestrategies)" : MaintenanceStrategies, "[MaxTotalPrice](#cfn-ec2-ec2fleet-spotoptionsrequest-maxtotalprice)" : String, "[MinTargetCapacity](#cfn-ec2-ec2fleet-spotoptionsrequest-mintargetcapacity)" : Integer, "[SingleAvailabilityZone](#cfn-ec2-ec2fleet-spotoptionsrequest-singleavailabilityzone)" : Boolean, "[SingleInstanceType](#cfn-ec2-ec2fleet-spotoptionsrequest-singleinstancetype)" : Boolean } ``` ### YAML ``` [AllocationStrategy](#cfn-ec2-ec2fleet-spotoptionsrequest-allocationstrategy): String [InstanceInterruptionBehavior](#cfn-ec2-ec2fleet-spotoptionsrequest-instanceinterruptionbehavior): String [InstancePoolsToUseCount](#cfn-ec2-ec2fleet-spotoptionsrequest-instancepoolstousecount): Integer [MaintenanceStrategies](#cfn-ec2-ec2fleet-spotoptionsrequest-maintenancestrategies): MaintenanceStrategies [MaxTotalPrice](#cfn-ec2-ec2fleet-spotoptionsrequest-maxtotalprice): String [MinTargetCapacity](#cfn-ec2-ec2fleet-spotoptionsrequest-mintargetcapacity): Integer [SingleAvailabilityZone](#cfn-ec2-ec2fleet-spotoptionsrequest-singleavailabilityzone): Boolean [SingleInstanceType](#cfn-ec2-ec2fleet-spotoptionsrequest-singleinstancetype): Boolean ``` ## Properties `AllocationStrategy` Indicates how to allocate the target Spot Instance capacity across the Spot Instance pools specified by the EC2 Fleet. If the allocation strategy is `lowestPrice`, EC2 Fleet launches instances from the Spot Instance pools with the lowest price. This is the default allocation strategy. If the allocation strategy is `diversified`, EC2 Fleet launches instances from all the Spot Instance pools that you specify. If the allocation strategy is `capacityOptimized`, EC2 Fleet launches instances from Spot Instance pools that are optimally chosen based on the available Spot Instance capacity. *Allowed Values*: `lowestPrice` \$1 `diversified` \$1 `capacityOptimized` \$1 `capacityOptimizedPrioritized` *Required*: No *Type*: String *Allowed values*: `lowest-price | lowestPrice | diversified | capacityOptimized | capacity-optimized | capacityOptimizedPrioritized | capacity-optimized-prioritized | priceCapacityOptimized | price-capacity-optimized` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `InstanceInterruptionBehavior` The behavior when a Spot Instance is interrupted. Default: `terminate` *Required*: No *Type*: String *Allowed values*: `hibernate | stop | terminate` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `InstancePoolsToUseCount` The number of Spot pools across which to allocate your target Spot capacity. Supported only when Spot `AllocationStrategy` is set to `lowest-price`. EC2 Fleet selects the cheapest Spot pools and evenly allocates your target Spot capacity across the number of Spot pools that you specify. Note that EC2 Fleet attempts to draw Spot Instances from the number of pools that you specify on a best effort basis. If a pool runs out of Spot capacity before fulfilling your target capacity, EC2 Fleet will continue to fulfill your request by drawing from the next cheapest pool. To ensure that your target capacity is met, you might receive Spot Instances from more than the number of pools that you specified. Similarly, if most of the pools have no Spot capacity, you might receive your full target capacity from fewer than the number of pools that you specified. *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `MaintenanceStrategies` The strategies for managing your Spot Instances that are at an elevated risk of being interrupted. *Required*: No *Type*: [MaintenanceStrategies](aws-properties-ec2-ec2fleet-maintenancestrategies.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `MaxTotalPrice` The maximum amount per hour for Spot Instances that you're willing to pay. We do not recommend using this parameter because it can lead to increased interruptions. If you do not specify this parameter, you will pay the current Spot price. If you specify a maximum price, your Spot Instances will be interrupted more frequently than if you do not specify this parameter. If your fleet includes T instances that are configured as `unlimited`, and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The `MaxTotalPrice` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for `MaxTotalPrice`. For more information, see [Surplus credits can incur charges](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits) in the *Amazon EC2 User Guide*. *Required*: No *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `MinTargetCapacity` The minimum target capacity for Spot Instances in the fleet. If this minimum capacity isn't reached, no instances are launched. Constraints: Maximum value of `1000`. Supported only for fleets of type `instant`. At least one of the following must be specified: `SingleAvailabilityZone` \$1 `SingleInstanceType` *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `SingleAvailabilityZone` Indicates that the fleet launches all Spot Instances into a single Availability Zone. Supported only for fleets of type `instant`. *Required*: No *Type*: Boolean *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `SingleInstanceType` Indicates that the fleet uses a single instance type to launch all Spot Instances in the fleet. Supported only for fleets of type `instant`. *Required*: No *Type*: Boolean *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) ## See also + [ SpotOptionsRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_SpotOptionsRequest.html) in the *Amazon EC2 API Reference* # AWS::EC2::EC2Fleet Tag Specifies a tag. For more information, see [Resource tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html). ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Key](#cfn-ec2-ec2fleet-tag-key)" : String, "[Value](#cfn-ec2-ec2fleet-tag-value)" : String } ``` ### YAML ``` [Key](#cfn-ec2-ec2fleet-tag-key): String [Value](#cfn-ec2-ec2fleet-tag-value): String ``` ## Properties `Key` The tag key. *Required*: Yes *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Value` The tag value. *Required*: Yes *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) ## Examples ### This example specifies two tags for the EC2 Fleet. #### JSON ``` "Tags" : [ { "Key" : "key1", "Value" : "value1" }, { "Key" : "key2", "Value" : "value2" } ] ``` #### YAML ``` Tags: - Key: "key1" Value: "value1" - Key: "key2" Value: "value2" ``` # AWS::EC2::EC2Fleet TagSpecification Specifies the tags to apply to a resource when the resource is being created for an EC2 Fleet. `TagSpecification` is a property of the [ AWS::EC2::EC2Fleet](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-ec2fleet.html) resource. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[ResourceType](#cfn-ec2-ec2fleet-tagspecification-resourcetype)" : String, "[Tags](#cfn-ec2-ec2fleet-tagspecification-tags)" : [ Tag, ... ] } ``` ### YAML ``` [ResourceType](#cfn-ec2-ec2fleet-tagspecification-resourcetype): String [Tags](#cfn-ec2-ec2fleet-tagspecification-tags): - Tag ``` ## Properties `ResourceType` The type of resource to tag. *Required*: No *Type*: String *Allowed values*: `client-vpn-endpoint | customer-gateway | dedicated-host | dhcp-options | egress-only-internet-gateway | elastic-gpu | elastic-ip | export-image-task | export-instance-task | fleet | fpga-image | host-reservation | image | import-image-task | import-snapshot-task | instance | internet-gateway | key-pair | launch-template | local-gateway-route-table-vpc-association | natgateway | network-acl | network-insights-analysis | network-insights-path | network-interface | placement-group | reserved-instances | route-table | security-group | snapshot | spot-fleet-request | spot-instances-request | subnet | traffic-mirror-filter | traffic-mirror-session | traffic-mirror-target | transit-gateway | transit-gateway-attachment | transit-gateway-connect-peer | transit-gateway-multicast-domain | transit-gateway-route-table | volume | vpc | vpc-flow-log | vpc-peering-connection | vpn-connection | vpn-gateway` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Tags` The tags to apply to the resource. *Required*: No *Type*: Array of [Tag](aws-properties-ec2-ec2fleet-tag.md) *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) ## See also + [ TagSpecification](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_TagSpecification.html) in the *Amazon EC2 API Reference* # AWS::EC2::EC2Fleet TargetCapacitySpecificationRequest Specifies the number of units to request for an EC2 Fleet. You can choose to set the target capacity in terms of instances or a performance characteristic that is important to your application workload, such as vCPUs, memory, or I/O. If the request type is `maintain`, you can specify a target capacity of `0` and add capacity later. `TargetCapacitySpecificationRequest` is a property of the [AWS::EC2::EC2Fleet](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-ec2fleet.html) resource. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[DefaultTargetCapacityType](#cfn-ec2-ec2fleet-targetcapacityspecificationrequest-defaulttargetcapacitytype)" : String, "[OnDemandTargetCapacity](#cfn-ec2-ec2fleet-targetcapacityspecificationrequest-ondemandtargetcapacity)" : Integer, "[SpotTargetCapacity](#cfn-ec2-ec2fleet-targetcapacityspecificationrequest-spottargetcapacity)" : Integer, "[TargetCapacityUnitType](#cfn-ec2-ec2fleet-targetcapacityspecificationrequest-targetcapacityunittype)" : String, "[TotalTargetCapacity](#cfn-ec2-ec2fleet-targetcapacityspecificationrequest-totaltargetcapacity)" : Integer } ``` ### YAML ``` [DefaultTargetCapacityType](#cfn-ec2-ec2fleet-targetcapacityspecificationrequest-defaulttargetcapacitytype): String [OnDemandTargetCapacity](#cfn-ec2-ec2fleet-targetcapacityspecificationrequest-ondemandtargetcapacity): Integer [SpotTargetCapacity](#cfn-ec2-ec2fleet-targetcapacityspecificationrequest-spottargetcapacity): Integer [TargetCapacityUnitType](#cfn-ec2-ec2fleet-targetcapacityspecificationrequest-targetcapacityunittype): String [TotalTargetCapacity](#cfn-ec2-ec2fleet-targetcapacityspecificationrequest-totaltargetcapacity): Integer ``` ## Properties `DefaultTargetCapacityType` The default target capacity type. *Required*: No *Type*: String *Allowed values*: `on-demand | spot | capacity-block | reserved-capacity` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `OnDemandTargetCapacity` The number of On-Demand units to request. *Required*: No *Type*: Integer *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `SpotTargetCapacity` The number of Spot units to request. *Required*: No *Type*: Integer *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `TargetCapacityUnitType` The unit for the target capacity. You can specify this parameter only when using attributed-based instance type selection. Default: `units` (the number of instances) *Required*: No *Type*: String *Allowed values*: `vcpu | memory-mib | units` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `TotalTargetCapacity` The number of units to request, filled using the default target capacity type. *Required*: Yes *Type*: Integer *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) ## See also + [ TargetCapacitySpecificationRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_TargetCapacitySpecificationRequest.html) in the *Amazon EC2 API Reference* # AWS::EC2::EC2Fleet TotalLocalStorageGBRequest The minimum and maximum amount of total local storage, in GB. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Max](#cfn-ec2-ec2fleet-totallocalstoragegbrequest-max)" : Number, "[Min](#cfn-ec2-ec2fleet-totallocalstoragegbrequest-min)" : Number } ``` ### YAML ``` [Max](#cfn-ec2-ec2fleet-totallocalstoragegbrequest-max): Number [Min](#cfn-ec2-ec2fleet-totallocalstoragegbrequest-min): Number ``` ## Properties `Max` The maximum amount of total local storage, in GB. To specify no maximum limit, omit this parameter. *Required*: No *Type*: Number *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Min` The minimum amount of total local storage, in GB. To specify no minimum limit, omit this parameter. *Required*: No *Type*: Number *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) # AWS::EC2::EC2Fleet VCpuCountRangeRequest The minimum and maximum number of vCPUs. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Max](#cfn-ec2-ec2fleet-vcpucountrangerequest-max)" : Integer, "[Min](#cfn-ec2-ec2fleet-vcpucountrangerequest-min)" : Integer } ``` ### YAML ``` [Max](#cfn-ec2-ec2fleet-vcpucountrangerequest-max): Integer [Min](#cfn-ec2-ec2fleet-vcpucountrangerequest-min): Integer ``` ## Properties `Max` The maximum number of vCPUs. To specify no maximum limit, omit this parameter. *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Min` The minimum number of vCPUs. To specify no minimum limit, specify `0`. *Required*: No *Type*: Integer *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)