AWS EC2

Describe EC2 host

このページは日本語には対応しておりません。随時翻訳に取り組んでいます。翻訳に関してご質問やご意見ございましたら、お気軽にご連絡ください。

Describe a dedicated host.

Inputs

フィールド

種類

説明

region [required]

enum

default: us-east-1

hostId [required]

string

Outputs

Expand All

フィールド

種類

説明

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.

amzRequestId [required]

string