Cette page n'est pas encore disponible en français, sa traduction est en cours. Si vous avez des questions ou des retours sur notre projet de traduction actuel, n'hésitez pas à nous contacter.
Describe a dedicated host.
Inputs
Champ
Type
Description
region [required]
enum
default: us-east-1
hostId [required]
string
Outputs
Expand All
Champ
Type
Description
hostInfo [required]
object
AutoPlacement
string
Whether auto-placement is on or off.
AvailabilityZone
string
The Availability Zone of the Dedicated Host.
AvailableCapacity
object
Information about the instances running on the Dedicated Host.
AvailableInstanceCapacity
[object]
The number of instances that can be launched onto the Dedicated Host depending on the host's available capacity. For Dedicated Hosts that support multiple instance types, this parameter represents the number of instances for each instance size that is supported on the host.
AvailableCapacity
number
The number of instances that can be launched onto the Dedicated Host based on the host's available capacity.
InstanceType
string
The instance type supported by the Dedicated Host.
TotalCapacity
number
The total number of instances that can be launched onto the Dedicated Host if there are no instances running on it.
AvailableVCpus
number
The number of vCPUs available for launching instances onto the Dedicated Host.
ClientToken
string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.
HostId
string
The ID of the Dedicated Host.
HostProperties
object
The hardware specifications of the Dedicated Host.
Cores
number
The number of cores on the Dedicated Host.
InstanceType
string
The instance type supported by the Dedicated Host. For example, m5.large. If the host supports multiple instance types, no instanceType is returned.
InstanceFamily
string
The instance family supported by the Dedicated Host. For example, m5.
Sockets
number
The number of sockets on the Dedicated Host.
TotalVCpus
number
The total number of vCPUs on the Dedicated Host.
HostReservationId
string
The reservation ID of the Dedicated Host. This returns a null response if the Dedicated Host doesn't have an associated reservation.
Instances
[object]
The IDs and instance type that are currently running on the Dedicated Host.
InstanceId
string
The ID of instance that is running on the Dedicated Host.
InstanceType
string
The instance type (for example, m3.medium) of the running instance.
OwnerId
string
The ID of the Amazon Web Services account that owns the instance.
State
string
The Dedicated Host's state.
AllocationTime
date-time
The time that the Dedicated Host was allocated.
ReleaseTime
date-time
The time that the Dedicated Host was released.
Tags
[object]
Any tags assigned to the Dedicated Host.
Key
string
The key of the tag. Constraints: Tag keys are case-sensitive and accept a maximum of 127 Unicode characters. May not begin with aws:.
Value
string
The value of the tag. Constraints: Tag values are case-sensitive and accept a maximum of 256 Unicode characters.
HostRecovery
string
Indicates whether host recovery is enabled or disabled for the Dedicated Host.
AllowsMultipleInstanceTypes
string
Indicates whether the Dedicated Host supports multiple instance types of the same instance family. If the value is on, the Dedicated Host supports multiple instance types in the instance family. If the value is off, the Dedicated Host supports a single instance type only.
OwnerId
string
The ID of the Amazon Web Services account that owns the Dedicated Host.
AvailabilityZoneId
string
The ID of the Availability Zone in which the Dedicated Host is allocated.
MemberOfServiceLinkedResourceGroup
boolean
Indicates whether the Dedicated Host is in a host resource group. If memberOfServiceLinkedResourceGroup is true, the host is in a host resource group; otherwise, it is not.
OutpostArn
string
The Amazon Resource Name (ARN) of the Amazon Web Services Outpost on which the Dedicated Host is allocated.
HostMaintenance
string
Indicates whether host maintenance is enabled or disabled for the Dedicated Host.
AssetId
string
The ID of the Outpost hardware asset on which the Dedicated Host is allocated.