Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions,
see Getting Started with Amazon Web Services in China
(PDF).
Work with Dedicated Hosts
To use a Dedicated Host, you first allocate hosts for use in your account. You then launch
instances onto the hosts by specifying host tenancy for the
instance. You must select a specific host for the instance to launch on to, or you can
allow it to launch on to any host that has auto-placement enabled and matches its
instance type. When an instance is stopped and restarted, the Host
affinity setting determines whether it's restarted on the same, or a
different, host.
If you no longer need an On-Demand host, you can stop the instances running on the
host, direct them to launch on a different host, and then release
the host.
Dedicated Hosts are also integrated with Amazon License Manager. With License Manager, you can create a host resource
group, which is a collection of Dedicated Hosts that are managed as a single entity. When creating
a host resource group, you specify the host management preferences, such as
auto-allocate and auto-release, for the Dedicated Hosts. This allows you to launch instances onto
Dedicated Hosts without manually allocating and managing those hosts. For more information, see
Host Resource
Groups in the Amazon License Manager User Guide.
Allocate Dedicated Hosts
To begin using Dedicated Hosts, you must allocate Dedicated Hosts in your account using the Amazon EC2
console or the command line tools. After you allocate the Dedicated Host, the Dedicated Host capacity is
made available in your account immediately and you can start launching instances
onto the Dedicated Host.
Support for multiple instance sizes of the same instance family on the same
Dedicated Host is available for the following instance families: A1, C5, M5, R5, C5n, M5n, R5n, and T3. Other instance families support only one instance size on the
same Dedicated Host.
Due to a hardware limitation with N-type Dedicated Hosts, such as C5n, M5n, and R5n, you
cannot mix smaller instance sizes (large
, xlarge
, and
2xlarge
) with larger instance sizes (4xlarge
,
9xlarge
, 18xlarge
, and .metal
). If you
require smaller and larger instance sizes on N-type hosts at the same time, you must
allocate separate hosts for the smaller and larger instance sizes.
You can allocate a Dedicated Host using the following methods.
- New console
-
To allocate a Dedicated Host
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
In the navigation pane, choose Dedicated Hosts and
then choose Allocate Dedicated Host.
-
For Instance family, choose the instance
family for the Dedicated Host.
-
Specify whether the Dedicated Host supports multiple instance sizes
within the selected instance family, or a specific instance type
only. Do one of the following.
-
To configure the Dedicated Host to support multiple instance
types in the selected instance family, for
Support multiple instance
types, choose Enable.
Enabling this allows you to launch different instance
sizes from the same instance family onto the Dedicated Host. For
example, if you choose the m5
instance
family and choose this option, you can launch
m5.xlarge
and m5.4xlarge
instances onto the Dedicated Host.
-
To configure the Dedicated Host to support a single instance
type within the selected instance family, clear
Support multiple instance
types, and then for Instance
type, choose the instance type to
support. This allows you to launch a single instance
type on the Dedicated Host. For example, if you choose this option
and specify m5.4xlarge
as the supported
instance type, you can launch only
m5.4xlarge
instances onto the
Dedicated Host.
-
For Availability Zone, choose the
Availability Zone in which to allocate the Dedicated Host.
-
To allow the Dedicated Host to accept untargeted instance launches that
match its instance type, for Instance
auto-placement, choose
Enable. For more information about
auto-placement, see Understand auto-placement and
affinity.
-
To enable host recovery for the Dedicated Host, for Host
recovery, choose Enable. For
more information, see Host recovery.
-
For Quantity, enter the number of Dedicated Hosts
to allocate.
-
(Optional) Choose Add new tag and enter a
tag key and a tag value.
-
Choose Allocate.
- Old console
-
To allocate a Dedicated Host
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
In the navigation pane, choose Dedicated Hosts,
Allocate Dedicated Host.
-
For Instance family, choose the instance
family for the Dedicated Host.
-
Specify whether the Dedicated Host supports multiple instance sizes
within the selected instance family, or a specific instance type
only. Do one of the following.
-
To configure the Dedicated Host to support multiple instance
types in the selected instance family, select
Support multiple instance
types. Enabling this allows you to launch
different instance sizes from the same instance family
onto the Dedicated Host. For example, if you choose the
m5
instance family and choose this
option, you can launch m5.xlarge
and
m5.4xlarge
instances onto the Dedicated Host. The
instance family must be powered by the Nitro
System.
-
To configure the Dedicated Host to support a single instance
type within the selected instance family, clear
Support multiple instance
types, and then for Instance
type, choose the instance type to
support. This allows you to launch a single instance
type on the Dedicated Host. For example, if you choose this option
and specify m5.4xlarge
as the supported
instance type, you can launch only
m5.4xlarge
instances onto the
Dedicated Host.
-
For Availability Zone, choose the
Availability Zone in which to allocate the Dedicated Host.
-
To allow the Dedicated Host to accept untargeted instance launches that
match its instance type, for Instance
auto-placement, choose
Enable. For more information about
auto-placement, see Understand auto-placement and
affinity.
-
To enable host recovery for the Dedicated Host, for Host
recovery choose Enable. For
more information, see Host recovery.
-
For Quantity, enter the number of Dedicated Hosts
to allocate.
-
(Optional) Choose Add Tag and enter a tag
key and a tag value.
-
Choose Allocate host.
- Amazon CLI
-
To allocate a Dedicated Host
Use the allocate-hosts Amazon CLI command. The following command
allocates a Dedicated Host that supports multiple instance types from the
m5
instance family in us-east-1a
Availability Zone. The host also has host recovery enabled and it
has auto-placement disabled.
aws ec2 allocate-hosts --instance-family "m5
" --availability-zone "us-east-1a
" --auto-placement "off
" --host-recovery "on
" --quantity 1
The following command allocates a Dedicated Host that supports
untargeted
m4.large
instance launches in the eu-west-1a
Availability Zone, enables host recovery, and applies a tag with a key
of purpose
and a value of production
.
aws ec2 allocate-hosts --instance-type "m4.large"
--availability-zone "eu-west-1a"
--auto-placement "on"
--host-recovery "on"
--quantity 1
--tag-specifications 'ResourceType=dedicated-host
,Tags=[{Key=purpose
,Value=production
}]'
- PowerShell
-
To allocate a Dedicated Host
Use the New-EC2Host Amazon Tools for Windows PowerShell command. The following command
allocates a Dedicated Host that supports multiple instance types from the
m5
instance family in us-east-1a
Availability Zone. The host also has host recovery enabled and it
has auto-placement disabled.
PS C:\>
New-EC2Host -InstanceFamily m5
-AvailabilityZone us-east-1a
-AutoPlacement Off
-HostRecovery On
-Quantity 1
The following commands allocate a Dedicated Host that supports
untargeted
m4.large
instance launches in the eu-west-1a
Availability Zone, enable host recovery, and apply a tag with a key of
purpose
and a value of production
.
The TagSpecification
parameter used to tag a Dedicated Host on
creation requires an object that specifies the type of resource to be
tagged, the tag key, and the tag value. The following commands create
the required object.
PS C:\>
$tag = @{ Key="purpose
"; Value="production
" }
PS C:\>
$tagspec = new-object Amazon.EC2.Model.TagSpecification
PS C:\>
$tagspec.ResourceType = "dedicated-host
"
PS C:\>
$tagspec.Tags.Add($tag)
The following command allocates the Dedicated Host and applies the tag specified
in the $tagspec
object.
PS C:\>
New-EC2Host -InstanceType m4.large
-AvailabilityZone eu-west-1a
-AutoPlacement On
-HostRecovery On
-Quantity 1
-TagSpecification $tagspec
Launch instances onto a
Dedicated Host
After you have allocated a Dedicated Host, you can launch instances onto it. You can't
launch instances with host
tenancy if you do not have active Dedicated Hosts with
enough available capacity for the instance type that you are launching.
For Dedicated Hosts that support multiple instance sizes, we recommend that you launch
the larger instance sizes first, and then fill the remaining instance capacity
with the smaller instance sizes as needed.
Before you launch your instances, take note of the limitations. For more
information, see Dedicated Hosts restrictions.
You can launch an instance onto a Dedicated Host using the following methods.
- Console
-
To launch an instance onto a specific Dedicated Host from the Dedicated Hosts
page
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
Choose Dedicated Hosts in the navigation
pane.
-
On the Dedicated Hosts page, select a host and
choose Actions, Launch
Instance(s) onto Host.
-
Select an AMI from the list. SQL Server, SUSE,
and RHEL AMIs provided by Amazon EC2 can't be used with Dedicated Hosts.
-
On the Choose an Instance Type page,
select the instance type to launch and then choose
Next: Configure Instance Details.
If the Dedicated Host supports a single instance type only, the
supported instance type is selected by default and can't be
changed.
If the Dedicated Host supports multiple instance types, you must select
an instance type within the supported instance family based on
the available instance capacity of the Dedicated Host. We recommend that
you launch the larger instance sizes first, and then fill the
remaining instance capacity with the smaller instance sizes as
needed.
-
On the Configure Instance Details page,
configure the instance settings to suit your needs, and then for
Affinity, choose one of the following
options:
-
Off—The
instance launches onto the specified host, but it is not
guaranteed to restart on the same Dedicated Host if
stopped.
-
Host—If
stopped, the instance always restarts on this specific
host.
For more information about Affinity, see Understand auto-placement and
affinity.
The Tenancy and Host
options are pre-configured based on the host that you
selected.
-
Choose Review and Launch.
-
On the Review Instance Launch page,
choose Launch.
-
When prompted, select an existing key pair or create a new
one, and then choose Launch
Instances.
To launch an instance onto a Dedicated Host using the Launch Instance
wizard
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
In the navigation pane, choose Instances,
Launch Instance.
-
Select an AMI from the list. SQL Server, SUSE,
and RHEL AMIs provided by Amazon EC2 can't be used with Dedicated Hosts.
-
Select the type of instance to launch and choose
Next: Configure Instance
Details.
-
On the Configure Instance Details page,
configure the instance settings to suit your needs, and then
configure the following settings, which are specific to a
Dedicated Host:
-
Tenancy—Choose Dedicated Host - Launch this
instance on a Dedicated Host.
-
Host—Choose either Use
auto-placement to launch the instance on
any Dedicated Host that has auto-placement enabled, or select a
specific Dedicated Host in the list. The list displays only Dedicated Hosts
that support the selected instance type.
-
Affinity—Choose one of the following
options:
-
Off—The
instance launches onto the specified host, but it
is not guaranteed to restart on it if
stopped.
-
Host—If
stopped, the instance always restarts on the
specified host.
For more information, see Understand auto-placement and
affinity.
If you are unable to see these settings, check that you have
selected a VPC in the Network menu.
-
Choose Review and Launch.
-
On the Review Instance Launch page,
choose Launch.
-
When prompted, select an existing key pair or create a new
one, and then choose Launch
Instances.
- Amazon CLI
-
To launch an instance onto a Dedicated Host
Use the run-instances Amazon CLI command and specify the instance
affinity, tenancy, and host in the Placement
request
parameter.
- PowerShell
-
To launch an instance onto a Dedicated Host
Use the New-EC2Instance Amazon Tools for Windows PowerShell command and specify the
instance affinity, tenancy, and host in the Placement
request parameter.
Launch instances into a host resource
group
When you launch an instance into a host resource group that has a Dedicated Host with
available instance capacity, Amazon EC2 launches the instance onto that host. If the host
resource group does not have a host with available instance capacity, Amazon EC2
automatically allocates a new host in the host resource group, and then launches the
instance onto that host. For more information, see Host Resource
Groups in the Amazon License Manager User Guide.
Requirements and limits
-
You must associate a core- or socket-based license configuration with the
AMI.
-
You can't use SQL Server, SUSE, or RHEL AMIs provided
by Amazon EC2 with Dedicated Hosts.
-
You can't target a specific host by choosing a host ID, and you can't
enable instance affinity when launching an instance into a host resource
group.
You can launch an instance into a host resource group using the following
methods.
- Console
-
To launch an instance into a host resource group
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
In the navigation pane, choose Instances,
Launch Instance.
-
Select an AMI.
-
Select the type of instance to launch and choose
Next: Configure Instance
Details.
-
On the Configure Instance Details page,
configure the instance settings to suit your needs, and then do
the following:
-
For Tenancy, choose
Dedicated Host.
-
For Host resource group, choose
Launch instance into a host resource
group.
-
For Host resource group name,
choose the host resource group in which to launch the
instance.
-
Choose Review and Launch.
-
On the Review Instance Launch page,
choose Launch.
-
When prompted, select an existing key pair or create a new
one, and then choose Launch
Instances.
- Amazon CLI
-
To launch an instance into a host resource group
Use the run-instances Amazon CLI command, and in the
Placement
request parameter, omit the Tenancy
option and specify the host resource group ARN.
- PowerShell
-
To launch an instance into a host resource group
Use the New-EC2Instance Amazon Tools for Windows PowerShell command, and in the
Placement
request parameter, omit the Tenancy
option and specify the host resource group ARN.
Understand auto-placement and
affinity
Placement control for Dedicated Hosts happens on both the instance level and host
level.
Auto-placement
Auto-placement is configured at the host level. It allows you to manage
whether instances that you launch are launched onto a specific host, or onto any
available host that has matching configurations.
When the auto-placement of a Dedicated Host is disabled, it only
accepts Host tenancy instance launches that specify its
unique host ID. This is the default setting for new Dedicated Hosts.
When the auto-placement of a Dedicated Host is enabled, it accepts
any untargeted instance launches that match its instance type
configuration.
When launching an instance, you need to configure its tenancy. Launching an
instance onto a Dedicated Host without providing a specific HostId
enables it
to launch on any Dedicated Host that has auto-placement enabled and
that matches its instance type.
Host affinity
Host affinity is configured at the instance level. It establishes a launch
relationship between an instance and a Dedicated Host.
When affinity is set to Host
, an instance launched onto a
specific host always restarts on the same host if stopped. This applies to both
targeted and untargeted launches.
When affinity is set to Off
, and you stop and restart the
instance, it can be restarted on any available host. However, it tries to launch
back onto the last Dedicated Host on which it ran (on a best-effort basis).
Modify Dedicated Host auto-placement
You can modify the auto-placement settings of a Dedicated Host after you have allocated it
to your Amazon account, using one of the following methods.
- New console
-
To modify the auto-placement of a Dedicated Host
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
In the navigation pane, choose
Dedicated Hosts.
-
Select a host and choose Actions,
Modify host.
-
For Instance auto-placement, choose
Enable to enable auto-placement, or
clear Enable to disable auto-placement. For
more information, see Understand auto-placement and
affinity.
-
Choose Save.
- Old console
-
To modify the auto-placement of a Dedicated Host
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
Choose Dedicated Hosts in the navigation
pane.
-
On the Dedicated Hosts page, select a host and
choose Actions, Modify
Auto-Placement.
-
On the Modify Auto-placement window, for Allow
instance auto-placement, choose
Yes to enable auto-placement, or choose
No to disable auto-placement. For more
information, see Understand auto-placement and
affinity.
-
Choose Save.
- Amazon CLI
-
To modify the auto-placement of a Dedicated Host
Use the modify-hosts Amazon CLI command. The following example
enables auto-placement for the specified Dedicated Host.
aws ec2 modify-hosts --auto-placement on
--host-ids h-012a3456b7890cdef
- PowerShell
-
To modify the auto-placement of a Dedicated Host
Use the Edit-EC2Host Amazon Tools for Windows PowerShell command. The following example
enables auto-placement for the specified Dedicated Host.
PS C:\>
Edit-EC2Host --AutoPlacement 1
--HostId h-012a3456b7890cdef
Modify the supported instance types
Support for multiple instance types on the same Dedicated Host is available for
the following instance families: C5, M5, R5, C5n, R5n, M5n, and T3. Other instance
families support only a single instance type on the same Dedicated Host.
You can allocate a Dedicated Host using the following methods.
You can modify a Dedicated Host to change the instance types that it supports. If it
currently supports a single instance type, you can modify it to support multiple
instance types within that instance family. Similarly, if it currently supports
multiple instance types, you can modify it to support a specific instance type
only.
To modify a Dedicated Host to support multiple instance types, you must first stop all
running instances on the host. The modification takes approximately 10 minutes to
complete. The Dedicated Host transitions to the pending
state while the
modification is in progress. You can't start stopped instances or launch new
instances on the Dedicated Host while it is in the pending
state.
To modify a Dedicated Host that supports multiple instance types to support only a single
instance type, the host must either have no running instances, or the running
instances must be of the instance type that you want the host to support. For
example, to modify a host that supports multiple instance types in the
m5
instance family to support only m5.large
instances,
the Dedicated Host must either have no running instances, or it must have only
m5.large
instances running on it.
If you allocate a host for a virtualized instance type, you can't modify the
instance type to a .metal
instance type after the host is allocated.
For example, if you allocate a host for the m5.large
instance type, you
can't modify the instance type to m5.metal
. Similarly, if you allocate
a host for a .metal
instance type, you can't modify the instance type
to a virtualized instance type after the host is allocated. For example, if you
allocate a host for the m5.metal
instance type, you can't modify the
instance type to m5.large
.
You can modify the supported instance types using one of the following
methods.
- New console
-
To modify the supported instance types for a Dedicated Host
-
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
In the Navigation pane, choose
Dedicated Host.
-
Select the Dedicated Host to modify and choose
Actions, Modify
host.
-
Do one of the following, depending on the current
configuration of the Dedicated Host:
-
If the Dedicated Host currently supports a specific instance
type, Support multiple instance
types is not enabled, and
Instance type lists the
supported instance type. To modify the host to support
multiple types in the current instance family, for
Support multiple instance
types, choose
Enable.
You must first stop all instances running on the host
before modifying it to support multiple instance
types.
-
If the Dedicated Host currently supports multiple instance types
in an instance family, Enabled is
selected for Support multiple instance
types. To modify the host to support a
specific instance type, for Support multiple
instance types, clear
Enable, and then for
Instance type, select the
specific instance type to support.
You can't change the instance family supported by the
Dedicated Host.
-
Choose Save.
- Old console
-
To modify the supported instance types for a Dedicated Host
-
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
In the Navigation pane, choose
Dedicated Host.
-
Select the Dedicated Host to modify and choose
Actions, Modify Supported
Instance Types.
-
Do one of the following, depending on the current
configuration of the Dedicated Host:
-
If the Dedicated Host currently supports a specific instance
type, No is selected for
Support multiple instance
types. To modify the host to support multiple
types in the current instance family, for
Support multiple instance
types, select
Yes.
You must first stop all instances running on the host
before modifying it to support multiple instance
types.
-
If the Dedicated Host currently supports multiple instance types
in an instance family, Yes is
selected for Support multiple instance
types, and Instance
family displays the supported instance
family. To modify the host to support a specific
instance type, for Support multiple instance
types, select No,
and then for Instance type, select
the specific instance type to support.
You can't change the instance family supported by the
Dedicated Host.
-
Choose Save.
- Amazon CLI
-
To modify the supported instance types for a Dedicated Host
Use the modify-hosts Amazon CLI command.
The following command modifies a Dedicated Host to support multiple instance
types within the m5
instance family.
aws ec2 modify-hosts --instance-family m5
--host-ids h-012a3456b7890cdef
The following command modifies a Dedicated Host to support
m5.xlarge
instances only.
aws ec2 modify-hosts --instance-type m5.xlarge
--instance-family --host-ids h-012a3456b7890cdef
- PowerShell
-
To modify the supported instance types for a Dedicated Host
Use the Edit-EC2Host Amazon Tools for Windows PowerShell command.
The following command modifies a Dedicated Host to support multiple instance
types within the m5
instance family.
PS C:\>
Edit-EC2Host --InstanceFamily m5
--HostId h-012a3456b7890cdef
The following command modifies a Dedicated Host to support
m5.xlarge
instances only.
PS C:\>
Edit-EC2Host --InstanceType m5.xlarge
--HostId h-012a3456b7890cdef
Modify instance tenancy and
affinity
You can change the tenancy of an instance after
you have launched it. You can also modify the affinity between the instance and the
host. To modify either instance tenancy or affinity, the instance must be in the
stopped
state.
For T3 instances, you can't change the tenancy from dedicated
to
host
, or from host
to dedicated
.
Attempting to make one of these unsupported tenancy changes results in the
InvalidTenancy
error code.
You can modify an instance's tenancy and affinity using the following
methods.
- Console
-
To modify instance tenancy or affinity
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
Choose Instances, and select the instance
to modify.
-
Choose Instance state,
Stop.
-
Open the context (right-click) menu on the instance and choose
Instance Settings, Modify
Instance Placement.
-
On the Modify Instance Placement page,
configure the following:
-
Tenancy—Choose one of the
following:
-
Run a dedicated hardware
instance—Launches the instance as a Dedicated Instance.
For more information, see Dedicated Instances.
-
Launch the instance on a Dedicated Host—Launches
the instance onto a Dedicated Host with configurable
affinity.
-
Affinity—Choose one of the
following:
-
This instance can run on any one of my
hosts—The instance launches onto any
available Dedicated Host in your account that supports its
instance type.
-
This instance can only run on the selected
host—The instance is only able to run on the
Dedicated Host selected for Target
Host.
-
Target Host—Select the Dedicated Host
that the instance must run on. If no target host is
listed, you might not have available, compatible Dedicated Hosts
in your account.
For more information, see Understand auto-placement and
affinity.
-
Choose Save.
- Amazon CLI
-
To modify instance tenancy or affinity
Use the modify-instance-placement Amazon CLI command. The following
example changes the specified instance's affinity from
default
to host
, and specifies the
Dedicated Host that the instance has affinity with.
aws ec2 modify-instance-placement --instance-id i-1234567890abcdef0
--affinity host
--host-id h-012a3456b7890cdef
- PowerShell
-
To modify instance tenancy or affinity
Use the Edit-EC2InstancePlacement Amazon Tools for Windows PowerShell command. The
following example changes the specified instance's affinity from
default
to host
, and specifies the
Dedicated Host that the instance has affinity with.
PS C:\>
Edit-EC2InstancePlacement -InstanceId i-1234567890abcdef0
-Affinity host
-HostId h-012a3456b7890cdef
View Dedicated Hosts
You can view details about a Dedicated Host and the individual instances on it using the
following methods.
- New console
-
To view the details of a Dedicated Host
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
In the navigation pane, choose
Dedicated Hosts.
-
On the Dedicated Hosts page, select a host.
-
For information about the host, choose
Details.
Available vCPUs indicates the vCPUs that
are available on the Dedicated Host for new instance launches. For
example, a Dedicated Host that supports multiple instance types within the
c5
instance family, and that has no instances
running on it, has 72 available vCPUs. This means that you can
launch different combinations of instance types onto the Dedicated Host to
consume the 72 available vCPUs.
For information about instances running on the host, choose
Running instances.
- Old console
-
To view the details of a Dedicated Host
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
In the navigation pane, choose
Dedicated Hosts.
-
On the Dedicated Hosts page, select a host.
-
For information about the host, choose
Description. Available
vCPUs indicates the vCPUs that are available on
the Dedicated Host for new instance launches. For example, a Dedicated Host that
supports multiple instance types within the c5
instance family, and that has no instances running on it, has 72
available vCPUs. This means that you can launch different
combinations of instance types onto the Dedicated Host to consume the 72
available vCPUs.
For information about instances running on the host, choose
Instances.
- Amazon CLI
-
To view the capacity of a Dedicated Host
Use the describe-hosts Amazon CLI command.
The following example uses the describe-hosts
(Amazon CLI) command to view the available instance capacity for a Dedicated Host that
supports multiple instance types within the c5
instance
family. The Dedicated Host already has two c5.4xlarge
instances and
four c5.2xlarge
instances running on it.
$
aws ec2 describe-hosts --host-id h-012a3456b7890cdef
"AvailableInstanceCapacity": [
{ "AvailableCapacity": 2,
"InstanceType": "c5.xlarge",
"TotalCapacity": 18 },
{ "AvailableCapacity": 4,
"InstanceType": "c5.large",
"TotalCapacity": 36 }
],
"AvailableVCpus": 8
- PowerShell
-
To view the instance capacity of a Dedicated Host
Use the Get-EC2Host Amazon Tools for Windows PowerShell command.
PS C:\>
Get-EC2Host -HostId h-012a3456b7890cdef
Tag Dedicated Hosts
You can assign custom tags to your existing Dedicated Hosts to categorize them in different
ways, for example, by purpose, owner, or environment. This helps you to quickly find
a specific Dedicated Host based on the custom tags that you assigned. Dedicated Host tags can also be
used for cost allocation tracking.
You can also apply tags to Dedicated Hosts at the time of creation. For more information,
see Allocate Dedicated Hosts.
You can tag a Dedicated Host using the following methods.
- New console
-
To tag a Dedicated Host
-
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
In the navigation pane, choose Dedicated Hosts.
-
Select the Dedicated Host to tag, and then choose
Actions, Manage
tags.
-
In the Manage tags screen, choose
Add tag, and then specify the key and
value for the tag.
-
(Optional) Choose Add tag to add
additional tags to the Dedicated Host.
-
Choose Save changes.
- Old console
-
To tag a Dedicated Host
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
In the navigation pane, choose Dedicated Hosts.
-
Select the Dedicated Host to tag, and then choose
Tags.
-
Choose Add/Edit Tags.
-
In the Add/Edit Tags dialog box, choose
Create Tag, and then specify the key
and value for the tag.
-
(Optional) Choose Create Tag to add
additional tags to the Dedicated Host.
-
Choose Save.
- Amazon CLI
-
To tag a Dedicated Host
Use the create-tags Amazon CLI command.
The following command tags the specified Dedicated Host with
Owner=TeamA
.
aws ec2 create-tags --resources h-abc12345678909876
--tags Key=Owner
,Value=TeamA
- PowerShell
-
To tag a Dedicated Host
Use the New-EC2Tag Amazon Tools for Windows PowerShell command.
The New-EC2Tag
command needs a Tag
object,
which specifies the key and value pair to be used for the Dedicated Host tag. The
following commands create a Tag
object named
$tag
, with a key and value pair of Owner
and TeamA
respectively.
PS C:\>
$tag = New-Object Amazon.EC2.Model.Tag
PS C:\>
$tag.Key = "Owner
"
PS C:\>
$tag.Value = "TeamA
"
The following command tags the specified Dedicated Host with the
$tag
object.
PS C:\>
New-EC2Tag -Resource h-abc12345678909876
-Tag $tag
Monitor Dedicated Hosts
Amazon EC2 constantly monitors the state of your Dedicated Hosts. Updates are communicated on the
Amazon EC2 console. You can view information about a Dedicated Host using the following
methods.
- Console
-
To view the state of a Dedicated Host
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
In the navigation pane, choose
Dedicated Hosts.
-
Locate the Dedicated Host in the list and review the value in the
State column.
- Amazon CLI
-
To view the state of a Dedicated Host
Use the describe-hosts Amazon CLI command and then review the
state
property in the hostSet
response
element.
aws ec2 describe-hosts --host-id h-012a3456b7890cdef
- PowerShell
-
To view the state of a Dedicated Host
Use the Get-EC2Host Amazon Tools for Windows PowerShell command and then review the
state
property in the hostSet
response
element.
PS C:\>
Get-EC2Host -HostId h-012a3456b7890cdef
The following table explains the possible Dedicated Host states.
State |
Description |
available |
Amazon hasn't detected an issue with the Dedicated Host. No maintenance or
repairs are scheduled. Instances can be launched onto this Dedicated
Host. |
released |
The Dedicated Host has been released. The host ID is no longer in use.
Released hosts can't be reused. |
under-assessment |
Amazon is exploring a possible issue with the Dedicated Host. If action must
be taken, you are notified via the Amazon Web Services Management Console or email. Instances
can't be launched onto a Dedicated Host in this state. |
pending |
The Dedicated Host cannot be used for new instance launches. It is either
being modified to support
multiple instance types, or a host recovery is in
progress. |
permanent-failure |
An unrecoverable failure has been detected. You receive an
eviction notice through your instances and by email. Your instances
might continue to run. If you stop or terminate all instances on a
Dedicated Host with this state, Amazon retires the host. Amazon does not restart
instances in this state. Instances can't be launched onto Dedicated Hosts in
this state. |
released-permanent-failure |
Amazon permanently releases Dedicated Hosts that have failed and no longer
have running instances on them. The Dedicated Host ID is no longer available
for use. |
Release Dedicated Hosts
Any running instances on the Dedicated Host must be stopped before you can release the host.
These instances can be migrated to other Dedicated Hosts in your account so that you can
continue to use them. These steps apply only to On-Demand Dedicated Hosts.
You can release a Dedicated Host using the following methods.
- New console
-
To release a Dedicated Host
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
In the navigation pane, choose
Dedicated Hosts.
-
On the Dedicated Hosts page, select the Dedicated Host to
release.
-
Choose Actions, Release
host.
-
To confirm, choose Release.
- Old console
-
To release a Dedicated Host
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
Choose Dedicated Hosts in the navigation
pane.
-
On the Dedicated Hosts page, select the Dedicated Host to
release.
-
Choose Actions, Release
Hosts.
-
Choose Release to confirm.
- Amazon CLI
-
To release a Dedicated Host
Use the release-hosts Amazon CLI command.
aws ec2 release-hosts --host-ids h-012a3456b7890cdef
- PowerShell
-
To release a Dedicated Host
Use the Remove-EC2Hosts Amazon Tools for Windows PowerShell command.
PS C:\>
Remove-EC2Hosts -HostId h-012a3456b7890cdef
After you release a Dedicated Host, you can't reuse the same host or host ID again, and you
are no longer charged On-Demand billing rates for it. The state of the Dedicated Host is
changed to released
, and you are not able to launch any instances onto
that host.
If you have recently released Dedicated Hosts, it can take some time for them to stop
counting towards your limit. During this time, you might experience
LimitExceeded
errors when trying to allocate new Dedicated Hosts. If this
is the case, try allocating new hosts again after a few minutes.
The instances that were stopped are still available for use and are listed on the
Instances page. They retain their host
tenancy
setting.
Purchase Dedicated Host Reservations
You can purchase reservations using the following methods:
- Console
-
To purchase reservations
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
Choose Dedicated Hosts,
Dedicated Host Reservations, Purchase
Dedicated Host Reservation.
-
On the Purchase Dedicated Host Reservation screen, you can
search for available offerings using the default settings, or
you can specify custom values for the following:
-
Host instance family—The
options listed correspond with the Dedicated Hosts in your account
that are not already assigned to a reservation.
-
Availability Zone—The
Availability Zone of the Dedicated Hosts in your account that
aren't already assigned to a reservation.
-
Payment option—The payment
option for the offering.
-
Term—The term of the
reservation, which can be one or three years.
-
Choose Find offering and select an
offering that matches your requirements.
-
Choose the Dedicated Hosts to associate with the reservation, and then
choose Review.
-
Review your order and choose
Order.
- Amazon CLI
-
To purchase reservations
-
Use the describe-host-reservation-offerings Amazon CLI command
to list the available offerings that match your needs. The
following example lists the offerings that support instances in
the m4
instance family and have a one-year
term.
The term is specified in seconds. A one-year term includes
31,536,000 seconds, and a three-year term includes
94,608,000 seconds.
aws ec2 describe-host-reservation-offerings --filter Name=instance-family
,Values=m4
--max-duration 31536000
The command returns a list of offerings that match your
criteria. Note the offeringId
of the offering to
purchase.
-
Use the purchase-host-reservation Amazon CLI command to purchase
the offering and provide the offeringId
noted in
the previous step. The following example purchases the specified
reservation and associates it with a specific Dedicated Host that is
already allocated in the Amazon account, and it applies a tag
with a key of purpose
and a value of
production
.
aws ec2 purchase-host-reservation --offering-id hro-03f707bf363b6b324
--host-id-set h-013abcd2a00cbd123
--tag-specifications 'ResourceType=host-reservation,Tags={Key=purpose,Value=production}'
- PowerShell
-
To purchase reservations
-
Use the Get-EC2HostReservationOffering Amazon Tools for Windows PowerShell command to
list the available offerings that match your needs. The
following examples list the offerings that support instances in
the m4
instance family and have a one-year
term.
The term is specified in seconds. A one-year term includes
31,536,000 seconds, and a three-year term includes
94,608,000 seconds.
PS C:\>
$filter = @{Name="instance-family"; Value="m4"}
PS C:\>
Get-EC2HostReservationOffering -filter $filter
-MaxDuration 31536000
The command returns a list of offerings that match your
criteria. Note the offeringId
of the offering to
purchase.
-
Use the New-EC2HostReservation Amazon Tools for Windows PowerShell command to
purchase the offering and provide the offeringId
noted in the previous step. The following example purchases the
specified reservation and associates it with a specific Dedicated Host
that is already allocated in the Amazon account.
PS C:\>
New-EC2HostReservation -OfferingId hro-03f707bf363b6b324
-HostIdSet h-013abcd2a00cbd123
View Dedicated Host reservations
You can view information about the Dedicated Hosts that are associated with your
reservation, including:
You can view details of your Dedicated Host reservations using the following methods.
- Console
-
To view the details of a Dedicated Host reservation
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
Choose Dedicated Hosts in the navigation
pane.
-
On the Dedicated Hosts page, choose Dedicated Host
Reservations, and then select the reservation
from the list provided.
-
Choose Details for information about the
reservation.
-
Choose Hosts for information about the
Dedicated Hosts with which the reservation is associated.
- Amazon CLI
-
To view the details of a Dedicated Host reservation
Use the describe-host-reservations Amazon CLI command.
aws ec2 describe-host-reservations
- PowerShell
-
To view the details of a Dedicated Host reservation
Use the Get-EC2HostReservation Amazon Tools for Windows PowerShell command.
PS C:\>
Get-EC2HostReservation
Tag Dedicated Host Reservations
You can assign custom tags to your Dedicated Host Reservations to categorize them in different ways,
for example, by purpose, owner, or environment. This helps you to quickly find a
specific Dedicated Host Reservation based on the custom tags that you assigned.
You can tag a Dedicated Host Reservation using the command line tools only.
- Amazon CLI
-
To tag a Dedicated Host Reservation
Use the create-tags Amazon CLI command.
aws ec2 create-tags --resources hr-1234563a4ffc669ae
--tags Key=Owner
,Value=TeamA
- PowerShell
-
To tag a Dedicated Host Reservation
Use the New-EC2Tag Amazon Tools for Windows PowerShell command.
The New-EC2Tag
command needs a Tag
parameter, which specifies the key and value pair to be used for the
Dedicated Host Reservation tag. The following commands create the Tag
parameter.
PS C:\>
$tag = New-Object Amazon.EC2.Model.Tag
PS C:\>
$tag.Key = "Owner
"
PS C:\>
$tag.Value = "TeamA
"
PS C:\>
New-EC2Tag -Resource hr-1234563a4ffc669ae
-Tag $tag