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

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Creates a listing for Amazon EC2 Standard Reserved Instances to be sold in the Reserved Instance Marketplace. You can submit one Standard Reserved Instance listing at a time. To get a list of your Standard Reserved Instances, you can use the DescribeReservedInstances operation.

Only Standard Reserved Instances can be sold in the Reserved Instance Marketplace. Convertible Reserved Instances cannot be sold.

The Reserved Instance Marketplace matches sellers who want to resell Standard 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.

To sell your Standard Reserved Instances, you must first register as a seller in the Reserved Instance Marketplace. After completing the registration process, you can create a Reserved Instance Marketplace listing of some or all of your Standard Reserved Instances, and specify the upfront price to receive for them. Your Standard Reserved Instance listings then become available for purchase. To view the details of your Standard Reserved Instance listing, you can use the DescribeReservedInstancesListings operation.

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

Synopsis

Creating a Request

data CreateReservedInstancesListing Source #

Contains the parameters for CreateReservedInstancesListing.

See: newCreateReservedInstancesListing smart constructor.

Constructors

CreateReservedInstancesListing'

Fields

clientToken :: Text
Unique, case-sensitive identifier you provide to ensure idempotency of your listings. This helps avoid duplicate listings. For more information, see Ensuring Idempotency.
instanceCount :: Int
The number of instances that are a part of a Reserved Instance account to be listed in the Reserved Instance Marketplace. This number should be less than or equal to the instance count associated with the Reserved Instance ID specified in this call.
priceSchedules :: [PriceScheduleSpecification]
A list specifying the price of the Standard Reserved Instance for each month remaining in the Reserved Instance term.
reservedInstancesId :: Text
The ID of the active Standard Reserved Instance.

Instances

Instances details

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

newCreateReservedInstancesListing Source #

Arguments

:: Text	`CreateReservedInstancesListing`
-> Int	`CreateReservedInstancesListing`
-> Text	`CreateReservedInstancesListing`
-> CreateReservedInstancesListing

Create a value of CreateReservedInstancesListing 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:

CreateReservedInstancesListing, createReservedInstancesListing_clientToken - Unique, case-sensitive identifier you provide to ensure idempotency of your listings. This helps avoid duplicate listings. For more information, see Ensuring Idempotency.

CreateReservedInstancesListing, createReservedInstancesListing_instanceCount - The number of instances that are a part of a Reserved Instance account to be listed in the Reserved Instance Marketplace. This number should be less than or equal to the instance count associated with the Reserved Instance ID specified in this call.

CreateReservedInstancesListing, createReservedInstancesListing_priceSchedules - A list specifying the price of the Standard Reserved Instance for each month remaining in the Reserved Instance term.

CreateReservedInstancesListing, createReservedInstancesListing_reservedInstancesId - The ID of the active Standard Reserved Instance.

Request Lenses

createReservedInstancesListing_clientToken :: Lens' CreateReservedInstancesListing Text Source #

Unique, case-sensitive identifier you provide to ensure idempotency of your listings. This helps avoid duplicate listings. For more information, see Ensuring Idempotency.

createReservedInstancesListing_instanceCount :: Lens' CreateReservedInstancesListing Int Source #

The number of instances that are a part of a Reserved Instance account to be listed in the Reserved Instance Marketplace. This number should be less than or equal to the instance count associated with the Reserved Instance ID specified in this call.

createReservedInstancesListing_priceSchedules :: Lens' CreateReservedInstancesListing [PriceScheduleSpecification] Source #

A list specifying the price of the Standard Reserved Instance for each month remaining in the Reserved Instance term.

createReservedInstancesListing_reservedInstancesId :: Lens' CreateReservedInstancesListing Text Source #

The ID of the active Standard Reserved Instance.

Destructuring the Response

data CreateReservedInstancesListingResponse Source #

Contains the output of CreateReservedInstancesListing.

See: newCreateReservedInstancesListingResponse smart constructor.

Constructors

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

Instances

Instances details

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

newCreateReservedInstancesListingResponse Source #

Arguments

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

Create a value of CreateReservedInstancesListingResponse 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:CreateReservedInstancesListingResponse', createReservedInstancesListingResponse_reservedInstancesListings - Information about the Standard Reserved Instance listing.

$sel:httpStatus:CreateReservedInstancesListingResponse', createReservedInstancesListingResponse_httpStatus - The response's http status code.

Response Lenses

createReservedInstancesListingResponse_reservedInstancesListings :: Lens' CreateReservedInstancesListingResponse (Maybe [ReservedInstancesListing]) Source #

Information about the Standard Reserved Instance listing.

createReservedInstancesListingResponse_httpStatus :: Lens' CreateReservedInstancesListingResponse Int Source #

The response's http status code.