HostReservation - Amazon Elastic Compute Cloud
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

HostReservation

Details about the Dedicated Host Reservation and associated Dedicated Hosts.

Contents

count

The number of Dedicated Hosts the reservation is associated with.

Type: Integer

Required: No

currencyCode

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

Type: String

Valid Values: USD

Required: No

duration

The length of the reservation's term, specified in seconds. Can be 31536000 (1 year) | 94608000 (3 years).

Type: Integer

Required: No

end

The date and time that the reservation ends.

Type: Timestamp

Required: No

hostIdSet

The IDs of the Dedicated Hosts associated with the reservation.

Type: Array of strings

Required: No

hostReservationId

The ID of the reservation that specifies the associated Dedicated Hosts.

Type: String

Required: No

hourlyPrice

The hourly price of the reservation.

Type: String

Required: No

instanceFamily

The instance family of the Dedicated Host Reservation. The instance family on the Dedicated Host must be the same in order for it to benefit from the reservation.

Type: String

Required: No

offeringId

The ID of the reservation. This remains the same regardless of which Dedicated Hosts are associated with it.

Type: String

Required: No

paymentOption

The payment option selected for this reservation.

Type: String

Valid Values: AllUpfront | PartialUpfront | NoUpfront

Required: No

start

The date and time that the reservation started.

Type: Timestamp

Required: No

state

The state of the reservation.

Type: String

Valid Values: payment-pending | payment-failed | active | retired

Required: No

tagSet

Any tags assigned to the Dedicated Host Reservation.

Type: Array of Tag objects

Required: No

upfrontPrice

The upfront price of the reservation.

Type: String

Required: No

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: