mac_hosts

Creates, updates, deletes, gets or lists a mac_hosts resource.

Overview

Name	mac_hosts
Type	Resource
Id	aws.ec2.mac_hosts

Fields

The following fields are returned by SELECT queries:

describe_mac_hosts

Name	Datatype	Description
host_id	string	The EC2 Mac Dedicated Host ID.
mac_os_latest_supported_versions	string	The latest macOS versions that the EC2 Mac Dedicated Host can launch without being upgraded.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
describe_mac_hosts	select	region	Filter, HostId, MaxResults, NextToken	Describes the specified EC2 Mac Dedicated Host or all of your EC2 Mac Dedicated Hosts.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
region	string	AWS region (default: us-east-1)
Filter	array	The filters. availability-zone - The Availability Zone of the EC2 Mac Dedicated Host. instance-type - The instance type size that the EC2 Mac Dedicated Host is configured to support.
HostId	array	The IDs of the EC2 Mac Dedicated Hosts.
MaxResults	integer	The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned nextToken value. This value can be between 5 and 500. If maxResults is given a larger value than 500, you receive an error.
NextToken	string	The token to use to retrieve the next page of results.

SELECT examples

describe_mac_hosts

Describes the specified EC2 Mac Dedicated Host or all of your EC2 Mac Dedicated Hosts.

SELECT
host_id,
mac_os_latest_supported_versions
FROM aws.ec2.mac_hosts
WHERE region = '{{ region }}' -- required
AND Filter = '{{ Filter }}'
AND HostId = '{{ HostId }}'
AND MaxResults = '{{ MaxResults }}'
AND NextToken = '{{ NextToken }}'
;