There are more AWS SDK examples available in the AWS Doc SDK Examples
Use AllocateHosts
with a CLI
The following code examples show how to use AllocateHosts
.
- CLI
-
- AWS 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 AWS 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 AWS Tools for PowerShell Cmdlet Reference.
-