reservation_purchase_recommendations
Creates, updates, deletes, gets or lists a reservation_purchase_recommendations resource.
Overview
| Name | reservation_purchase_recommendations |
| Type | Resource |
| Id | aws.ce.reservation_purchase_recommendations |
Fields
The following fields are returned by SELECT queries:
- get_reservation_purchase_recommendation
| Name | Datatype | Description |
|---|---|---|
account_scope | string | The account scope that Amazon Web Services recommends that you purchase this instance for. For example, you can purchase this reservation for an entire organization in Amazon Web Services Organizations. (PAYER, LINKED) |
lookback_period_in_days | string | How many days of previous usage that Amazon Web Services considers when making this recommendation. (SEVEN_DAYS, THIRTY_DAYS, SIXTY_DAYS) |
payment_option | string | The payment option for the reservation (for example, AllUpfront or NoUpfront). (NO_UPFRONT, PARTIAL_UPFRONT, ALL_UPFRONT, LIGHT_UTILIZATION, MEDIUM_UTILIZATION, HEAVY_UTILIZATION) |
recommendation_details | array | Details about the recommended purchases. |
recommendation_summary | object | A summary about the recommended purchase. |
service_specification | object | Hardware specifications for the service that you want recommendations for. |
term_in_years | string | The term of the reservation that you want recommendations for, in years. (ONE_YEAR, THREE_YEARS) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_reservation_purchase_recommendation | select | region | Gets recommendations for reservation purchases. These recommendations might help you to reduce your costs. Reservations provide a discounted hourly rate (up to 75%) compared to On-Demand pricing. Amazon Web Services generates your recommendations by identifying your On-Demand usage during a specific time period and collecting your usage into categories that are eligible for a reservation. After Amazon Web Services has these categories, it simulates every combination of reservations in each category of usage to identify the best number of each type of Reserved Instance (RI) to purchase to maximize your estimated savings. For example, Amazon Web Services automatically aggregates your Amazon EC2 Linux, shared tenancy, and c4 family usage in the US West (Oregon) Region and recommends that you buy size-flexible regional reservations to apply to the c4 family usage. Amazon Web Services recommends the smallest size instance in an instance family. This makes it easier to purchase a size-flexible Reserved Instance (RI). Amazon Web Services also shows the equal number of normalized units. This way, you can purchase any instance size that you want. For this example, your RI recommendation is for c4.large because that is the smallest size instance in the c4 instance family. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
region | string | AWS region (default: us-east-1) |
SELECT examples
- get_reservation_purchase_recommendation
Gets recommendations for reservation purchases. These recommendations might help you to reduce your costs. Reservations provide a discounted hourly rate (up to 75%) compared to On-Demand pricing. Amazon Web Services generates your recommendations by identifying your On-Demand usage during a specific time period and collecting your usage into categories that are eligible for a reservation. After Amazon Web Services has these categories, it simulates every combination of reservations in each category of usage to identify the best number of each type of Reserved Instance (RI) to purchase to maximize your estimated savings. For example, Amazon Web Services automatically aggregates your Amazon EC2 Linux, shared tenancy, and c4 family usage in the US West (Oregon) Region and recommends that you buy size-flexible regional reservations to apply to the c4 family usage. Amazon Web Services recommends the smallest size instance in an instance family. This makes it easier to purchase a size-flexible Reserved Instance (RI). Amazon Web Services also shows the equal number of normalized units. This way, you can purchase any instance size that you want. For this example, your RI recommendation is for c4.large because that is the smallest size instance in the c4 instance family.
SELECT
account_scope,
lookback_period_in_days,
payment_option,
recommendation_details,
recommendation_summary,
service_specification,
term_in_years
FROM aws.ce.reservation_purchase_recommendations
WHERE region = '{{ region }}' -- required
;