host

Gets an individual host resource

Overview

Name	host
Type	Resource
Description	host
Id	awscc.ec2.host

Fields

Name	Datatype	Description
host_id	string	ID of the host created.
auto_placement	string	Indicates whether the host accepts any untargeted instance launches that match its instance type configuration, or if it only accepts Host tenancy instance launches that specify its unique host ID.
availability_zone	string	The Availability Zone in which to allocate the Dedicated Host.
host_recovery	string	Indicates whether to enable or disable host recovery for the Dedicated Host. Host recovery is disabled by default.
instance_type	string	Specifies the instance type to be supported by the Dedicated Hosts. If you specify an instance type, the Dedicated Hosts support instances of the specified instance type only.
instance_family	string	Specifies the instance family to be supported by the Dedicated Hosts. If you specify an instance family, the Dedicated Hosts support multiple instance types within that instance family.
outpost_arn	string	The Amazon Resource Name (ARN) of the Amazon Web Services Outpost on which to allocate the Dedicated Host.
host_maintenance	string	Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
asset_id	string	The ID of the Outpost hardware asset.
region	string	AWS region.

Methods

Currently only SELECT is supported for this resource resource.

Example

SELECT
region,
host_id,
auto_placement,
availability_zone,
host_recovery,
instance_type,
instance_family,
outpost_arn,
host_maintenance,
asset_id
FROM awscc.ec2.host
WHERE data__Identifier = '<HostId>';

Permissions

To operate on the host resource, the following permissions are required:

Read

ec2:DescribeHosts

Update

ec2:ModifyHosts,
ec2:DescribeHosts

Delete

ec2:ReleaseHosts,
ec2:DescribeHosts