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-hostsexample allocates a single Dedicated Host in theeu-west-1aAvailability Zone, onto which you can launchm5.largeinstances. By default, the Dedicated Host accepts only target instance launches, and does not support host recovery.aws ec2 allocate-hosts \ --instance-typem5.large\ --availability-zoneeu-west-1a\ --quantity1Output: { "HostIds": [ "h-07879acf49EXAMPLE" ] }Example 2: To allocate a Dedicated Host with auto-placement and host recovery enabled The following allocate-hostsexample allocates a single Dedicated Host in theeu-west-1aAvailability Zone with auto-placement and host recovery enabled.aws ec2 allocate-hosts \ --instance-typem5.large\ --availability-zoneeu-west-1a\ --auto-placementon\ --host-recoveryon\ --quantity1Output: { "HostIds": [ "h-07879acf49EXAMPLE" ] }Example 3: To allocate a Dedicated Host with tags The following allocate-hostsexample allocates a single Dedicated Host and applies a tag with a key namedpurposeand a value ofproduction.aws ec2 allocate-hosts \ --instance-typem5.large\ --availability-zoneeu-west-1a\ --quantity1\ --tag-specifications 'ResourceType=dedicated-host,Tags={Key=purpose,Value=production}'Output: { "HostIds": [ "h-07879acf49EXAMPLE" ] }For more information, see Allocate a Dedicated Host in the Amazon EC2 User Guide. - 
                    For API details, see AllocateHosts in Amazon CLI Command Reference. 
 
- 
                    
 
- PowerShell
- 
            - Tools for PowerShell V4
- 
             
                    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 1Output: h-01e23f4cd567890f3- 
                    For API details, see AllocateHosts in Amazon Tools for PowerShell Cmdlet Reference (V4). 
 
- 
                    
- Tools for PowerShell V5
- 
             
                    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 1Output: h-01e23f4cd567890f3- 
                    For API details, see AllocateHosts in Amazon Tools for PowerShell Cmdlet Reference (V5). 
 
- 
                    
 
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.