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

ahInstanceType

-> Int

ahQuantity

-> Text

ahAvailabilityZone

-> 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
• ahAutoPlacement
• ahInstanceType
• ahQuantity
• ahAvailabilityZone

data AllocateHosts

Contains the parameters for AllocateHosts.

See: allocateHosts smart constructor.

Instances

Eq AllocateHosts

Methods

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

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

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

Methods

readsPrec :: Int -> ReadS AllocateHosts

readList :: ReadS [AllocateHosts]

readPrec :: ReadPrec AllocateHosts

readListPrec :: ReadPrec [AllocateHosts]

Show AllocateHosts

Methods

showsPrec :: Int -> AllocateHosts -> ShowS

show :: AllocateHosts -> String

showList :: [AllocateHosts] -> ShowS

Generic AllocateHosts

Associated Types

type Rep AllocateHosts :: * -> *

Methods

from :: AllocateHosts -> Rep AllocateHosts x

to :: Rep AllocateHosts x -> AllocateHosts

Hashable AllocateHosts

Methods

hashWithSalt :: Int -> AllocateHosts -> Int

hash :: AllocateHosts -> Int

NFData AllocateHosts

Methods

rnf :: AllocateHosts -> ()

AWSRequest AllocateHosts

Associated Types

type Rs AllocateHosts :: *

Methods

request :: AllocateHosts -> Request AllocateHosts

response :: MonadResource m => Logger -> Service -> Proxy * AllocateHosts -> ClientResponse -> m (Response AllocateHosts)

ToPath AllocateHosts

Methods

toPath :: AllocateHosts -> ByteString

ToHeaders AllocateHosts

Methods

toHeaders :: AllocateHosts -> [Header]

ToQuery AllocateHosts

Methods

toQuery :: AllocateHosts -> QueryString

type Rep AllocateHosts

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

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

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

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
• ahrsResponseStatus

data AllocateHostsResponse

Contains the output of AllocateHosts.

See: allocateHostsResponse smart constructor.

Instances

Eq AllocateHostsResponse

Methods

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

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

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

Methods

readsPrec :: Int -> ReadS AllocateHostsResponse

readList :: ReadS [AllocateHostsResponse]

readPrec :: ReadPrec AllocateHostsResponse

readListPrec :: ReadPrec [AllocateHostsResponse]

Show AllocateHostsResponse

Methods

showsPrec :: Int -> AllocateHostsResponse -> ShowS

show :: AllocateHostsResponse -> String

showList :: [AllocateHostsResponse] -> ShowS

Generic AllocateHostsResponse

Associated Types

type Rep AllocateHostsResponse :: * -> *

Methods

from :: AllocateHostsResponse -> Rep AllocateHostsResponse x

to :: Rep AllocateHostsResponse x -> AllocateHostsResponse

NFData AllocateHostsResponse

Methods

rnf :: AllocateHostsResponse -> ()

type Rep AllocateHostsResponse

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