host

Gets or updates an individual host resource, use hosts to retrieve a list of resources or to create or delete a resource.

Overview

Name	host
Type	Resource
Description	Resource Type definition for AWS::EC2::Host
Id	aws.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

Name	Accessible by	Required Params
update_resource	UPDATE	data__Identifier, data__PatchDocument, region
get_resource	SELECT	data__Identifier, region

SELECT Example

SELECT
region,
host_id,
auto_placement,
availability_zone,
host_recovery,
instance_type,
instance_family,
outpost_arn,
host_maintenance,
asset_id
FROM aws.ec2.host
WHERE region = 'us-east-1' AND data__Identifier = '<HostId>';

Permissions

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

Read

ec2:DescribeHosts

Update

ec2:ModifyHosts,
ec2:DescribeHosts