         | Did this page help you? Yes No Tell us about it... |
rds-purchase-reserved-db-instances-offering
Description
Purchases a reserved DB Instance offering.
Syntax
rds-purchase-reserved-db-instance-offering
ReservedDBInstancesOfferingId [-c
(--instance-count) value ] [-i
(--reserved-db-instance-id) value ] [General
Options]
Options
| Name | Description | Required |
|---|---|---|
|
|
The ID of the Reserved DB Instance offering to purchase. You can also set this value using the
Type: String Default: None Example: |
Yes |
|
|
The number of DB Instances to reserve. Type: Integer Default: 1 Example: |
No |
|
|
Optional unique identifier for the purchased reservation. If this parameter is not specified, an identifier is automatically generated for the reservation. Type: String Default: None Example: |
No |
Output
The command returns a table with the following information:
ReservationId—the unique identifier for the reservation.
OfferingID—the offering identifier (only appears when the
--show-longparameter is specified).Class—the DB instance class for the reservation.
Multi-AZ—indicates if the reservation applies to Multi-AZ deployments.
Start Time—the time the reservation started
Duration—the length of the duration in years.
Fixed Price—the fixed price charged for each DB Instance in this reservation (only appears when the
--show-longparameter is specified).Usage Price—the hourly price to run each reserved DB Instance (only appears when the
--show-longparameter is specified).Count—the number of database instances reserved.
State—the payment status of the reservation.
Description—the database engine used by the reservation.
Examples
Reserve a Database Instance
This example reserves a single database instance from offering 438012d3-4052-4cc7-b2e3-8d3372e0e706.
PROMPT> rds-purchase-reserved-db-instances-offering 438012d3-4052-4cc7-b2e3-8d3372e0e706 -i myreservationID
Reserve Multiple Database Instances
This example reserves five database instances from offering 438012d3-4052-4cc7-b2e3-8d3372e0e706.
PROMPT> rds-purchase-reserved-db-instances-offering 438012d3-4052-4cc7-b2e3-8d3372e0e706 -i myreservationID -c 5
