Copyright	(c) 2013-2023 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	Safe-Inferred
Language	Haskell2010

Amazonka.EC2.DescribeReservedInstancesListings

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Describes your account's Reserved Instance listings in the Reserved Instance Marketplace.

The Reserved Instance Marketplace matches sellers who want to resell Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

As a seller, you choose to list some or all of your Reserved Instances, and you specify the upfront price to receive for them. Your Reserved Instances are then listed in the Reserved Instance Marketplace and are available for purchase.

As a buyer, you specify the configuration of the Reserved Instance to purchase, and the Marketplace matches what you're searching for with what's available. The Marketplace first sells the lowest priced Reserved Instances to you, and continues to sell available Reserved Instance listings to you until your demand is met. You are charged based on the total price of all of the listings that you purchase.

For more information, see Reserved Instance Marketplace in the Amazon EC2 User Guide.

Synopsis

Creating a Request

data DescribeReservedInstancesListings Source #

Contains the parameters for DescribeReservedInstancesListings.

See: newDescribeReservedInstancesListings smart constructor.

Constructors

DescribeReservedInstancesListings'

Fields

filters :: Maybe [Filter]
One or more filters.
- reserved-instances-id - The ID of the Reserved Instances.
- reserved-instances-listing-id - The ID of the Reserved Instances listing.
- status - The status of the Reserved Instance listing (pending | active | cancelled | closed).
- status-message - The reason for the status.
reservedInstancesId :: Maybe Text
One or more Reserved Instance IDs.
reservedInstancesListingId :: Maybe Text
One or more Reserved Instance listing IDs.

Instances

Instances details

ToHeaders DescribeReservedInstancesListings Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings Methods toHeaders :: DescribeReservedInstancesListings -> [Header] #
ToPath DescribeReservedInstancesListings Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings Methods toPath :: DescribeReservedInstancesListings -> ByteString #
ToQuery DescribeReservedInstancesListings Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings Methods toQuery :: DescribeReservedInstancesListings -> QueryString #
AWSRequest DescribeReservedInstancesListings Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings Associated Types type AWSResponse DescribeReservedInstancesListings # Methods request :: (Service -> Service) -> DescribeReservedInstancesListings -> Request DescribeReservedInstancesListings # response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy DescribeReservedInstancesListings -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse DescribeReservedInstancesListings))) #
Generic DescribeReservedInstancesListings Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings Associated Types type Rep DescribeReservedInstancesListings :: Type -> Type # Methods from :: DescribeReservedInstancesListings -> Rep DescribeReservedInstancesListings x # to :: Rep DescribeReservedInstancesListings x -> DescribeReservedInstancesListings #
Read DescribeReservedInstancesListings Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings Methods readsPrec :: Int -> ReadS DescribeReservedInstancesListings # readList :: ReadS [DescribeReservedInstancesListings] # readPrec :: ReadPrec DescribeReservedInstancesListings # readListPrec :: ReadPrec [DescribeReservedInstancesListings] #
Show DescribeReservedInstancesListings Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings Methods showsPrec :: Int -> DescribeReservedInstancesListings -> ShowS # show :: DescribeReservedInstancesListings -> String # showList :: [DescribeReservedInstancesListings] -> ShowS #
NFData DescribeReservedInstancesListings Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings Methods rnf :: DescribeReservedInstancesListings -> () #
Eq DescribeReservedInstancesListings Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings Methods (==) :: DescribeReservedInstancesListings -> DescribeReservedInstancesListings -> Bool # (/=) :: DescribeReservedInstancesListings -> DescribeReservedInstancesListings -> Bool #
Hashable DescribeReservedInstancesListings Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings Methods hashWithSalt :: Int -> DescribeReservedInstancesListings -> Int # hash :: DescribeReservedInstancesListings -> Int #
type AWSResponse DescribeReservedInstancesListings Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings type AWSResponse DescribeReservedInstancesListings = DescribeReservedInstancesListingsResponse
type Rep DescribeReservedInstancesListings Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings type Rep DescribeReservedInstancesListings = D1 ('MetaData "DescribeReservedInstancesListings" "Amazonka.EC2.DescribeReservedInstancesListings" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "DescribeReservedInstancesListings'" 'PrefixI 'True) (S1 ('MetaSel ('Just "filters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Filter])) :: (S1 ('MetaSel ('Just "reservedInstancesId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "reservedInstancesListingId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))))

newDescribeReservedInstancesListings :: DescribeReservedInstancesListings Source #

Create a value of DescribeReservedInstancesListings with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:filters:DescribeReservedInstancesListings', describeReservedInstancesListings_filters - One or more filters.

