Redshift / Client / accept_reserved_node_exchange

accept_reserved_node_exchange

Redshift.Client.accept_reserved_node_exchange(**kwargs)

Exchanges a DC1 Reserved Node for a DC2 Reserved Node with no changes to the configuration (term, payment type, or number of nodes) and no additional costs.

See also: AWS API Documentation

Request Syntax

response = client.accept_reserved_node_exchange(
    ReservedNodeId='string',
    TargetReservedNodeOfferingId='string'
)

Parameters:

• ReservedNodeId (string) –

  [REQUIRED]

  A string representing the node identifier of the DC1 Reserved Node to be exchanged.

• TargetReservedNodeOfferingId (string) –

  [REQUIRED]

  The unique identifier of the DC2 Reserved Node offering to be used for the exchange. You can obtain the value for the parameter by calling GetReservedNodeExchangeOfferings

Return type:

dict

Returns:

Response Syntax

{
    'ExchangedReservedNode': {
        'ReservedNodeId': 'string',
        'ReservedNodeOfferingId': 'string',
        'NodeType': 'string',
        'StartTime': datetime(2015, 1, 1),
        'Duration': 123,
        'FixedPrice': 123.0,
        'UsagePrice': 123.0,
        'CurrencyCode': 'string',
        'NodeCount': 123,
        'State': 'string',
        'OfferingType': 'string',
        'RecurringCharges': [
            {
                'RecurringChargeAmount': 123.0,
                'RecurringChargeFrequency': 'string'
            },
        ],
        'ReservedNodeOfferingType': 'Regular'|'Upgradable'
    }
}

Response Structure

• (dict) –

  • ExchangedReservedNode (dict) –

    • ReservedNodeId (string) –

      The unique identifier for the reservation.

    • ReservedNodeOfferingId (string) –

      The identifier for the reserved node offering.

    • NodeType (string) –

      The node type of the reserved node.

    • StartTime (datetime) –

      The time the reservation started. You purchase a reserved node offering for a duration. This is the start time of that duration.

    • Duration (integer) –

      The duration of the node reservation in seconds.

    • FixedPrice (float) –

      The fixed cost Amazon Redshift charges you for this reserved node.

    • UsagePrice (float) –

      The hourly rate Amazon Redshift charges you for this reserved node.

    • CurrencyCode (string) –

      The currency code for the reserved cluster.

    • NodeCount (integer) –

      The number of reserved compute nodes.

    • State (string) –

      The state of the reserved compute node.

      Possible Values:

      • pending-payment-This reserved node has recently been purchased, and the sale has been approved, but payment has not yet been confirmed.

      • active-This reserved node is owned by the caller and is available for use.

      • payment-failed-Payment failed for the purchase attempt.

      • retired-The reserved node is no longer available.

      • exchanging-The owner is exchanging the reserved node for another reserved node.

    • OfferingType (string) –

      The anticipated utilization of the reserved node, as defined in the reserved node offering.

    • RecurringCharges (list) –

      The recurring charges for the reserved node.

      • (dict) –

        Describes a recurring charge.

        • RecurringChargeAmount (float) –

          The amount charged per the period of time specified by the recurring charge frequency.

        • RecurringChargeFrequency (string) –

          The frequency at which the recurring charge amount is applied.

    • ReservedNodeOfferingType (string) –

Exceptions

• Redshift.Client.exceptions.ReservedNodeNotFoundFault

• Redshift.Client.exceptions.InvalidReservedNodeStateFault

• Redshift.Client.exceptions.ReservedNodeAlreadyMigratedFault

• Redshift.Client.exceptions.ReservedNodeOfferingNotFoundFault

• Redshift.Client.exceptions.UnsupportedOperationFault

• Redshift.Client.exceptions.DependentServiceUnavailableFault

• Redshift.Client.exceptions.ReservedNodeAlreadyExistsFault