Copyright | (c) 2013-2016 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
Network.AWS.EC2.AllocateHosts
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.
- allocateHosts :: Text -> Int -> Text -> AllocateHosts
- data AllocateHosts
- ahClientToken :: Lens' AllocateHosts (Maybe Text)
- ahAutoPlacement :: Lens' AllocateHosts (Maybe AutoPlacement)
- ahInstanceType :: Lens' AllocateHosts Text
- ahQuantity :: Lens' AllocateHosts Int
- ahAvailabilityZone :: Lens' AllocateHosts Text
- allocateHostsResponse :: Int -> AllocateHostsResponse
- data AllocateHostsResponse
- ahrsHostIds :: Lens' AllocateHostsResponse [Text]
- ahrsResponseStatus :: Lens' AllocateHostsResponse Int
Creating a Request
Arguments
:: Text | |
-> Int | |
-> Text | |
-> AllocateHosts |
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:
ahClientToken
- 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
- 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: EnabledahInstanceType
- 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
- The number of Dedicated Hosts you want to allocate to your account with these parameters.ahAvailabilityZone
- The Availability Zone for the Dedicated Hosts.
data AllocateHosts #
Contains the parameters for AllocateHosts.
See: allocateHosts
smart constructor.
Instances
Request Lenses
ahClientToken :: Lens' AllocateHosts (Maybe Text) #
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) #
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 #
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 #
The number of Dedicated Hosts you want to allocate to your account with these parameters.
ahAvailabilityZone :: Lens' AllocateHosts Text #
The Availability Zone for the Dedicated Hosts.
Destructuring the Response
Arguments
:: Int | |
-> AllocateHostsResponse |
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:
ahrsHostIds
- The ID of the allocated Dedicated Host. This is used when you want to launch an instance onto a specific host.ahrsResponseStatus
- -- | The response status code.
data AllocateHostsResponse #
Contains the output of AllocateHosts.
See: allocateHostsResponse
smart constructor.
Response Lenses
ahrsHostIds :: Lens' AllocateHostsResponse [Text] #
The ID of the allocated Dedicated Host. This is used when you want to launch an instance onto a specific host.
ahrsResponseStatus :: Lens' AllocateHostsResponse Int #
- - | The response status code.