Network.AWS.EC2.AllocateHosts

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.

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

Defined in Network.AWS.EC2.AllocateHosts

Methods

(==) :: AllocateHosts -> AllocateHosts -> Bool

(/=) :: AllocateHosts -> AllocateHosts -> Bool

Data AllocateHosts

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

Defined in Network.AWS.EC2.AllocateHosts

Methods

readsPrec :: Int -> ReadS AllocateHosts

readList :: ReadS [AllocateHosts]

readPrec :: ReadPrec AllocateHosts

readListPrec :: ReadPrec [AllocateHosts]

Show AllocateHosts

Defined in Network.AWS.EC2.AllocateHosts

Methods

showsPrec :: Int -> AllocateHosts -> ShowS

show :: AllocateHosts -> String

showList :: [AllocateHosts] -> ShowS

Generic AllocateHosts

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

Defined in Network.AWS.EC2.AllocateHosts

Methods

hashWithSalt :: Int -> AllocateHosts -> Int

hash :: AllocateHosts -> Int

AWSRequest AllocateHosts

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

Defined in Network.AWS.EC2.AllocateHosts

Methods

toHeaders :: AllocateHosts -> [Header]

ToPath AllocateHosts

Defined in Network.AWS.EC2.AllocateHosts

Methods

toPath :: AllocateHosts -> ByteString

ToQuery AllocateHosts

Defined in Network.AWS.EC2.AllocateHosts

Methods

toQuery :: AllocateHosts -> QueryString

NFData AllocateHosts

Defined in Network.AWS.EC2.AllocateHosts

Methods

rnf :: AllocateHosts -> ()

type Rep AllocateHosts

Defined in Network.AWS.EC2.AllocateHosts

type Rep AllocateHosts = D1 (MetaData "AllocateHosts" "Network.AWS.EC2.AllocateHosts" "amazonka-ec2-1.6.1-GgG1M0FWcBrE5I5IM2QktE" 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

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

Defined in Network.AWS.EC2.AllocateHosts

Methods

(==) :: AllocateHostsResponse -> AllocateHostsResponse -> Bool

(/=) :: AllocateHostsResponse -> AllocateHostsResponse -> Bool

Data AllocateHostsResponse

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

Defined in Network.AWS.EC2.AllocateHosts

Methods

readsPrec :: Int -> ReadS AllocateHostsResponse

readList :: ReadS [AllocateHostsResponse]

readPrec :: ReadPrec AllocateHostsResponse

readListPrec :: ReadPrec [AllocateHostsResponse]

Show AllocateHostsResponse

Defined in Network.AWS.EC2.AllocateHosts

Methods

showsPrec :: Int -> AllocateHostsResponse -> ShowS

show :: AllocateHostsResponse -> String

showList :: [AllocateHostsResponse] -> ShowS

Generic AllocateHostsResponse

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

Defined in Network.AWS.EC2.AllocateHosts

Methods

rnf :: AllocateHostsResponse -> ()

type Rep AllocateHostsResponse

Defined in Network.AWS.EC2.AllocateHosts

type Rep AllocateHostsResponse = D1 (MetaData "AllocateHostsResponse" "Network.AWS.EC2.AllocateHosts" "amazonka-ec2-1.6.1-GgG1M0FWcBrE5I5IM2QktE" 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.