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 TargetCapacitySpecificationRequest
<a name="aws-properties-ec2-ec2fleet-targetcapacityspecificationrequest"></a>

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
<a name="aws-properties-ec2-ec2fleet-targetcapacityspecificationrequest-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-ec2-ec2fleet-targetcapacityspecificationrequest-syntax.json"></a>

```
{
  "[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
<a name="aws-properties-ec2-ec2fleet-targetcapacityspecificationrequest-syntax.yaml"></a>

```
  [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
<a name="aws-properties-ec2-ec2fleet-targetcapacityspecificationrequest-properties"></a>

`DefaultTargetCapacityType`  <a name="cfn-ec2-ec2fleet-targetcapacityspecificationrequest-defaulttargetcapacitytype"></a>
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`  <a name="cfn-ec2-ec2fleet-targetcapacityspecificationrequest-ondemandtargetcapacity"></a>
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`  <a name="cfn-ec2-ec2fleet-targetcapacityspecificationrequest-spottargetcapacity"></a>
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`  <a name="cfn-ec2-ec2fleet-targetcapacityspecificationrequest-targetcapacityunittype"></a>
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`  <a name="cfn-ec2-ec2fleet-targetcapacityspecificationrequest-totaltargetcapacity"></a>
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
<a name="aws-properties-ec2-ec2fleet-targetcapacityspecificationrequest--seealso"></a>
+ [ TargetCapacitySpecificationRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_TargetCapacitySpecificationRequest.html) in the *Amazon EC2 API Reference*