| « PreviousNext » | |
  | Did this page help you? Yes | No | Tell us about it... |
CreateReservedInstancesListing
Description
Creates a new listing for Amazon EC2 Reserved Instances that will be sold in the Reserved Instance Marketplace. You can submit one Reserved Instance listing at a time.
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.
If you want to sell your 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 Reserved Instances, and specify the upfront price you want to receive for them. Your Reserved Instance listings then become available for purchase.
For more information about Reserved Instance Marketplace, go to Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.
Request Parameters
reservedInstancesIdThe ID of the Reserved Instance that will be listed.
Type: String
Default: None
Required: Yes
instanceCountThe number of instances that are a part of a Reserved Instance account that will 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.
Type: Integer
Default: None
Required: Yes
priceSchedulesA list specifying the price of the Reserved Instance for each month remaining in the Reserved Instance term.
Type: PriceScheduleRequestSetItemType
Required: Yes
clientTokenUnique, case-sensitive identifier you provide to ensure idempotency of your listings. This helps avoid duplicate listings. For more information, go to Ensuring Idempotency in the Amazon Elastic Compute Cloud User Guide.
Type: String
Default: None
Required: Yes
Response Elements
The following elements are returned in a
CreateReservedInstancesListingResponseType element.
requestIdThe ID of the request.
Type: xsd:string
reservedInstancesListingSetThe Reserved Instances listing that was created. The listing information is wrapped in an
itemelement.
Examples
Example Request
This example creates a Reserved Instance Marketplace listing from the existing Reserved Instance named f127bd27-a218-43a4-926d-870e8a4307c1, which has 11 months remaining in its term. In this example, we set the upfront price at $2.50, and the price drops over the course of the 11-month term if the instance is still not sold:
| Term (months) | Upfront Price |
|---|---|
|
11, 10, 9 |
$2.50 |
|
8, 7, 6 |
$2.00 |
|
5, 4 |
$1.50 |
|
3, 2 |
$0.70 |
|
1 |
$0.10 |
https://ec2.amazonaws.com/?Action=CreateReservedInstancesListing &ClientToken=myIdempToken1 &InstanceCount=1 &PriceSchedules.0.Price=2.5 &PriceSchedules.0.Term=11 &PriceSchedules.1.Price=2.0 &PriceSchedules.1.Term=8 &PriceSchedules.2.Price=1.5 &PriceSchedules.2.Term=5 &PriceSchedules.3.Price=0.7 &PriceSchedules.3.Term=3 &PriceSchedules.4.Price=0.1 &PriceSchedules.4.Term=1 &ReservedInstancesId=f127bd27-a218-43a4-926d-870e8a4307c1 &AUTHPARAMS
Example Response
<CreateReservedInstancesListingResponse>
<requestId>a42481af-335a-4e9e-b291-bd18dexample</requestId>
<reservedInstancesListingsSet>
<item>
<reservedInstancesListingId>5ec28771-05ff-4b9b-aa31-9e57dexample</reservedInstancesListingId>
<reservedInstancesId>f127bd27-a218-43a4-926d-870e8example</reservedInstancesId>
<createDate>2012-07-17T17:11:09.449Z</createDate>
<updateDate>2012-07-17T17:11:09.468Z</updateDate>
<status>active</status>
<statusMessage>ACTIVE</statusMessage>
<instanceCounts>
<item>
<state>Available</state>
<instanceCount>1</instanceCount>
</item>
<item>
<state>Sold</state>
<instanceCount>0</instanceCount>
</item>
<item>
<state>Cancelled</state>
<instanceCount>0</instanceCount>
</item>
<item>
<state>Pending</state>
<instanceCount>0</instanceCount>
</item>
</instanceCounts>
<priceSchedules>
<item>
<term>11</term>
<price>2.5</price>
<currencyCode>USD</currencyCode>
<active>true</active>
</item>
<item>
<term>10</term>
<price>2.5</price>
<currencyCode>USD</currencyCode>
<active>false</active>
</item>
<item>
<term>9</term>
<price>2.5</price>
<currencyCode>USD</currencyCode>
<active>false</active>
</item>
<item>
<term>8</term>
<price>2.0</price>
<currencyCode>USD</currencyCode>
<active>false</active>
</item>
<item>
<term>7</term>
<price>2.0</price>
<currencyCode>USD</currencyCode>
<active>false</active>
</item>
<item>
<term>6</term>
<price>2.0</price>
<currencyCode>USD</currencyCode>
<active>false</active>
</item>
<item>
<term>5</term>
<price>1.5</price>
<currencyCode>USD</currencyCode>
<active>false</active>
</item>
<item>
<term>4</term>
<price>1.5</price>
<currencyCode>USD</currencyCode>
<active>false</active>
</item>
<item>
<term>3</term>
<price>0.7</price>
<currencyCode>USD</currencyCode>
<active>false</active>
</item>
<item>
<term>2</term>
<price>0.7</price>
<currencyCode>USD</currencyCode>
<active>false</active>
</item>
<item>
<term>1</term>
<price>0.1</price>
<currencyCode>USD</currencyCode>
<active>false</active>
</item>
</priceSchedules>
<tagSet/>
<clientToken>myIdempToken1</clientToken>
</item>
</reservedInstancesListingsSet>
</CreateReservedInstancesListingResponse>
