Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

AWS::EC2::EC2Fleet Placement

Focus mode
AWS::EC2::EC2Fleet Placement - AWS CloudFormation
Filter View

Describes the placement of an instance.

Syntax

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

JSON

{ "Affinity" : String, "AvailabilityZone" : String, "GroupName" : String, "HostId" : String, "HostResourceGroupArn" : String, "PartitionNumber" : Integer, "SpreadDomain" : String, "Tenancy" : String }

YAML

Affinity: String AvailabilityZone: String GroupName: String HostId: String HostResourceGroupArn: String PartitionNumber: Integer SpreadDomain: String Tenancy: String

Properties

Affinity

The affinity setting for the instance on the Dedicated Host.

This parameter is not supported for CreateFleet or ImportInstance.

Required: No

Type: String

Update requires: Replacement

AvailabilityZone

The Availability Zone of the instance.

If not specified, an Availability Zone will be automatically chosen for you based on the load balancing criteria for the Region.

This parameter is not supported for CreateFleet.

Required: No

Type: String

Update requires: Replacement

GroupName

The name of the placement group that the instance is in. If you specify GroupName, you can't specify GroupId.

Required: No

Type: String

Update requires: Replacement

HostId

The ID of the Dedicated Host on which the instance resides.

This parameter is not supported for CreateFleet or ImportInstance.

Required: No

Type: String

Update requires: Replacement

HostResourceGroupArn

The ARN of the host resource group in which to launch the instances.

If you specify this parameter, either omit the Tenancy parameter or set it to host.

This parameter is not supported for CreateFleet.

Required: No

Type: String

Update requires: 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.

Required: No

Type: Integer

Update requires: Replacement

SpreadDomain

Reserved for future use.

Required: No

Type: String

Update requires: 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. The host tenancy is not supported for ImportInstance 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

On this page

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.