Skip to content

get_reserved_instances_exchange_quote

Operation

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.

Parameters:

Name Type Description Default
request GetReservedInstancesExchangeQuoteInput | GetReservedInstancesExchangeQuoteInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[GetReservedInstancesExchangeQuoteInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
GetReservedInstancesExchangeQuoteOutput

An instance of GetReservedInstancesExchangeQuoteOutput.

get_reserved_instances_exchange_quote async

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:

Name Type Description Default
request GetReservedInstancesExchangeQuoteInput | GetReservedInstancesExchangeQuoteInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[GetReservedInstancesExchangeQuoteInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
GetReservedInstancesExchangeQuoteOutput

An instance of GetReservedInstancesExchangeQuoteOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

GetReservedInstancesExchangeQuoteInputDict

Bases: TypedDict

Dictionary form of GetReservedInstancesExchangeQuoteInput.

Attributes

dry_run instance-attribute
dry_run: bool | None

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.

reserved_instance_ids instance-attribute
reserved_instance_ids: Required[Sequence[str]]

The IDs of the Convertible Reserved Instances to exchange.

target_configurations instance-attribute

The configuration of the target Convertible Reserved Instance to exchange for your current Convertible Reserved Instances.

GetReservedInstancesExchangeQuoteInput dataclass

Bases: _SerdeShape

Contains the parameters for GetReservedInstanceExchangeQuote.

Attributes

dry_run class-attribute instance-attribute
dry_run: bool | None = ...

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.

reserved_instance_ids class-attribute instance-attribute
reserved_instance_ids: list[str] | None = ...

The IDs of the Convertible Reserved Instances to exchange.

target_configurations class-attribute instance-attribute
target_configurations: list[TargetConfigurationRequest] | None = ...

The configuration of the target Convertible Reserved Instance to exchange for your current Convertible Reserved Instances.

Output

GetReservedInstancesExchangeQuoteOutput dataclass

Bases: _SerdeShape

Contains the output of GetReservedInstancesExchangeQuote.

Attributes

currency_code class-attribute instance-attribute
currency_code: str | None = ...

The currency of the transaction.

is_valid_exchange class-attribute instance-attribute
is_valid_exchange: bool | None = ...

If true, the exchange is valid. If false, the exchange cannot be completed.

output_reserved_instances_will_expire_at class-attribute instance-attribute
output_reserved_instances_will_expire_at: datetime | None = ...

The new end date of the reservation term.

payment_due class-attribute instance-attribute
payment_due: str | None = ...

The total true upfront charge for the exchange.

reserved_instance_value_rollup class-attribute instance-attribute
reserved_instance_value_rollup: ReservationValue | None = ...

The cost associated with the Reserved Instance.

reserved_instance_value_set class-attribute instance-attribute
reserved_instance_value_set: list[ReservedInstanceReservationValue] | None = ...

The configuration of your Convertible Reserved Instances.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.

target_configuration_value_rollup class-attribute instance-attribute
target_configuration_value_rollup: ReservationValue | None = ...

The cost associated with the Reserved Instance.

target_configuration_value_set class-attribute instance-attribute
target_configuration_value_set: list[TargetReservationValue] | None = ...

The values of the target Convertible Reserved Instances.

validation_failure_reason class-attribute instance-attribute
validation_failure_reason: str | None = ...

Describes the reason why the exchange cannot be completed.