reserved-instances-id - The ID of the Reserved Instances.
reserved-instances-listing-id - The ID of the Reserved Instances listing.
status - The status of the Reserved Instance listing (pending | active | cancelled | closed).
status-message - The reason for the status.

DescribeReservedInstancesListings, describeReservedInstancesListings_reservedInstancesId - One or more Reserved Instance IDs.

DescribeReservedInstancesListings, describeReservedInstancesListings_reservedInstancesListingId - One or more Reserved Instance listing IDs.

Request Lenses

describeReservedInstancesListings_filters :: Lens' DescribeReservedInstancesListings (Maybe [Filter]) Source #

One or more filters.

reserved-instances-id - The ID of the Reserved Instances.
reserved-instances-listing-id - The ID of the Reserved Instances listing.
status - The status of the Reserved Instance listing (pending | active | cancelled | closed).
status-message - The reason for the status.

describeReservedInstancesListings_reservedInstancesId :: Lens' DescribeReservedInstancesListings (Maybe Text) Source #

One or more Reserved Instance IDs.

describeReservedInstancesListings_reservedInstancesListingId :: Lens' DescribeReservedInstancesListings (Maybe Text) Source #

One or more Reserved Instance listing IDs.

Destructuring the Response

data DescribeReservedInstancesListingsResponse Source #

Contains the output of DescribeReservedInstancesListings.

See: newDescribeReservedInstancesListingsResponse smart constructor.

Constructors

DescribeReservedInstancesListingsResponse'
Fields reservedInstancesListings :: Maybe [ReservedInstancesListing] Information about the Reserved Instance listing. httpStatus :: Int The response's http status code.

Instances

Instances details

Generic DescribeReservedInstancesListingsResponse Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings Associated Types type Rep DescribeReservedInstancesListingsResponse :: Type -> Type # Methods from :: DescribeReservedInstancesListingsResponse -> Rep DescribeReservedInstancesListingsResponse x # to :: Rep DescribeReservedInstancesListingsResponse x -> DescribeReservedInstancesListingsResponse #
Read DescribeReservedInstancesListingsResponse Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings Methods readsPrec :: Int -> ReadS DescribeReservedInstancesListingsResponse # readList :: ReadS [DescribeReservedInstancesListingsResponse] # readPrec :: ReadPrec DescribeReservedInstancesListingsResponse # readListPrec :: ReadPrec [DescribeReservedInstancesListingsResponse] #
Show DescribeReservedInstancesListingsResponse Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings Methods showsPrec :: Int -> DescribeReservedInstancesListingsResponse -> ShowS # show :: DescribeReservedInstancesListingsResponse -> String # showList :: [DescribeReservedInstancesListingsResponse] -> ShowS #
NFData DescribeReservedInstancesListingsResponse Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings Methods rnf :: DescribeReservedInstancesListingsResponse -> () #
Eq DescribeReservedInstancesListingsResponse Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings Methods (==) :: DescribeReservedInstancesListingsResponse -> DescribeReservedInstancesListingsResponse -> Bool # (/=) :: DescribeReservedInstancesListingsResponse -> DescribeReservedInstancesListingsResponse -> Bool #
type Rep DescribeReservedInstancesListingsResponse Source #
Instance details Defined in Amazonka.EC2.DescribeReservedInstancesListings type Rep DescribeReservedInstancesListingsResponse = D1 ('MetaData "DescribeReservedInstancesListingsResponse" "Amazonka.EC2.DescribeReservedInstancesListings" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "DescribeReservedInstancesListingsResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "reservedInstancesListings") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [ReservedInstancesListing])) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newDescribeReservedInstancesListingsResponse Source #

Arguments

:: Int	`$sel:httpStatus:DescribeReservedInstancesListingsResponse'`
-> DescribeReservedInstancesListingsResponse

Create a value of DescribeReservedInstancesListingsResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:reservedInstancesListings:DescribeReservedInstancesListingsResponse', describeReservedInstancesListingsResponse_reservedInstancesListings - Information about the Reserved Instance listing.

$sel:httpStatus:DescribeReservedInstancesListingsResponse', describeReservedInstancesListingsResponse_httpStatus - The response's http status code.

Response Lenses

describeReservedInstancesListingsResponse_reservedInstancesListings :: Lens' DescribeReservedInstancesListingsResponse (Maybe [ReservedInstancesListing]) Source #

Information about the Reserved Instance listing.

describeReservedInstancesListingsResponse_httpStatus :: Lens' DescribeReservedInstancesListingsResponse Int Source #

The response's http status code.