Amazon Elastic Compute Cloud
User Guide (API Version 2013-02-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.Did this page help you?  Yes | No |  Tell us about it...

Selling Your Reserved Instances

This section walks you through how to list and sell your Reserved Instances in the Reserved Instance Marketplace.

As a registered seller, you can choose to sell one or more of your Reserved Instances, and you can choose to sell all of them in one listing. In addition, you can list any type of Reserved Instance—including any configuration of instance type, platform, region, and Availability Zone—as long as the following requirements are met:

  • You have already paid the upfront cost for the Reserved Instance you are listing.

    This means that you can list your Reserved Instance when it is in the Active state. However, keep in mind that a Reserved Instance can be in the Active state before AWS actually receives your payment. If this is the case, the Reserved Instance Marketplace will not allow you to list your Reserved Instance until the payment for the upfront fee is collected.

  • You have owned the Reserved Instance for at least a month.

  • There is at least a month remaining in the term of the Reserved Instance you are listing.

    You can list the remainder of the Reserved Instance term rounded down to the nearest month. For example, if you have 9 months and 13 days remaining on your Reserved Instance, you can list 9 months for your Reserved Instance.

  • The Reserved Instance is not a discounted or private Reserved Instance. You cannot list them in the Reserved Instance Marketplace.

To get details about your existing Reserved Instances, you can use any of the following tools:

For more information about Reserved Instances, see Reserved Instances.

Pricing Your Reserved Instances

When you're a seller on the Reserved Instance Marketplace, the upfront fee is the only fee that you can specify for the Reserved Instance. The upfront fee is the one-time fee that the buyer pays when the buyer purchases a Reserved Instance. The seller cannot specify the usage fee or the reoccurring fee. The buyer of your Reserved Instances will be paying the same usage or reoccurring fees that were set when the Reserved Instances were originally purchased. This usage fee applies to Light Utilization and Medium Utilization Reserved Instances, and the fee differs depending on which Reserved Instance offering you're using. The reoccurring fee is the hourly fee that you pay for Heavy Utilization, whether you're using the Reserved Instance or not. For more information about the availability of Reserved Instances offerings based on utilization, see Reserved Instances Offerings.

Setting a Pricing Schedule

You can set different upfront fees that are based on when your Reserved Instance sells. You can specify one price if the Reserved Instance sells immediately, and you can specify another price if the Reserved Instance were to sell in any subsequent month. Since the value of Reserved Instances decreases over time, by default, AWS will set prices to decrease linearly—that is, the price drops in equal increments month over month. You can choose to set the prices differently.

For example, if your Reserved Instance has nine months of its term remaining, you can specify the amount you would accept if a customer were to purchase that Reserved Instance with nine months remaining, and you could set another price with five months remaining, and yet another price with one month remaining.

Listing Your Reserved Instance

You can list the Reserved Instances you want to sell in the Reserved Instance Marketplace by using the AWS Management Console, the Amazon EC2 CLI, or the Amazon EC2 API.

AWS Management Console

To list a Reserved Instance in the Reserved Instance Marketplace

  1. Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.

  2. Click Reserved Instances in the Navigation pane.

    The Reserved Instances page displays a list of your account's instances.

  3. Select the Reserved Instances you want to list on the Marketplace, and click Sell Reserved Instances.

    List your Reserved Instances on the Marketplace

    Note

    If you have not completed the Reserved Instance Marketplace seller registration process, you will be prompted to complete this process now. For information about the seller registration process, see Registering as a Seller.

  4. In the Configure Your Reserved Instance Listing page, for Number to List, set the number of instances to sell and, for Your Price, set the upfront price for the remaining time period.

    Specify details of sale of Reserved Instances.

    You can see how the value of your Reserved Instance will change over the remainder of the term by clicking the arrow on the left of the Months Remaining column. By default, AWS sets the price to decrease linearly. This means the price drops by equal increments each month.

  5. If you are an advanced user and you want to customize the pricing, you can enter a different value for the subsequent months. To return to the default linear price drop, click the Reset button. Click Continue when you are finished configuring your listing.

    Specify price (linear) of sale of Reserved Instances.
  6. When you are satisfied with the details of your listing as displayed by the Confirm Your Reserved Instance Listing screen, click List Reserved Instance.

    You will get a confirmation that your listing is being processed.

    Confirmation of Reserved Instance listing
  7. To view the details of your Reserved Instance listing, on the Reserved Instances page, select the Reserved Instance you want to view, and click the My Listings tab in the bottom pane.

    Details of Reserved Instance listing

Amazon EC2 CLI

To list a Reserved Instance in the Reserved Instance Marketplace

  1. Get a list of your Reserved Instances by calling ec2-describe-reserved-instances.

    PROMPT> ec2-describe-reserved-instances --headers

    Amazon EC2 returns output similar to the following:

    PROMPT> ec2-describe-reserved-instances --headers
    Type	ReservedInstancesId	AvailabilityZone	InstanceType	ProductDescription	Duration	FixedPrice	UsagePrice	InstanceCount	Start	State	Currency	InstanceTenancy	OfferingType
    RESERVEDINSTANCES	f127bd27-9f30-41d3-bf45-9af45example	sa-east-1a	m1.large	Linux/UNIX	10m 	1.0	0.0	1	2012-08-22T21:41:51+0000	active	USD	default	Medium Utilization
    RESERVEDINSTANCES	1ba8e2e3-d20d-44ec-b202-fcb6aexample	sa-east-1b	m1.small	Linux/UNIX	10m 	1.2	0.032	3	2012-08-21T14:02:00+0000	retired	USD	default	Medium Utilization
    RESERVEDINSTANCES	4357912c-6f69-4966-a407-6f0cbexample	sa-east-1b	m1.small	Linux/UNIX	10m 	1.2	0.032	3	2012-08-21T14:02:00+0000	active	USD	default	Medium Utilization
    RESERVEDINSTANCES	4357912c-d032-4a97-9b49-5eb3aexample	sa-east-1b	m1.small	Linux/UNIX	10m 	1.2	0.032	1	2012-08-21T14:02:00+0000	retired	USD	default	Medium Utilization
    ...
    

    Select the Reserved Instance ID of the Reserved Instance you want to list in the Reserved Instance Marketplace.

  2. Specify the Reserved Instance ID of the Reserved Instance you want to list and call ec2-create-reserved-instances-listing. You have to specify the following required parameters:

    • Reserved Instance ID

    • Instance count

    • MONTH:PRICE

    The command should look like this example:

    PROMPT> ec2-create-reserved-instances-listing --reserved-instance b847fa93-c736-4eae-bca1-3147example --instance-count 1 05:01.20 04:01.00 01:00.75 --headers

    Amazon EC2 returns output similar to the following:

    PROMPT>LISTING	2a0ff720-f62e-4824-8ed1-7dd0aexample	b847fa93-c736-4eae-bca1-e3147example	Wed Aug 29 13:59:11 PDT 2012	Wed Aug 29 13:59:11 PDT 2012	active	active
    INSTANCE-COUNT	available	1
    INSTANCE-COUNT	sold	0
    INSTANCE-COUNT	cancelled	0
    INSTANCE-COUNT	pending	0
    PRICE-SCHEDULE	5	$1.2	
    PRICE-SCHEDULE	4	$1.0	
    PRICE-SCHEDULE	3	$1.0	
    PRICE-SCHEDULE	2	$1.0	
    PRICE-SCHEDULE	1	$0.75	
    
  3. To view the details of your Reserved Instance listing, run ec2-describe-reserved-instances-listings with the listing ID 095c0e18-c9e6-4692-97e5-653e0example.

    PROMPT> ec2-describe-reserved-instances-listings 095c0e18-c9e6-4692-97e5-653e0example

    Amazon EC2 returns output similar to the following:

    PROMPT> ec2-describe-reserved-instances-listings 095c0e18-c9e6-4692-97e5-653e0example
    Type	ReservedInstancesListingId	ReservedInstancesId	CreateDate	UpdateDate	Status	StatusMessage
    LISTING	095c0e18-c9e6-4692-97e5-653e0example	b847fa93-c736-4eae-bca1-e3147example	Tue Aug 28 18:21:07 PDT 2012	Tue Aug 28 18:21:07 PDT 2012	active	active
    INSTANCE-COUNT	available	1
    INSTANCE-COUNT	sold	0
    INSTANCE-COUNT	cancelled	0
    INSTANCE-COUNT	pending	0
    PRICE-SCHEDULE	5	$1.2	
    PRICE-SCHEDULE	4	$1.2	
    PRICE-SCHEDULE	3	$1.2	
    PRICE-SCHEDULE	2	$1.2	
    PRICE-SCHEDULE	1	$1.2	
    

Amazon EC2 API

To list a Reserved Instance in the Reserved Instance Marketplace

  1. Get a list of your Reserved Instances by calling DescribeReservedInstances.

    https://ec2.amazonaws.com/
    ?Action=DescribeReservedInstances
    &AUTHPARAMS
    

    Following is an example response.

    <DescribeReservedInstancesResponse xmlns='http://ec2.amazonaws.com/doc/2012-08-15/'>
    <requestId>ebe3410a-8f37-441d-ae11-2e78eexample</requestId>
    <reservedInstancesSet>
        <item>
            <reservedInstancesId>f127bd27-cee4-443a-a76b-a5af9example</reservedInstancesId>
            <instanceType>m1.large</instanceType>
            <availabilityZone>us-east-1a</availabilityZone>
            <start>2012-08-07T15:19:31.071Z</start>
            <duration>31536000</duration>
            <fixedPrice>276.0</fixedPrice>
            <usagePrice>0.156</usagePrice>
            <instanceCount>5</instanceCount>
            <productDescription>Linux/UNIX</productDescription>
            <state>active</state>
            <instanceTenancy>default</instanceTenancy>
            <currencyCode>USD</currencyCode>
            <offeringType>Light Utilization</offeringType>
            <recurringCharges/>
        </item>
    </reservedInstancesSet>
    </DescribeReservedInstancesResponse>
    

    Note the Reserved Instance ID of the Reserved Instance you want to list in the Reserved Instance Marketplace.

  2. Create a listing for 3 Reserved Instances from Reserved Instance ID f127bd27-cee4-443a-a76b-a5af9example and specify the following pricing schedule.

    Term (remaining months)

    11

    10

    9

    8

    7

    6

    5

    4

    3

    2

    1

    Price specified for period

    2.5

    2.0

    1.5

    0.7

    0.1

    Price

    2.5

    2.5

    2.5

    2.0

    2.0

    2.0

    1.5

    1.5

    0.7

    0.7

    0.1

    The call should look like this example:

    https://ec2.amazonaws.com/?Action=CreateReservedInstancesListing
    &ClientToken=myIdempToken1
    &ReservedInstancesId=f127bd27-cee4-443a-a76b-a5af9example
    &InstanceCount=3
    &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
    &AUTHPARAMS
                                
                                

    Following is an example response.

    <CreateReservedInstancesListingResponse>
    <requestId>a42481af-335a-4e9e-b291-bd18dexample</requestId>
    <reservedInstancesListingsSet>
        <item>
            <reservedInstancesListingId>5ec28771-05ff-4b9b-aa31-9e57dexample</reservedInstancesListingId>
            <reservedInstancesId>f127bd27-cee4-443a-a76b-a5af9example</reservedInstancesId>
            <createDate>2012-08-30T17:11:09.449Z</createDate>
            <updateDate>2012-08-30T17:11:09.468Z</updateDate>
            <status>active</status>
            <statusMessage>active</statusMessage>
            <instanceCounts>
                <item>
                    <state>Available</state>
                    <instanceCount>3</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.00</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>listRI1</clientToken>
        </item>
    </reservedInstancesListingsSet>
    </CreateReservedInstancesListingResponse>
    
  3. To view the details of your Reserved Instance listing, run DescribeReservedInstancesListings.

    The command should look like this example:

    http://ec2.amazonaws.com/?Action=DescribeReservedInstancesListings
    &AUTHPARAMS
    

    Following is an example response.

    <DescribeReservedInstancesListingsResponse>
        <requestId>cec5c904-8f3a-4de5-8f5a-ff7f9example</requestId>
        <reservedInstancesListingsSet>
            <item>
                <reservedInstancesListingId>5ec28771-05ff-4b9b-aa31-9e57dexample</reservedInstancesListingId>
                <reservedInstancesId>f127bd27-cee4-443a-a76b-a5af9example</reservedInstancesId>
                <createDate>2012-08-30T17:11:09.449Z</createDate>
                <updateDate>2012-08-30T17:11:09.468Z</updateDate>
                <status>active</status>
                <statusMessage>active</statusMessage>
                <instanceCounts>
                    <item>
                        <state>Available</state>
                        <instanceCount>3</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>listRI1</clientToken>
            </item>
        </reservedInstancesListingsSet>
    </DescribeReservedInstancesListingsResponse>
    

Viewing, Canceling, and Changing Your Listings

After listing your Reserved Instances in the Reserved Instance Marketplace, you can manage your listing using the AWS Management Console, the Amazon EC2 CLI, or the Amazon EC2 API. You can view details of your listing. You also can cancel your listing, as long as it hasn't been purchased yet.

Currently, you cannot modify your listing directly. However, you can change your listing by first canceling it and then creating another listing with new parameters.

In this section, we will show you how to perform the tasks of viewing, canceling and changing your Reserved Instance Marketplace listings, using the AWS Management Console (the Amazon EC2 console), the Amazon EC2 CLI, and the Amazon EC2 API.

AWS Management Console

To view your listing

  1. Go to the Reserved Instances page in the Amazon EC2 console and right-click your Reserved Instance.

  2. In the bottom pane, click the My Listings tab. You will see details about the Reserved Instance listing you selected.

    Details of Reserved Instance listing

To cancel your listing

You can cancel your listing anytime, as long as it's in the active state. You cannot cancel the listing if it's already matched or being processed for a sale. If some of the instances in your listing are matched and you cancel the listing, only the remaining unmatched instances will be removed from the listing.

  1. Go to the Reserved Instances page in the Amazon EC2 console, and right-click your Reserved Instance.

  2. On the My Listings tab, click Cancel Listing.

    Canceling a Reserved Instance listing

To change your listing

  1. Cancel your active Reserved Instance listing. For more information, see the previous procedure.

  2. Create a new listing. For more information, see Listing Your Reserved Instance.

Amazon EC2 CLI

To view your listing

  • Run ec2-describe-reserved-instances-listing to get details about your listing.

    PROMPT> ec2-describe-reserved-instances-listings

    Amazon EC2 returns output similar to the following:

    PROMPT> ec2-describe-reserved-instances-listings
    Type	ReservedInstancesListingId	ReservedInstancesId	CreateDate	UpdateDate	Status	StatusMessage
    LISTING	615d8a10-8224-4c19-ba7d-b9aa0example	1ba8e2e3-d20d-44ec-b202-fcb6aexample	Wed Aug 22 09:02:58 PDT 2012	Wed Aug 22 14:24:26 PDT 2012	cancelled	cancelled
    INSTANCE-COUNT	available	0
    INSTANCE-COUNT	sold	0
    INSTANCE-COUNT	cancelled	1
    INSTANCE-COUNT	pending	0
    PRICE-SCHEDULE	10	$1.2	
    PRICE-SCHEDULE	9	$1.08	
    PRICE-SCHEDULE	8	$0.96	
    PRICE-SCHEDULE	7	$0.84	
    PRICE-SCHEDULE	6	$0.72	
    PRICE-SCHEDULE	5	$0.6	
    PRICE-SCHEDULE	4	$0.48	
    PRICE-SCHEDULE	3	$0.36	
    PRICE-SCHEDULE	2	$0.24	
    PRICE-SCHEDULE	1	$0.12	
    LISTING	d5fa5166-83c3-40e4-abb2-b7298example	1ba8e2e3-d20d-44ec-b202-fcb6aexample	Wed Aug 22 14:31:55 PDT 2012	Wed Aug 22 14:42:40 PDT 2012	closed	closed
    INSTANCE-COUNT	available	0
    INSTANCE-COUNT	sold	1
    INSTANCE-COUNT	cancelled	0
    INSTANCE-COUNT	pending	0
    PRICE-SCHEDULE	10	$0.9	
    PRICE-SCHEDULE	9	$0.81	
    PRICE-SCHEDULE	8	$0.72	
    PRICE-SCHEDULE	7	$0.63	
    PRICE-SCHEDULE	6	$0.54	
    PRICE-SCHEDULE	5	$0.45	
    PRICE-SCHEDULE	4	$0.36	
    PRICE-SCHEDULE	3	$0.27	
    PRICE-SCHEDULE	2	$0.18	
    PRICE-SCHEDULE	1	$0.09	
    ....
    LISTING	095c0e18-c9e6-4692-97e5-653e0example	b847fa93-c736-4eae-bca1-e3147example	Tue Aug 28 18:21:07 PDT 2012	Tue Aug 28 18:21:07 PDT 2012	active	active
    INSTANCE-COUNT	available	1
    INSTANCE-COUNT	sold	0
    INSTANCE-COUNT	cancelled	0
    INSTANCE-COUNT	pending	0
    PRICE-SCHEDULE	5	$1.2	
    PRICE-SCHEDULE	4	$1.2	
    PRICE-SCHEDULE	3	$1.2	
    PRICE-SCHEDULE	2	$1.2	
    PRICE-SCHEDULE	1	$1.2	
    

To cancel your listing

You can cancel your listing anytime, as long as it's in the active state. You cannot cancel the listing if it's already matched or being processed for a sale.

  • Run ec2-cancel-reserved-instances-listing to cancel your listing.

    PROMPT> ec2-cancel-reserved-instances-listing 095c0e18-c9e6-4692-97e5-653e0example

    Amazon EC2 returns output similar to the following:

    PROMPT> ec2-cancel-reserved-instances-listing
    Type	ReservedInstancesListingId	ReservedInstancesId	CreateDate	UpdateDate	Status	StatusMessage
    LISTING	095c0e18-c9e6-4692-97e5-653e0example	b847fa93-c736-4eae-bca1-e3147example	Tue Aug 28 18:21:07 PDT 2012	Tue Aug 28 18:21:07 PDT 2012	cancelled	cancelled
    INSTANCE-COUNT	available	0
    INSTANCE-COUNT	sold	0
    INSTANCE-COUNT	cancelled	1
    INSTANCE-COUNT	pending	0
    PRICE-SCHEDULE	5	$1.2	
    PRICE-SCHEDULE	4	$1.2	
    PRICE-SCHEDULE	3	$1.2	
    PRICE-SCHEDULE	2	$1.2	
    PRICE-SCHEDULE	1	$1.2	
    

To change your listing

Modifying your listing involves the following steps:

  1. Cancel your active Reserved Instance listing. For more information, see the previous procedure.

  2. Create a new listing. For more information, see Listing Your Reserved Instance.

Amazon EC2 API

To view your listing

  • Call DescribeReservedInstancesListings to get details about your listing.

    The command should look like this example:

    http://ec2.amazonaws.com/?Action=DescribeReservedInstancesListings
    &AUTHPARAMS
    

    Following is an example response.

    <DescribeReservedInstancesListingsResponse>
        <requestId>cec5c904-8f3a-4de5-8f5a-ff7f9example</requestId>
        <reservedInstancesListingsSet>
            <item>
                <reservedInstancesListingId>5ec28771-05ff-4b9b-aa31-9e57dexample</reservedInstancesListingId>
                <reservedInstancesId>f127bd27-cee4-443a-a76b-a5af9example</reservedInstancesId>
                <createDate>2012-08-30T17:11:09.449Z</createDate>
                <updateDate>2012-08-30T21:00:42.300Z</updateDate>
                <status>active</status>
                <statusMessage>active</statusMessage>
                <instanceCounts>
                    <item>
                        <state>Available</state>
                        <instanceCount>2</instanceCount>
                    </item>
                    <item>
                        <state>Sold</state>
                        <instanceCount>1</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>listRI1</clientToken>
            </item>
        </reservedInstancesListingsSet>
    </DescribeReservedInstancesListingsResponse>
    

To cancel your listing

You can cancel your listing anytime as long as it's in the active state. You cannot cancel the listing if it's already matched or being processed for a sale.

  • Run CancelReservedInstancesListing to cancel your listing 5ec28771-05ff-4b9b-aa31-9e57dexample and remove it from the Reserved Instance Marketplace.

    The command should look like this example:

    https://ec2.amazonaws.com/?Action=CancelReservedInstancesListing
    &ReservedInstancesListingId.0=5ec28771-05ff-4b9b-aa31-9e57dexample
    &AUTHPARAMS
    

    Following is an example response.

    <CancelReservedInstancesListingResponse>    
        <requestId>bec2cf62-98ef-434a-8a15-886fcexample</requestId>
        <reservedInstancesListingsSet>
            <item>
                <reservedInstancesListingId>5ec28771-05ff-4b9b-aa31-9e57dexample</reservedInstancesListingId>
                <reservedInstancesId>f127bd27-cee4-443a-a76b-a5af9example</reservedInstancesId>
                <createDate>2012-08-30T17:11:09.449Z</createDate>
                <updateDate>2012-08-31T14:12:23.468Z</updateDate>
                <status>cancelled</status>
                <statusMessage>cancelled</statusMessage>
                <instanceCounts>
                    <item>
                        <state>Available</state>
                        <instanceCount>0</instanceCount>
                    </item>
                    <item>
                        <state>Sold</state>
                        <instanceCount>1</instanceCount>
                    </item>
                    <item>
                        <state>Cancelled</state>
                        <instanceCount>2</instanceCount>
                    </item>
                    <item>
                        <state>Pending</state>
                        <instanceCount>0</instanceCount>
                    </item>
                </instanceCounts>
                <priceSchedules>
                    <item>
                        <term>11</term>
                        <price>2.5</price>
                        <currencyCode>USD</currencyCode>
                        <active>false</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>listRI1</clientToken>
            </item>
        </reservedInstancesListingsSet>
    </CancelReservedInstancesListingResponse>
    

    In the response to the Cancel request, you see the canceled listing. Another way to see that canceled listing is by calling DescribeReservedInstancesListings. The request will look like this example:

    http://ec2.amazonaws.com/?Action=DescribeReservedInstancesListings
    &AUTHPARAMS
    

    The response will look like the following example:

    <DescribeReservedInstancesListingsResponse>
        <requestId>bec2cf62-98ef-434a-8a15-367c0example</requestId>
        <reservedInstancesListingsSet>
            <item>
                <reservedInstancesListingId>5ec28771-05ff-4b9b-aa31-9e57dexample</reservedInstancesListingId>
                <reservedInstancesId>f127bd27-cee4-443a-a76b-a5af9example</reservedInstancesId>
                <createDate>2012-08-30T17:11:09.449Z</createDate>
                <updateDate>2012-08-31T14:12:23.468Z</updateDate>
                <status>cancelled</status>
                <statusMessage>cancelled</statusMessage>
                <instanceCounts>
                    <item>
                        <state>Available</state>
                        <instanceCount>0</instanceCount>
                    </item>
                    <item>
                        <state>Sold</state>
                        <instanceCount>1</instanceCount>
                    </item>
                    <item>
                        <state>Cancelled</state>
                        <instanceCount>2</instanceCount>
                    </item>
                    <item>
                        <state>Pending</state>
                        <instanceCount>0</instanceCount>
                    </item>
                </instanceCounts>
                <priceSchedules>
                    <item>
                        <term>11</term>
                        <price>2.5</price>
                        <currencyCode>USD</currencyCode>
                        <active>false</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>listRI1</clientToken>
            </item>
        </reservedInstancesListingsSet>
    </DescribeReservedInstancesListingsResponse>
     

To change your listing

Modifying your listing involves the following steps:

  1. Cancel your active Reserved Instance listing. For more information, see the previous procedure.

  2. Create a new listing. For more information, see Listing Your Reserved Instance.