Network.AWS.EC2.PurchaseReservedInstancesOffering

Purchases a Reserved Instance for use with your account. With Reserved Instances, you pay a lower hourly rate compared to On-Demand instance pricing.

Use DescribeReservedInstancesOfferings to get a list of Reserved Instance offerings that match your specifications. After you've purchased a Reserved Instance, you can check for your new Reserved Instance with DescribeReservedInstances .

For more information, see Reserved Instances and Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide .

Creating a Request

purchaseReservedInstancesOffering

Arguments

:: Int

prioInstanceCount

-> Text

prioReservedInstancesOfferingId

-> PurchaseReservedInstancesOffering

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

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

• prioLimitPrice - Specified for Reserved Instance Marketplace offerings to limit the total order and ensure that the Reserved Instances are not purchased at unexpected prices.
• prioDryRun - Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation . Otherwise, it is UnauthorizedOperation .
• prioInstanceCount - The number of Reserved Instances to purchase.
• prioReservedInstancesOfferingId - The ID of the Reserved Instance offering to purchase.

data PurchaseReservedInstancesOffering

Contains the parameters for PurchaseReservedInstancesOffering.

See: purchaseReservedInstancesOffering smart constructor.

Instances

Eq PurchaseReservedInstancesOffering

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

Methods

(==) :: PurchaseReservedInstancesOffering -> PurchaseReservedInstancesOffering -> Bool

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

Data PurchaseReservedInstancesOffering

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> PurchaseReservedInstancesOffering -> c PurchaseReservedInstancesOffering

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c PurchaseReservedInstancesOffering

toConstr :: PurchaseReservedInstancesOffering -> Constr

dataTypeOf :: PurchaseReservedInstancesOffering -> DataType

dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c PurchaseReservedInstancesOffering)

dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c PurchaseReservedInstancesOffering)

gmapT :: (forall b. Data b => b -> b) -> PurchaseReservedInstancesOffering -> PurchaseReservedInstancesOffering

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> PurchaseReservedInstancesOffering -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> PurchaseReservedInstancesOffering -> r

gmapQ :: (forall d. Data d => d -> u) -> PurchaseReservedInstancesOffering -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> PurchaseReservedInstancesOffering -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> PurchaseReservedInstancesOffering -> m PurchaseReservedInstancesOffering

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> PurchaseReservedInstancesOffering -> m PurchaseReservedInstancesOffering

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> PurchaseReservedInstancesOffering -> m PurchaseReservedInstancesOffering

Read PurchaseReservedInstancesOffering

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

Methods

readsPrec :: Int -> ReadS PurchaseReservedInstancesOffering

readList :: ReadS [PurchaseReservedInstancesOffering]

readPrec :: ReadPrec PurchaseReservedInstancesOffering

readListPrec :: ReadPrec [PurchaseReservedInstancesOffering]

Show PurchaseReservedInstancesOffering

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

Methods

showsPrec :: Int -> PurchaseReservedInstancesOffering -> ShowS

show :: PurchaseReservedInstancesOffering -> String

showList :: [PurchaseReservedInstancesOffering] -> ShowS

Generic PurchaseReservedInstancesOffering

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

Associated Types

type Rep PurchaseReservedInstancesOffering :: Type -> Type

Methods

from :: PurchaseReservedInstancesOffering -> Rep PurchaseReservedInstancesOffering x

to :: Rep PurchaseReservedInstancesOffering x -> PurchaseReservedInstancesOffering

Hashable PurchaseReservedInstancesOffering

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

Methods

hashWithSalt :: Int -> PurchaseReservedInstancesOffering -> Int

hash :: PurchaseReservedInstancesOffering -> Int

AWSRequest PurchaseReservedInstancesOffering

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

Associated Types

type Rs PurchaseReservedInstancesOffering :: Type

Methods

request :: PurchaseReservedInstancesOffering -> Request PurchaseReservedInstancesOffering

response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy PurchaseReservedInstancesOffering -> ClientResponse -> m (Response PurchaseReservedInstancesOffering)

ToHeaders PurchaseReservedInstancesOffering

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

Methods

toHeaders :: PurchaseReservedInstancesOffering -> [Header]

ToPath PurchaseReservedInstancesOffering

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

Methods

toPath :: PurchaseReservedInstancesOffering -> ByteString

ToQuery PurchaseReservedInstancesOffering

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

Methods

toQuery :: PurchaseReservedInstancesOffering -> QueryString

NFData PurchaseReservedInstancesOffering

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

Methods

rnf :: PurchaseReservedInstancesOffering -> ()

type Rep PurchaseReservedInstancesOffering

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

