amazonka-ec2-1.3.7: Amazon Elastic Compute Cloud SDK.

Copyright(c) 2013-2015 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.EC2.ReleaseHosts

Contents

Description

When you no longer want to use a Dedicated host it can be released. On-Demand billing is stopped and the host goes into released state. The host ID of Dedicated hosts that have been released can no longer be specified in another request, e.g., ModifyHosts. You must stop or terminate all instances on a host before it can be released.

When Dedicated hosts are released, it make take some time for them to stop counting toward your limit and you may receive capacity errors when trying to allocate new Dedicated hosts. Try waiting a few minutes, and then try again.

Released hosts will still appear in a DescribeHosts response.

See: AWS API Reference for ReleaseHosts.

Synopsis

Creating a Request

releaseHosts :: ReleaseHosts Source

Creates a value of ReleaseHosts with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Request Lenses

rhHostIds :: Lens' ReleaseHosts [Text] Source

The IDs of the Dedicated hosts you want to release.

Destructuring the Response

releaseHostsResponse Source

Creates a value of ReleaseHostsResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Response Lenses

rhrsUnsuccessful :: Lens' ReleaseHostsResponse [UnsuccessfulItem] Source

The IDs of the Dedicated hosts that could not be released, including an error message.

rhrsSuccessful :: Lens' ReleaseHostsResponse [Text] Source

The IDs of the Dedicated hosts that were successfully released.