CmdID

CmdID / aws / aws ec2

aws ec2 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. AWS CLI reference

1 example 3 options Its page in the AWS CLI reference

Opens CmdID with your command. It is read in your browser and sent nowhere.

Examples

from aws-cli, each command read by CmdID

To get a quote for exchanging a Convertible Reserved Instance

The following get-reserved-instances-exchange-quote example gets the exchange information for the specified Convertible Reserved Instances.

aws ec2 get-reserved-instances-exchange-quote --reserved-instance-ids a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 --target-configurations OfferingId=6fea5434-b379-434c-b07b-a7abexampleIdentify
--reserved-instance-idsThe IDs of the Convertible Reserved Instances to exchange.
--target-configurationsThe configuration of the target Convertible Reserved Instance to exchange for your current Convertible Reserved Instances.
Its output, shortened
{
    "CurrencyCode": "USD",
    "ReservedInstanceValueSet": [
        {
            "ReservedInstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "ReservationValue": {
                "RemainingUpfrontValue": "0.000000",
                "HourlyPrice": "0.027800",
                "RemainingTotalValue": "730.556200"
            }
        }
    ],
    "PaymentDue": "424.983828",
    "TargetConfigurationValueSet": [
        {
            "TargetConfiguration": {
                "InstanceCount": 5,
                "OfferingId": "6fea5434-b379-434c-b07b-a7abexample"
            },
            "ReservationValue": {
                "RemainingUpfrontValue": "424.983828",
                "HourlyPrice": "0.016000",
                "RemainingTotalValue": "845.447828"
            }
        }
    ],
    "IsValidExchange": true,
    "OutputReservedInstancesWillExpireAt": "2020-10-01T13:03:39Z",
    "ReservedInstanceValueRollup": {
        "RemainingUpfrontValue": "0.000000",
… 9 more lines

For more information, see Exchange Convertible Reserved Instances in the Amazon EC2 User Guide.

Options

3 in the AWS CLI reference
--dry-runChecks whether you have the required permissions for the action, without actually making the request, and provides an error response.
--reserved-instance-idsThe IDs of the Convertible Reserved Instances to exchange.
--target-configurationsThe configuration of the target Convertible Reserved Instance to exchange for your current Convertible Reserved Instances.