get_host_reservation_purchase_preview

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.