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.DescribeHostReservationOfferings

Contents

Description

Describes the Dedicated Host Reservations that are available to purchase.

The results describe all the Dedicated Host Reservation offerings, including offerings that may not match the instance family and region of your Dedicated Hosts. When purchasing an offering, ensure that the the instance family and region of the offering matches that of the Dedicated Hosts it will be associated with. For an overview of supported instance types, see <http:docs.aws.amazon.comAWSEC2latestUserGuidededicated-hosts-overview.html Dedicated Hosts Overview> in the Amazon Elastic Compute Cloud User Guide/ .

Synopsis

Creating a Request

describeHostReservationOfferings :: DescribeHostReservationOfferings Source #

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

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

  • dhroMaxDuration - This is the maximum duration of the reservation you'd like to purchase, specified in seconds. Reservations are available in one-year and three-year terms. The number of seconds specified must be the number of seconds in a year (365x24x60x60) times one of the supported durations (1 or 3). For example, specify 94608000 for three years.
  • dhroNextToken - The token to use to retrieve the next page of results.
  • dhroMinDuration - This is the minimum duration of the reservation you'd like to purchase, specified in seconds. Reservations are available in one-year and three-year terms. The number of seconds specified must be the number of seconds in a year (365x24x60x60) times one of the supported durations (1 or 3). For example, specify 31536000 for one year.
  • dhroOfferingId - The ID of the reservation offering.
  • dhroFilter - One or more filters. * instance-family - The instance family of the offering (e.g., m4 ). * payment-option - The payment option (No Upfront | Partial Upfront | All Upfront ).
  • dhroMaxResults - The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned nextToken value. This value can be between 5 and 500; if maxResults is given a larger value than 500, you will receive an error.

data DescribeHostReservationOfferings Source #

See: describeHostReservationOfferings smart constructor.

Instances

Eq DescribeHostReservationOfferings Source # 
Data DescribeHostReservationOfferings Source # 

Methods

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

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

toConstr :: DescribeHostReservationOfferings -> Constr #

dataTypeOf :: DescribeHostReservationOfferings -> DataType #

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c DescribeHostReservationOfferings) #

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

gmapT :: (forall b. Data b => b -> b) -> DescribeHostReservationOfferings -> DescribeHostReservationOfferings #

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

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

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

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

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

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

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

Read DescribeHostReservationOfferings Source # 
Show DescribeHostReservationOfferings Source # 
Generic DescribeHostReservationOfferings Source # 
Hashable DescribeHostReservationOfferings Source # 
NFData DescribeHostReservationOfferings Source # 
AWSRequest DescribeHostReservationOfferings Source # 
ToPath DescribeHostReservationOfferings Source # 
ToHeaders DescribeHostReservationOfferings Source # 
ToQuery DescribeHostReservationOfferings Source # 
type Rep DescribeHostReservationOfferings Source # 
type Rep DescribeHostReservationOfferings = D1 (MetaData "DescribeHostReservationOfferings" "Network.AWS.EC2.DescribeHostReservationOfferings" "amazonka-ec2-1.4.5-4J1X1aohvSR7xjHvMmTrf6" False) (C1 (MetaCons "DescribeHostReservationOfferings'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_dhroMaxDuration") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Int))) ((:*:) (S1 (MetaSel (Just Symbol "_dhroNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_dhroMinDuration") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Int))))) ((:*:) (S1 (MetaSel (Just Symbol "_dhroOfferingId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_dhroFilter") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Filter]))) (S1 (MetaSel (Just Symbol "_dhroMaxResults") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Int)))))))
type Rs DescribeHostReservationOfferings Source # 

Request Lenses

dhroMaxDuration :: Lens' DescribeHostReservationOfferings (Maybe Int) Source #

This is the maximum duration of the reservation you'd like to purchase, specified in seconds. Reservations are available in one-year and three-year terms. The number of seconds specified must be the number of seconds in a year (365x24x60x60) times one of the supported durations (1 or 3). For example, specify 94608000 for three years.

dhroNextToken :: Lens' DescribeHostReservationOfferings (Maybe Text) Source #

The token to use to retrieve the next page of results.

dhroMinDuration :: Lens' DescribeHostReservationOfferings (Maybe Int) Source #

This is the minimum duration of the reservation you'd like to purchase, specified in seconds. Reservations are available in one-year and three-year terms. The number of seconds specified must be the number of seconds in a year (365x24x60x60) times one of the supported durations (1 or 3). For example, specify 31536000 for one year.

dhroOfferingId :: Lens' DescribeHostReservationOfferings (Maybe Text) Source #

The ID of the reservation offering.

dhroFilter :: Lens' DescribeHostReservationOfferings [Filter] Source #

One or more filters. * instance-family - The instance family of the offering (e.g., m4 ). * payment-option - The payment option (No Upfront | Partial Upfront | All Upfront ).

dhroMaxResults :: Lens' DescribeHostReservationOfferings (Maybe Int) Source #

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned nextToken value. This value can be between 5 and 500; if maxResults is given a larger value than 500, you will receive an error.

Destructuring the Response

describeHostReservationOfferingsResponse Source #

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

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

data DescribeHostReservationOfferingsResponse Source #

Instances

Eq DescribeHostReservationOfferingsResponse Source # 
Data DescribeHostReservationOfferingsResponse Source # 

Methods

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

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

toConstr :: DescribeHostReservationOfferingsResponse -> Constr #

dataTypeOf :: DescribeHostReservationOfferingsResponse -> DataType #

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c DescribeHostReservationOfferingsResponse) #

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

gmapT :: (forall b. Data b => b -> b) -> DescribeHostReservationOfferingsResponse -> DescribeHostReservationOfferingsResponse #

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

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

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

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

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

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

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

Read DescribeHostReservationOfferingsResponse Source # 
Show DescribeHostReservationOfferingsResponse Source # 
Generic DescribeHostReservationOfferingsResponse Source # 
NFData DescribeHostReservationOfferingsResponse Source # 
type Rep DescribeHostReservationOfferingsResponse Source # 
type Rep DescribeHostReservationOfferingsResponse = D1 (MetaData "DescribeHostReservationOfferingsResponse" "Network.AWS.EC2.DescribeHostReservationOfferings" "amazonka-ec2-1.4.5-4J1X1aohvSR7xjHvMmTrf6" False) (C1 (MetaCons "DescribeHostReservationOfferingsResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_dhrorsOfferingSet") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [HostOffering]))) ((:*:) (S1 (MetaSel (Just Symbol "_dhrorsNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_dhrorsResponseStatus") NoSourceUnpackedness SourceStrict DecidedUnpack) (Rec0 Int)))))

Response Lenses

dhrorsNextToken :: Lens' DescribeHostReservationOfferingsResponse (Maybe Text) Source #

The token to use to retrieve the next page of results. This value is null when there are no more results to return.