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

Copyright(c) 2013-2016 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.AllocateHosts

Contents

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 #

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
  • 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.
  • ahAvailabilityZone - The Availability Zone for the Dedicated Hosts.

data AllocateHosts #

Contains the parameters for AllocateHosts.

See: allocateHosts smart constructor.

Instances

Eq AllocateHosts # 
Data 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 # 
Show AllocateHosts # 
Generic AllocateHosts # 

Associated Types

type Rep AllocateHosts :: * -> * #

Hashable AllocateHosts # 
NFData AllocateHosts # 

Methods

rnf :: AllocateHosts -> () #

AWSRequest AllocateHosts # 
ToQuery AllocateHosts # 
ToPath AllocateHosts # 
ToHeaders AllocateHosts # 
type Rep AllocateHosts # 
type Rep AllocateHosts = D1 (MetaData "AllocateHosts" "Network.AWS.EC2.AllocateHosts" "amazonka-ec2-1.4.5-C4CR35JggG2GhWFrIiKGhu" False) (C1 (MetaCons "AllocateHosts'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_ahClientToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_ahAutoPlacement") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe AutoPlacement)))) ((:*:) (S1 (MetaSel (Just Symbol "_ahInstanceType") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)) ((:*:) (S1 (MetaSel (Just Symbol "_ahQuantity") NoSourceUnpackedness SourceStrict DecidedUnpack) (Rec0 Int)) (S1 (MetaSel (Just Symbol "_ahAvailabilityZone") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text))))))
type Rs AllocateHosts # 

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

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.

ahAvailabilityZone :: Lens' AllocateHosts Text #

The Availability Zone for the Dedicated Hosts.

Destructuring the Response

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 # 
Data AllocateHostsResponse # 

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 # 
Show AllocateHostsResponse # 
Generic AllocateHostsResponse # 
NFData AllocateHostsResponse # 

Methods

rnf :: AllocateHostsResponse -> () #

type Rep AllocateHostsResponse # 
type Rep AllocateHostsResponse = D1 (MetaData "AllocateHostsResponse" "Network.AWS.EC2.AllocateHosts" "amazonka-ec2-1.4.5-C4CR35JggG2GhWFrIiKGhu" False) (C1 (MetaCons "AllocateHostsResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_ahrsHostIds") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Text]))) (S1 (MetaSel (Just Symbol "_ahrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedUnpack) (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.