Use AllocateHosts
with a CLI
The following code examples show how to use AllocateHosts
.
- CLI
-
- Amazon CLI
-
Example 1: To allocate a Dedicated Host
The following
allocate-hosts
example allocates a single Dedicated Host in theeu-west-1a
Availability Zone, onto which you can launchm5.large
instances. By default, the Dedicated Host accepts only target instance launches, and does not support host recovery.aws ec2 allocate-hosts \ --instance-type
m5.large
\ --availability-zoneeu-west-1a
\ --quantity1
Output:
{ "HostIds": [ "h-07879acf49EXAMPLE" ] }
Example 2: To allocate a Dedicated Host with auto-placement and host recovery enabled
The following
allocate-hosts
example allocates a single Dedicated Host in theeu-west-1a
Availability Zone with auto-placement and host recovery enabled.aws ec2 allocate-hosts \ --instance-type
m5.large
\ --availability-zoneeu-west-1a
\ --auto-placementon
\ --host-recoveryon
\ --quantity1
Output:
{ "HostIds": [ "h-07879acf49EXAMPLE" ] }
Example 3: To allocate a Dedicated Host with tags
The following
allocate-hosts
example allocates a single Dedicated Host and applies a tag with a key namedpurpose
and a value ofproduction
.aws ec2 allocate-hosts \ --instance-type
m5.large
\ --availability-zoneeu-west-1a
\ --quantity1
\ --tag-specifications 'ResourceType=dedicated-host,Tags={Key=purpose,Value=production}
'Output:
{ "HostIds": [ "h-07879acf49EXAMPLE" ] }
For more information, see Allocating Dedicated Hosts
in the Amazon Elastic Compute Cloud User Guide for Linux Instances. -
For API details, see AllocateHosts
in Amazon CLI Command Reference.
-
- PowerShell
-
- Tools for PowerShell
-
Example 1: This example allocates a Dedicated Host to your account for the given instance type and availability zone
New-EC2Host -AutoPlacement on -AvailabilityZone eu-west-1b -InstanceType m4.xlarge -Quantity 1
Output:
h-01e23f4cd567890f3
-
For API details, see AllocateHosts
in Amazon Tools for PowerShell Cmdlet Reference.
-
For a complete list of Amazon SDK developer guides and code examples, see Create Amazon EC2 resources using an Amazon SDK. This topic also includes information about getting started and details about previous SDK versions.