type Rep PurchaseReservedInstancesOffering = D1 (MetaData "PurchaseReservedInstancesOffering" "Network.AWS.EC2.PurchaseReservedInstancesOffering" "amazonka-ec2-1.6.1-GgG1M0FWcBrE5I5IM2QktE" False) (C1 (MetaCons "PurchaseReservedInstancesOffering'" PrefixI True) ((S1 (MetaSel (Just "_prioLimitPrice") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe ReservedInstanceLimitPrice)) :*: S1 (MetaSel (Just "_prioDryRun") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool))) :*: (S1 (MetaSel (Just "_prioInstanceCount") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int) :*: S1 (MetaSel (Just "_prioReservedInstancesOfferingId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text))))

type Rs PurchaseReservedInstancesOffering

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

type Rs PurchaseReservedInstancesOffering = PurchaseReservedInstancesOfferingResponse

Request Lenses

prioLimitPrice :: Lens' PurchaseReservedInstancesOffering (Maybe ReservedInstanceLimitPrice)

Specified for Reserved Instance Marketplace offerings to limit the total order and ensure that the Reserved Instances are not purchased at unexpected prices.

prioDryRun :: Lens' PurchaseReservedInstancesOffering (Maybe Bool)

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation . Otherwise, it is UnauthorizedOperation .

prioInstanceCount :: Lens' PurchaseReservedInstancesOffering Int

The number of Reserved Instances to purchase.

prioReservedInstancesOfferingId :: Lens' PurchaseReservedInstancesOffering Text

The ID of the Reserved Instance offering to purchase.

Destructuring the Response

purchaseReservedInstancesOfferingResponse

Arguments

:: Int

priorsResponseStatus

-> PurchaseReservedInstancesOfferingResponse

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

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

• priorsReservedInstancesId - The IDs of the purchased Reserved Instances.
• priorsResponseStatus - -- | The response status code.

data PurchaseReservedInstancesOfferingResponse

Contains the output of PurchaseReservedInstancesOffering.

See: purchaseReservedInstancesOfferingResponse smart constructor.

Instances

Eq PurchaseReservedInstancesOfferingResponse

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

Methods

(==) :: PurchaseReservedInstancesOfferingResponse -> PurchaseReservedInstancesOfferingResponse -> Bool

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

Data PurchaseReservedInstancesOfferingResponse

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> PurchaseReservedInstancesOfferingResponse -> c PurchaseReservedInstancesOfferingResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c PurchaseReservedInstancesOfferingResponse

toConstr :: PurchaseReservedInstancesOfferingResponse -> Constr

dataTypeOf :: PurchaseReservedInstancesOfferingResponse -> DataType

dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c PurchaseReservedInstancesOfferingResponse)

dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c PurchaseReservedInstancesOfferingResponse)

gmapT :: (forall b. Data b => b -> b) -> PurchaseReservedInstancesOfferingResponse -> PurchaseReservedInstancesOfferingResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> PurchaseReservedInstancesOfferingResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> PurchaseReservedInstancesOfferingResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> PurchaseReservedInstancesOfferingResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> PurchaseReservedInstancesOfferingResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> PurchaseReservedInstancesOfferingResponse -> m PurchaseReservedInstancesOfferingResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> PurchaseReservedInstancesOfferingResponse -> m PurchaseReservedInstancesOfferingResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> PurchaseReservedInstancesOfferingResponse -> m PurchaseReservedInstancesOfferingResponse

Read PurchaseReservedInstancesOfferingResponse

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

Methods

readsPrec :: Int -> ReadS PurchaseReservedInstancesOfferingResponse

readList :: ReadS [PurchaseReservedInstancesOfferingResponse]

readPrec :: ReadPrec PurchaseReservedInstancesOfferingResponse

readListPrec :: ReadPrec [PurchaseReservedInstancesOfferingResponse]

Show PurchaseReservedInstancesOfferingResponse

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

Methods

showsPrec :: Int -> PurchaseReservedInstancesOfferingResponse -> ShowS

show :: PurchaseReservedInstancesOfferingResponse -> String

showList :: [PurchaseReservedInstancesOfferingResponse] -> ShowS

Generic PurchaseReservedInstancesOfferingResponse

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

Associated Types

type Rep PurchaseReservedInstancesOfferingResponse :: Type -> Type

Methods

from :: PurchaseReservedInstancesOfferingResponse -> Rep PurchaseReservedInstancesOfferingResponse x

to :: Rep PurchaseReservedInstancesOfferingResponse x -> PurchaseReservedInstancesOfferingResponse

NFData PurchaseReservedInstancesOfferingResponse

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

Methods

rnf :: PurchaseReservedInstancesOfferingResponse -> ()

type Rep PurchaseReservedInstancesOfferingResponse

Defined in Network.AWS.EC2.PurchaseReservedInstancesOffering

type Rep PurchaseReservedInstancesOfferingResponse = D1 (MetaData "PurchaseReservedInstancesOfferingResponse" "Network.AWS.EC2.PurchaseReservedInstancesOffering" "amazonka-ec2-1.6.1-GgG1M0FWcBrE5I5IM2QktE" False) (C1 (MetaCons "PurchaseReservedInstancesOfferingResponse'" PrefixI True) (S1 (MetaSel (Just "_priorsReservedInstancesId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_priorsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))

Response Lenses

priorsReservedInstancesId :: Lens' PurchaseReservedInstancesOfferingResponse (Maybe Text)

The IDs of the purchased Reserved Instances.

priorsResponseStatus :: Lens' PurchaseReservedInstancesOfferingResponse Int

• - | The response status code.