amazonka-ec2-1.3.7: Amazon Elastic Compute Cloud SDK.

Copyright(c) 2013-2015 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.EC2.AllocateHosts

Contents

Description

Allocates a Dedicated host to your account. At minimum you need to specify the instance size type, Availability Zone, and quantity of hosts you want to allocate.

See: AWS API Reference for AllocateHosts.

Synopsis

Creating a Request

allocateHosts Source

Creates a value of AllocateHosts with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Request Lenses

ahClientToken :: Lens' AllocateHosts (Maybe Text) Source

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

ahAutoPlacement :: Lens' AllocateHosts (Maybe AutoPlacement) Source

This is enabled by default. This property allows instances to be automatically placed onto available Dedicated hosts, when you are launching instances without specifying a host ID.

Default: Enabled

ahInstanceType :: Lens' AllocateHosts Text Source

Specify the instance type that you want your Dedicated hosts to be configured for. When you specify the instance type, that is the only instance type that you can launch onto that host.

ahQuantity :: Lens' AllocateHosts Int Source

The number of Dedicated hosts you want to allocate to your account with these parameters.

ahAvailabilityZone :: Lens' AllocateHosts Text Source

The Availability Zone for the Dedicated hosts.

Destructuring the Response

allocateHostsResponse Source

Creates a value of AllocateHostsResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Response Lenses

ahrsHostIds :: Lens' AllocateHostsResponse [Text] Source

The ID of the allocated Dedicated host. This is used when you want to launch an instance onto a specific host.