reservation_utilizations

Creates, updates, deletes, gets or lists a reservation_utilizations resource.

Overview

Name	reservation_utilizations
Type	Resource
Id	aws.ce.reservation_utilizations

Fields

The following fields are returned by SELECT queries:

get_reservation_utilization

Name	Datatype	Description
next_page_token	string	The token for the next set of retrievable results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size. (pattern: <code>[\S\s]*</code>)
total	object	The total amount of time that you used your Reserved Instances (RIs).
utilizations_by_time	array	The amount of time that you used your Reserved Instances (RIs).

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_reservation_utilization	select	region		Retrieves the reservation utilization for your account. Management account in an organization have access to member accounts. You can filter data by dimensions in a time period. You can use GetDimensionValues to determine the possible dimension values. Currently, you can group only by SUBSCRIPTION_ID.

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_utilization

Retrieves the reservation utilization for your account. Management account in an organization have access to member accounts. You can filter data by dimensions in a time period. You can use GetDimensionValues to determine the possible dimension values. Currently, you can group only by SUBSCRIPTION_ID.

SELECT
next_page_token,
total,
utilizations_by_time
FROM aws.ce.reservation_utilizations
WHERE region = '{{ region }}' -- required
;