Copyright	(c) 2013-2023 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	Safe-Inferred
Language	Haskell2010

Amazonka.EC2.ReleaseHosts

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

When you no longer want to use an On-Demand 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, for example, to modify the host. You must stop or terminate all instances on a host before it can be released.

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

Released hosts still appear in a DescribeHosts response.

Synopsis

Creating a Request

data ReleaseHosts Source #

See: newReleaseHosts smart constructor.

Constructors

ReleaseHosts'
Fields hostIds :: [Text] The IDs of the Dedicated Hosts to release.

Instances

Instances details

ToHeaders ReleaseHosts Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts Methods toHeaders :: ReleaseHosts -> [Header] #
ToPath ReleaseHosts Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts Methods toPath :: ReleaseHosts -> ByteString #
ToQuery ReleaseHosts Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts Methods toQuery :: ReleaseHosts -> QueryString #
AWSRequest ReleaseHosts Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts Associated Types type AWSResponse ReleaseHosts # Methods request :: (Service -> Service) -> ReleaseHosts -> Request ReleaseHosts # response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy ReleaseHosts -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse ReleaseHosts))) #
Generic ReleaseHosts Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts Associated Types type Rep ReleaseHosts :: Type -> Type # Methods from :: ReleaseHosts -> Rep ReleaseHosts x # to :: Rep ReleaseHosts x -> ReleaseHosts #
Read ReleaseHosts Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts Methods readsPrec :: Int -> ReadS ReleaseHosts # readList :: ReadS [ReleaseHosts] # readPrec :: ReadPrec ReleaseHosts # readListPrec :: ReadPrec [ReleaseHosts] #
Show ReleaseHosts Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts Methods showsPrec :: Int -> ReleaseHosts -> ShowS # show :: ReleaseHosts -> String # showList :: [ReleaseHosts] -> ShowS #
NFData ReleaseHosts Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts Methods rnf :: ReleaseHosts -> () #
Eq ReleaseHosts Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts Methods (==) :: ReleaseHosts -> ReleaseHosts -> Bool # (/=) :: ReleaseHosts -> ReleaseHosts -> Bool #
Hashable ReleaseHosts Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts Methods hashWithSalt :: Int -> ReleaseHosts -> Int # hash :: ReleaseHosts -> Int #
type AWSResponse ReleaseHosts Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts type AWSResponse ReleaseHosts = ReleaseHostsResponse
type Rep ReleaseHosts Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts type Rep ReleaseHosts = D1 ('MetaData "ReleaseHosts" "Amazonka.EC2.ReleaseHosts" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "ReleaseHosts'" 'PrefixI 'True) (S1 ('MetaSel ('Just "hostIds") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [Text])))

newReleaseHosts :: ReleaseHosts Source #

Create a value of ReleaseHosts with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:hostIds:ReleaseHosts', releaseHosts_hostIds - The IDs of the Dedicated Hosts to release.

Request Lenses

releaseHosts_hostIds :: Lens' ReleaseHosts [Text] Source #

The IDs of the Dedicated Hosts to release.

Destructuring the Response

data ReleaseHostsResponse Source #

See: newReleaseHostsResponse smart constructor.

Constructors

ReleaseHostsResponse'
Fields successful :: Maybe [Text] The IDs of the Dedicated Hosts that were successfully released. unsuccessful :: Maybe [UnsuccessfulItem] The IDs of the Dedicated Hosts that could not be released, including an error message. httpStatus :: Int The response's http status code.

Instances

Instances details

Generic ReleaseHostsResponse Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts Associated Types type Rep ReleaseHostsResponse :: Type -> Type # Methods from :: ReleaseHostsResponse -> Rep ReleaseHostsResponse x # to :: Rep ReleaseHostsResponse x -> ReleaseHostsResponse #
Read ReleaseHostsResponse Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts Methods readsPrec :: Int -> ReadS ReleaseHostsResponse # readList :: ReadS [ReleaseHostsResponse] # readPrec :: ReadPrec ReleaseHostsResponse # readListPrec :: ReadPrec [ReleaseHostsResponse] #
Show ReleaseHostsResponse Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts Methods showsPrec :: Int -> ReleaseHostsResponse -> ShowS # show :: ReleaseHostsResponse -> String # showList :: [ReleaseHostsResponse] -> ShowS #
NFData ReleaseHostsResponse Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts Methods rnf :: ReleaseHostsResponse -> () #
Eq ReleaseHostsResponse Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts Methods (==) :: ReleaseHostsResponse -> ReleaseHostsResponse -> Bool # (/=) :: ReleaseHostsResponse -> ReleaseHostsResponse -> Bool #
type Rep ReleaseHostsResponse Source #
Instance details Defined in Amazonka.EC2.ReleaseHosts type Rep ReleaseHostsResponse = D1 ('MetaData "ReleaseHostsResponse" "Amazonka.EC2.ReleaseHosts" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "ReleaseHostsResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "successful") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text])) :: (S1 ('MetaSel ('Just "unsuccessful") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [UnsuccessfulItem])) :: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newReleaseHostsResponse Source #

Arguments

:: Int	`$sel:httpStatus:ReleaseHostsResponse'`
-> ReleaseHostsResponse

Create a value of ReleaseHostsResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:successful:ReleaseHostsResponse', releaseHostsResponse_successful - The IDs of the Dedicated Hosts that were successfully released.

$sel:unsuccessful:ReleaseHostsResponse', releaseHostsResponse_unsuccessful - The IDs of the Dedicated Hosts that could not be released, including an error message.

$sel:httpStatus:ReleaseHostsResponse', releaseHostsResponse_httpStatus - The response's http status code.

Response Lenses

releaseHostsResponse_successful :: Lens' ReleaseHostsResponse (Maybe [Text]) Source #

The IDs of the Dedicated Hosts that were successfully released.

releaseHostsResponse_unsuccessful :: Lens' ReleaseHostsResponse (Maybe [UnsuccessfulItem]) Source #

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

releaseHostsResponse_httpStatus :: Lens' ReleaseHostsResponse Int Source #

The response's http status code.