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

CancelReservedInstancesListing

Description

Cancels the specified Reserved Instance listing in the Reserved Instance Marketplace.

For more information about Reserved Instance Marketplace, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

Request Parameters

reservedInstancesListingId

The ID of the Reserved Instance listing to be canceled.

Type: String

Default: None

Required: Yes

Response Elements

The following elements are returned in a CancelReservedInstancesListingResponseType element.

requestId

The ID of the request.

Type: xsd:string

reservedInstancesListingsSet

The Reserved Instance listing for cancellation. The listing information is wrapped in an item element.

Type: DescribeReservedInstancesListingsResponseSetItemType

Examples

Example Request

This example cancels a Reserved Instance listing in the Reserved Instance Marketplace.

https://ec2.amazonaws.com/?Action=CancelReservedInstancesListing
&ReservedInstancesListingId.0=3ebe97b5-f273-43b6-a204-7a18cexample

Example Response

The response will show status is cancelled.

<CancelReservedInstancesListingResponse>
    <requestId>bec2cf62-98ef-434a-8a15-886fcexample</requestId>
    <reservedInstancesListingsSet>
        <item>
            <reservedInstancesListingId>3ebe97b5-f273-43b6-a204-7a18cexample</reservedInstancesListingId>
            <reservedInstancesId>af9f760e-9b3f-417a-ad5e-93f0cexample</reservedInstancesId>
            <createDate>2012-07-12T16:55:28.000Z</createDate>
            <updateDate>2012-07-12T16:55:28.000Z</updateDate>
            <status>cancelled</status>
            <statusMessage>CANCELLED</statusMessage>
            <instanceCounts>
                <item>
                    <state>Available</state>
                    <instanceCount>0</instanceCount>
                </item>
                <item>
                    <state>Sold</state>
                    <instanceCount>0</instanceCount>
                </item>
                <item>
                    <state>Cancelled</state>
                    <instanceCount>1</instanceCount>
                </item>
                <item>
                    <state>Pending</state>
                    <instanceCount>0</instanceCount>
                </item>
            </instanceCounts>
            <priceSchedules>
                <item>
                    <term>5</term>
                    <price>166.64</price>
                    <currencyCode>USD</currencyCode>
                    <active>false</active>
                </item>
                <item>
                    <term>4</term>
                    <price>133.32</price>
                    <currencyCode>USD</currencyCode>
                    <active>false</active>
                </item>
                <item>
                    <term>3</term>
                    <price>99.99</price>
                    <currencyCode>USD</currencyCode>
                    <active>false</active>
                </item>
                <item>
                    <term>2</term>
                    <price>66.66</price>
                    <currencyCode>USD</currencyCode>
                    <active>false</active>
                </item>
                <item>
                    <term>1</term>
                    <price>33.33</price>
                    <currencyCode>USD</currencyCode>
                    <active>false</active>
                </item>
            </priceSchedules>
            <tagSet/>
            <clientToken>XqJIt1342112125076</clientToken>
        </item>
    </reservedInstancesListingsSet>
</CancelReservedInstancesListingResponse>