Copyright	(c) 2013-2018 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None
Language	Haskell2010

Network.AWS.EC2.AllocateHosts

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Allocates a Dedicated Host to your account. At minimum you need to specify the instance size type, Availability Zone, and quantity of hosts you want to allocate.

Synopsis

Creating a Request

allocateHosts #

Arguments

:: Text	`ahAvailabilityZone`
-> Text	`ahInstanceType`
-> Int	`ahQuantity`
-> AllocateHosts

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

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

ahClientToken - Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide .
ahAutoPlacement - This is enabled by default. This property allows instances to be automatically placed onto available Dedicated Hosts, when you are launching instances without specifying a host ID. Default: Enabled
ahAvailabilityZone - The Availability Zone for the Dedicated Hosts.
ahInstanceType - Specify the instance type that you want your Dedicated Hosts to be configured for. When you specify the instance type, that is the only instance type that you can launch onto that host.
ahQuantity - The number of Dedicated Hosts you want to allocate to your account with these parameters.

data AllocateHosts #

Contains the parameters for AllocateHosts.

See: allocateHosts smart constructor.

Instances

Eq AllocateHosts #
Instance details Defined in Network.AWS.EC2.AllocateHosts Methods (==) :: AllocateHosts -> AllocateHosts -> Bool # (/=) :: AllocateHosts -> AllocateHosts -> Bool #
Data AllocateHosts #
Instance details Defined in Network.AWS.EC2.AllocateHosts Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> AllocateHosts -> c AllocateHosts # gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c AllocateHosts # toConstr :: AllocateHosts -> Constr # dataTypeOf :: AllocateHosts -> DataType # dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c AllocateHosts) # dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c AllocateHosts) # gmapT :: (forall b. Data b => b -> b) -> AllocateHosts -> AllocateHosts # gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> AllocateHosts -> r # gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> AllocateHosts -> r # gmapQ :: (forall d. Data d => d -> u) -> AllocateHosts -> [u] # gmapQi :: Int -> (forall d. Data d => d -> u) -> AllocateHosts -> u # gmapM :: Monad m => (forall d. Data d => d -> m d) -> AllocateHosts -> m AllocateHosts # gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> AllocateHosts -> m AllocateHosts # gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> AllocateHosts -> m AllocateHosts #
Read AllocateHosts #
Instance details Defined in Network.AWS.EC2.AllocateHosts Methods readsPrec :: Int -> ReadS AllocateHosts # readList :: ReadS [AllocateHosts] # readPrec :: ReadPrec AllocateHosts # readListPrec :: ReadPrec [AllocateHosts] #
Show AllocateHosts #
Instance details Defined in Network.AWS.EC2.AllocateHosts Methods showsPrec :: Int -> AllocateHosts -> ShowS # show :: AllocateHosts -> String # showList :: [AllocateHosts] -> ShowS #
Generic AllocateHosts #
Instance details Defined in Network.AWS.EC2.AllocateHosts Associated Types type Rep AllocateHosts :: Type -> Type # Methods from :: AllocateHosts -> Rep AllocateHosts x # to :: Rep AllocateHosts x -> AllocateHosts #
Hashable AllocateHosts #
Instance details Defined in Network.AWS.EC2.AllocateHosts Methods hashWithSalt :: Int -> AllocateHosts -> Int # hash :: AllocateHosts -> Int #
AWSRequest AllocateHosts #
Instance details Defined in Network.AWS.EC2.AllocateHosts Associated Types type Rs AllocateHosts :: Type # Methods request :: AllocateHosts -> Request AllocateHosts # response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy AllocateHosts -> ClientResponse -> m (Response AllocateHosts) #
ToHeaders AllocateHosts #
Instance details Defined in Network.AWS.EC2.AllocateHosts Methods toHeaders :: AllocateHosts -> [Header] #
ToPath AllocateHosts #
Instance details Defined in Network.AWS.EC2.AllocateHosts Methods toPath :: AllocateHosts -> ByteString #
ToQuery AllocateHosts #
Instance details Defined in Network.AWS.EC2.AllocateHosts Methods toQuery :: AllocateHosts -> QueryString #
NFData AllocateHosts #
Instance details Defined in Network.AWS.EC2.AllocateHosts Methods rnf :: AllocateHosts -> () #
type Rep AllocateHosts #
Instance details Defined in Network.AWS.EC2.AllocateHosts type Rep AllocateHosts = D1 (MetaData "AllocateHosts" "Network.AWS.EC2.AllocateHosts" "amazonka-ec2-1.6.1-H98Zd65xIYr2z4e5UhW9ck" False) (C1 (MetaCons "AllocateHosts'" PrefixI True) ((S1 (MetaSel (Just "_ahClientToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :: S1 (MetaSel (Just "_ahAutoPlacement") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe AutoPlacement))) :: (S1 (MetaSel (Just "_ahAvailabilityZone") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text) :: (S1 (MetaSel (Just "_ahInstanceType") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text) :: S1 (MetaSel (Just "_ahQuantity") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))))
type Rs AllocateHosts #
Instance details Defined in Network.AWS.EC2.AllocateHosts type Rs AllocateHosts = AllocateHostsResponse

Request Lenses

ahClientToken :: Lens' AllocateHosts (Maybe Text) #

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide .

ahAutoPlacement :: Lens' AllocateHosts (Maybe AutoPlacement) #

This is enabled by default. This property allows instances to be automatically placed onto available Dedicated Hosts, when you are launching instances without specifying a host ID. Default: Enabled

ahAvailabilityZone :: Lens' AllocateHosts Text #

The Availability Zone for the Dedicated Hosts.

ahInstanceType :: Lens' AllocateHosts Text #

Specify the instance type that you want your Dedicated Hosts to be configured for. When you specify the instance type, that is the only instance type that you can launch onto that host.

ahQuantity :: Lens' AllocateHosts Int #

The number of Dedicated Hosts you want to allocate to your account with these parameters.

Destructuring the Response

allocateHostsResponse #

Arguments

:: Int	`ahrsResponseStatus`
-> AllocateHostsResponse

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

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

ahrsHostIds - The ID of the allocated Dedicated Host. This is used when you want to launch an instance onto a specific host.
ahrsResponseStatus - -- | The response status code.

data AllocateHostsResponse #

Contains the output of AllocateHosts.

See: allocateHostsResponse smart constructor.

Instances

Eq AllocateHostsResponse #
Instance details Defined in Network.AWS.EC2.AllocateHosts Methods (==) :: AllocateHostsResponse -> AllocateHostsResponse -> Bool # (/=) :: AllocateHostsResponse -> AllocateHostsResponse -> Bool #
Data AllocateHostsResponse #
Instance details Defined in Network.AWS.EC2.AllocateHosts Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> AllocateHostsResponse -> c AllocateHostsResponse # gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c AllocateHostsResponse # toConstr :: AllocateHostsResponse -> Constr # dataTypeOf :: AllocateHostsResponse -> DataType # dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c AllocateHostsResponse) # dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c AllocateHostsResponse) # gmapT :: (forall b. Data b => b -> b) -> AllocateHostsResponse -> AllocateHostsResponse # gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> AllocateHostsResponse -> r # gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> AllocateHostsResponse -> r # gmapQ :: (forall d. Data d => d -> u) -> AllocateHostsResponse -> [u] # gmapQi :: Int -> (forall d. Data d => d -> u) -> AllocateHostsResponse -> u # gmapM :: Monad m => (forall d. Data d => d -> m d) -> AllocateHostsResponse -> m AllocateHostsResponse # gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> AllocateHostsResponse -> m AllocateHostsResponse # gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> AllocateHostsResponse -> m AllocateHostsResponse #
Read AllocateHostsResponse #
Instance details Defined in Network.AWS.EC2.AllocateHosts Methods readsPrec :: Int -> ReadS AllocateHostsResponse # readList :: ReadS [AllocateHostsResponse] # readPrec :: ReadPrec AllocateHostsResponse # readListPrec :: ReadPrec [AllocateHostsResponse] #
Show AllocateHostsResponse #
Instance details Defined in Network.AWS.EC2.AllocateHosts Methods showsPrec :: Int -> AllocateHostsResponse -> ShowS # show :: AllocateHostsResponse -> String # showList :: [AllocateHostsResponse] -> ShowS #
Generic AllocateHostsResponse #
Instance details Defined in Network.AWS.EC2.AllocateHosts Associated Types type Rep AllocateHostsResponse :: Type -> Type # Methods from :: AllocateHostsResponse -> Rep AllocateHostsResponse x # to :: Rep AllocateHostsResponse x -> AllocateHostsResponse #
NFData AllocateHostsResponse #
Instance details Defined in Network.AWS.EC2.AllocateHosts Methods rnf :: AllocateHostsResponse -> () #
type Rep AllocateHostsResponse #
Instance details Defined in Network.AWS.EC2.AllocateHosts type Rep AllocateHostsResponse = D1 (MetaData "AllocateHostsResponse" "Network.AWS.EC2.AllocateHosts" "amazonka-ec2-1.6.1-H98Zd65xIYr2z4e5UhW9ck" False) (C1 (MetaCons "AllocateHostsResponse'" PrefixI True) (S1 (MetaSel (Just "_ahrsHostIds") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Text])) :*: S1 (MetaSel (Just "_ahrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))

Response Lenses

ahrsHostIds :: Lens' AllocateHostsResponse [Text] #

The ID of the allocated Dedicated Host. This is used when you want to launch an instance onto a specific host.

ahrsResponseStatus :: Lens' AllocateHostsResponse Int #

- | The response status code.