reserved_instances_exchange_quotes

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

Overview

Name	reserved_instances_exchange_quotes
Type	Resource
Id	aws.ec2.reserved_instances_exchange_quotes

Fields

The following fields are returned by SELECT queries:

get_reserved_instances_exchange_quote

Name	Datatype	Description
currency_code	string	The currency of the transaction.
is_valid_exchange	boolean	If true, the exchange is valid. If false, the exchange cannot be completed.
output_reserved_instances_will_expire_at	string	The new end date of the reservation term.
payment_due	string	The total true upfront charge for the exchange.
reserved_instance_value_rollup	string	The cost associated with the Reserved Instance.
reserved_instance_value_set	string	The configuration of your Convertible Reserved Instances.
target_configuration_value_rollup	string	The cost associated with the Reserved Instance.
target_configuration_value_set	string	The values of the target Convertible Reserved Instances.
validation_failure_reason	string	Describes the reason why the exchange cannot be completed.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_reserved_instances_exchange_quote	select	ReservedInstanceId, region	DryRun, TargetConfiguration	Returns a quote and exchange information for exchanging one or more specified Convertible Reserved Instances for a new Convertible Reserved Instance. If the exchange cannot be performed, the reason is returned in the response. Use AcceptReservedInstancesExchangeQuote to perform the exchange.

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
ReservedInstanceId	array	The IDs of the Convertible Reserved Instances to exchange.
region	string	AWS region (default: us-east-1)
DryRun	boolean	Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
TargetConfiguration	array	The configuration of the target Convertible Reserved Instance to exchange for your current Convertible Reserved Instances.

SELECT examples

get_reserved_instances_exchange_quote

Returns a quote and exchange information for exchanging one or more specified Convertible Reserved Instances for a new Convertible Reserved Instance. If the exchange cannot be performed, the reason is returned in the response. Use AcceptReservedInstancesExchangeQuote to perform the exchange.

SELECT
currency_code,
is_valid_exchange,
output_reserved_instances_will_expire_at,
payment_due,
reserved_instance_value_rollup,
reserved_instance_value_set,
target_configuration_value_rollup,
target_configuration_value_set,
validation_failure_reason
FROM aws.ec2.reserved_instances_exchange_quotes
WHERE ReservedInstanceId = '{{ ReservedInstanceId }}' -- required
AND region = '{{ region }}' -- required
AND DryRun = '{{ DryRun }}'
AND TargetConfiguration = '{{ TargetConfiguration }}'
;