Skip to content

Get Reserved Instances Exchange Quote

ec2_get_reserved_instances_exchange_quote R Documentation

Returns a quote and exchange information for exchanging one or more specified Convertible Reserved Instances for a new Convertible Reserved Instance

Description

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 accept_reserved_instances_exchange_quote to perform the exchange.

Usage

ec2_get_reserved_instances_exchange_quote(DryRun, ReservedInstanceIds,
  TargetConfigurations)

Arguments

DryRun

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.

ReservedInstanceIds

[required] The IDs of the Convertible Reserved Instances to exchange.

TargetConfigurations

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

Value

A list with the following syntax:

list(
  CurrencyCode = "string",
  IsValidExchange = TRUE|FALSE,
  OutputReservedInstancesWillExpireAt = as.POSIXct(
    "2015-01-01"
  ),
  PaymentDue = "string",
  ReservedInstanceValueRollup = list(
    HourlyPrice = "string",
    RemainingTotalValue = "string",
    RemainingUpfrontValue = "string"
  ),
  ReservedInstanceValueSet = list(
    list(
      ReservationValue = list(
        HourlyPrice = "string",
        RemainingTotalValue = "string",
        RemainingUpfrontValue = "string"
      ),
      ReservedInstanceId = "string"
    )
  ),
  TargetConfigurationValueRollup = list(
    HourlyPrice = "string",
    RemainingTotalValue = "string",
    RemainingUpfrontValue = "string"
  ),
  TargetConfigurationValueSet = list(
    list(
      ReservationValue = list(
        HourlyPrice = "string",
        RemainingTotalValue = "string",
        RemainingUpfrontValue = "string"
      ),
      TargetConfiguration = list(
        InstanceCount = 123,
        OfferingId = "string"
      )
    )
  ),
  ValidationFailureReason = "string"
)

Request syntax

svc$get_reserved_instances_exchange_quote(
  DryRun = TRUE|FALSE,
  ReservedInstanceIds = list(
    "string"
  ),
  TargetConfigurations = list(
    list(
      InstanceCount = 123,
      OfferingId = "string"
    )
  )
)