Amazon Elastic Compute Cloud

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

See also: AWS API Documentation

Request Syntax

client.describe_mac_hosts(
    Filters=[
        {
            'Name': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    HostIds=[
        'string',
    ],
    MaxResults=123,
    NextToken='string'
)

type Filters

list

param Filters

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.

• (dict) --

  A filter name and value pair that is used to return a more specific list of results from a describe operation. Filters can be used to match a set of resources by specific criteria, such as tags, attributes, or IDs.

  If you specify multiple filters, the filters are joined with an AND , and the request returns only results that match all of the specified filters.

  • Name (string) --

    The name of the filter. Filter names are case-sensitive.

  • Values (list) --

    The filter values. Filter values are case-sensitive. If you specify multiple values for a filter, the values are joined with an OR , and the request returns all results that match any of the specified values.

    • (string) --

type HostIds

list

param HostIds

The IDs of the EC2 Mac Dedicated Hosts.

• (string) --

type MaxResults

integer

param MaxResults

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.

type NextToken

string

param NextToken

The token to use to retrieve the next page of results.

rtype

dict

returns

Response Syntax

{
    'MacHosts': [
        {
            'HostId': 'string',
            'MacOSLatestSupportedVersions': [
                'string',
            ]
        },
    ],
    'NextToken': 'string'
}

Response Structure

• (dict) --

  • MacHosts (list) --

    Information about the EC2 Mac Dedicated Hosts.

    • (dict) --

      Information about the EC2 Mac Dedicated Host.

      • HostId (string) --

        The EC2 Mac Dedicated Host ID.

      • MacOSLatestSupportedVersions (list) --

        The latest macOS versions that the EC2 Mac Dedicated Host can launch without being upgraded.

        • (string) --

  • NextToken (string) --

    The token to use to retrieve the next page of results.