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

Tools and Prerequisites

To work with Reserved Instances, we assume you have read and completed the instructions described in Getting Started with EC2, which provides information on creating your Amazon EC2 account and credentials.

You can use the AWS Management Console, the Command Line Tools, or the API to work with Amazon EC2 Reserved Instances and search for offerings.

If you use the Amazon EC2 command line interface (CLI) tools, we assume that you have read and completed the instructions described in Getting Started with the Command Line Tools. This topic walks you through setting up your environment for use with the CLI tools.

In addition, whichever you choose to use—AWS Management Console, the CLI, or API—Amazon EC2 provides tools that help you to identify Reserved Instances offerings, purchase your Reserved Instances, and manage them.

AWS Management Console

The AWS Management Console has tools specifically designed for Reserved Instances tasks. The console also has general tools that you can use to manage the instances launched when you use your Reserved Instances. The following list identifies the tools you can use in the AWS Management Console:

  • The Reserved Instances page is where you interact with your Reserved Instances.

    The Reserved Instances page in the AWS Management Console

  • Use the Purchase Reserved Instances page to specify the details of Reserved Instances you want to purchase.

    The Purchase Reserved Instances page in the AWS Management Console

  • Use the Instances page to manage the instances you launched using your Reserved Instances.

    The Instances page in the AWS Management Console

Command Line Tools

To purchase Reserved Instances, you use Amazon EC2 command line interface (CLI) tools specifically designed for these tasks. To manage the instances when your Reserved Instances are launched, use the same CLI commands that you use for Amazon EC2 instances.

The following table lists the CLI commands you use for Reserved Instances tasks.

TaskCLI

List Reserved Instances that you have purchased.

ec2-describe-reserved-instances

View the Reserved Instances offerings that are available for purchase.

ec2-describe-reserved-instances-offerings

Purchase a Reserved Instance.

ec2-purchase-reserved-instances-offering

For information about CLI commands, see the Amazon Elastic Compute Cloud Command Line Reference.

API

To purchase Reserved Instances, you use API calls specifically designed for these tasks. To manage the instances when your Reserved Instances are launched, use the same API calls that you use for Amazon EC2 instances.

The following table lists the API calls you use for Reserved Instances tasks.

TaskAPI

List Reserved Instances that you have purchased.

DescribeReservedInstances

View the Reserved Instances offerings that are available for purchase.

DescribeReservedInstancesOfferings

Purchase a Reserved Instance.

PurchaseReservedInstancesOffering

For information about API actions, see the Amazon Elastic Compute Cloud API Reference.