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

:: Text

prioReservedInstancesOfferingId

-> Int

prioInstanceCount

-> 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 .
• prioReservedInstancesOfferingId - The ID of the Reserved Instance offering to purchase.
• prioInstanceCount - The number of Reserved Instances to purchase.

data PurchaseReservedInstancesOffering

Contains the parameters for PurchaseReservedInstancesOffering.

See: purchaseReservedInstancesOffering smart constructor.

Instances

Eq PurchaseReservedInstancesOffering

Methods

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

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

Data 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

Methods

readsPrec :: Int -> ReadS PurchaseReservedInstancesOffering

readList :: ReadS [PurchaseReservedInstancesOffering]

readPrec :: ReadPrec PurchaseReservedInstancesOffering

readListPrec :: ReadPrec [PurchaseReservedInstancesOffering]

Show PurchaseReservedInstancesOffering

Methods

showsPrec :: Int -> PurchaseReservedInstancesOffering -> ShowS

show :: PurchaseReservedInstancesOffering -> String

showList :: [PurchaseReservedInstancesOffering] -> ShowS

Generic PurchaseReservedInstancesOffering

Associated Types

type Rep PurchaseReservedInstancesOffering :: * -> *

Methods

from :: PurchaseReservedInstancesOffering -> Rep PurchaseReservedInstancesOffering x

to :: Rep PurchaseReservedInstancesOffering x -> PurchaseReservedInstancesOffering

Hashable PurchaseReservedInstancesOffering

Methods

hashWithSalt :: Int -> PurchaseReservedInstancesOffering -> Int

hash :: PurchaseReservedInstancesOffering -> Int

NFData PurchaseReservedInstancesOffering

Methods

rnf :: PurchaseReservedInstancesOffering -> ()

AWSRequest PurchaseReservedInstancesOffering

Associated Types

type Rs PurchaseReservedInstancesOffering :: *

Methods

request :: PurchaseReservedInstancesOffering -> Request PurchaseReservedInstancesOffering

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

ToPath PurchaseReservedInstancesOffering

Methods

toPath :: PurchaseReservedInstancesOffering -> ByteString

ToHeaders PurchaseReservedInstancesOffering

Methods

toHeaders :: PurchaseReservedInstancesOffering -> [Header]

ToQuery PurchaseReservedInstancesOffering

Methods

toQuery :: PurchaseReservedInstancesOffering -> QueryString

type Rep PurchaseReservedInstancesOffering

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

type Rs 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 .

prioReservedInstancesOfferingId :: Lens' PurchaseReservedInstancesOffering Text

The ID of the Reserved Instance offering to purchase.

prioInstanceCount :: Lens' PurchaseReservedInstancesOffering Int

The number of Reserved Instances 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

Methods

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

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

Data PurchaseReservedInstancesOfferingResponse

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

Methods

readsPrec :: Int -> ReadS PurchaseReservedInstancesOfferingResponse

readList :: ReadS [PurchaseReservedInstancesOfferingResponse]

readPrec :: ReadPrec PurchaseReservedInstancesOfferingResponse

readListPrec :: ReadPrec [PurchaseReservedInstancesOfferingResponse]

Show PurchaseReservedInstancesOfferingResponse

Methods

showsPrec :: Int -> PurchaseReservedInstancesOfferingResponse -> ShowS

show :: PurchaseReservedInstancesOfferingResponse -> String

showList :: [PurchaseReservedInstancesOfferingResponse] -> ShowS

Generic PurchaseReservedInstancesOfferingResponse

Associated Types

type Rep PurchaseReservedInstancesOfferingResponse :: * -> *

Methods

from :: PurchaseReservedInstancesOfferingResponse -> Rep PurchaseReservedInstancesOfferingResponse x

to :: Rep PurchaseReservedInstancesOfferingResponse x -> PurchaseReservedInstancesOfferingResponse

NFData PurchaseReservedInstancesOfferingResponse

Methods

rnf :: PurchaseReservedInstancesOfferingResponse -> ()

type Rep PurchaseReservedInstancesOfferingResponse

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

Response Lenses

priorsReservedInstancesId :: Lens' PurchaseReservedInstancesOfferingResponse (Maybe Text)

The IDs of the purchased Reserved Instances.

priorsResponseStatus :: Lens' PurchaseReservedInstancesOfferingResponse Int

• - | The response status code.