get_host_reservation_purchase_preview

EC2.Client.get_host_reservation_purchase_preview(**kwargs)

Preview a reservation purchase with configurations that match those of your Dedicated Host. You must have active Dedicated Hosts in your account before you purchase a reservation.

This is a preview of the PurchaseHostReservation action and does not result in the offering being purchased.

See also: AWS API Documentation

Request Syntax

response = client.get_host_reservation_purchase_preview(
    HostIdSet=[
        'string',
    ],
    OfferingId='string'
)

Parameters

• HostIdSet (list) --

  [REQUIRED]

  The IDs of the Dedicated Hosts with which the reservation is associated.

  • (string) --
• OfferingId (string) --

  [REQUIRED]

  The offering ID of the reservation.

Return type

dict

Returns

Response Syntax

{
    'CurrencyCode': 'USD',
    'Purchase': [
        {
            'CurrencyCode': 'USD',
            'Duration': 123,
            'HostIdSet': [
                'string',
            ],
            'HostReservationId': 'string',
            'HourlyPrice': 'string',
            'InstanceFamily': 'string',
            'PaymentOption': 'AllUpfront'|'PartialUpfront'|'NoUpfront',
            'UpfrontPrice': 'string'
        },
    ],
    'TotalHourlyPrice': 'string',
    'TotalUpfrontPrice': 'string'
}

Response Structure

• (dict) --

  • CurrencyCode (string) --

    The currency in which the totalUpfrontPrice and totalHourlyPrice amounts are specified. At this time, the only supported currency is USD .

  • Purchase (list) --

    The purchase information of the Dedicated Host reservation and the Dedicated Hosts associated with it.

    • (dict) --

      Describes the result of the purchase.

      • CurrencyCode (string) --

        The currency in which the UpfrontPrice and HourlyPrice amounts are specified. At this time, the only supported currency is USD .

      • Duration (integer) --

        The duration of the reservation's term in seconds.

      • HostIdSet (list) --

        The IDs of the Dedicated Hosts associated with the reservation.

        • (string) --

      • HostReservationId (string) --

        The ID of the reservation.

      • HourlyPrice (string) --

        The hourly price of the reservation per hour.

      • InstanceFamily (string) --

        The instance family on the Dedicated Host that the reservation can be associated with.

      • PaymentOption (string) --

        The payment option for the reservation.

      • UpfrontPrice (string) --

        The upfront price of the reservation.

  • TotalHourlyPrice (string) --

    The potential total hourly price of the reservation per hour.

  • TotalUpfrontPrice (string) --

    The potential total upfront price. This is billed immediately.