Amazon Elastic Compute Cloud
API Reference (API Version 2016-11-15)

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Host

Describes the properties of the Dedicated Host.

Contents

allocationTime

The time that the Dedicated Host was allocated.

Type: Timestamp

Required: No

autoPlacement

Whether auto-placement is on or off.

Type: String

Valid Values: on | off

Required: No

availabilityZone

The Availability Zone of the Dedicated Host.

Type: String

Required: No

availableCapacity

The number of new instances that can be launched onto the Dedicated Host.

Type: AvailableCapacity object

Required: No

clientToken

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

Type: String

Required: No

hostId

The ID of the Dedicated Host.

Type: String

Required: No

hostProperties

The hardware specifications of the Dedicated Host.

Type: HostProperties object

Required: No

hostRecovery

Indicates whether host recovery is enabled or disabled for the Dedicated Host.

Type: String

Valid Values: on | off

Required: No

hostReservationId

The reservation ID of the Dedicated Host. This returns a null response if the Dedicated Host doesn't have an associated reservation.

Type: String

Required: No

instances

The IDs and instance type that are currently running on the Dedicated Host.

Type: Array of HostInstance objects

Required: No

releaseTime

The time that the Dedicated Host was released.

Type: Timestamp

Required: No

state

The Dedicated Host's state.

Type: String

Valid Values: available | under-assessment | permanent-failure | released | released-permanent-failure | pending

Required: No

tagSet

Any tags assigned to the Dedicated Host.

Type: Array of Tag objects

Required: No

See Also

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

On this page: