Copyright | (c) 2013-2018 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
Modifies the placement attributes for a specified instance. You can do the following:
- Modify the affinity between an instance and a Dedicated Host . When affinity is set to
host
and the instance is not associated with a specific Dedicated Host, the next time the instance is launched, it is automatically associated with the host on which it lands. If the instance is restarted or rebooted, this relationship persists. - Change the Dedicated Host with which an instance is associated.
- Change the instance tenancy of an instance from
host
todedicated
, or fromdedicated
tohost
. - Move an instance to or from a placement group .
At least one attribute for affinity, host ID, tenancy, or placement group name must be specified in the request. Affinity and tenancy can be modified in the same request.
To modify the host ID, tenancy, or placement group for an instance, the instance must be in the stopped
state.
Synopsis
- modifyInstancePlacement :: Text -> ModifyInstancePlacement
- data ModifyInstancePlacement
- mipAffinity :: Lens' ModifyInstancePlacement (Maybe Affinity)
- mipHostId :: Lens' ModifyInstancePlacement (Maybe Text)
- mipTenancy :: Lens' ModifyInstancePlacement (Maybe HostTenancy)
- mipGroupName :: Lens' ModifyInstancePlacement (Maybe Text)
- mipInstanceId :: Lens' ModifyInstancePlacement Text
- modifyInstancePlacementResponse :: Int -> ModifyInstancePlacementResponse
- data ModifyInstancePlacementResponse
- miprsReturn :: Lens' ModifyInstancePlacementResponse (Maybe Bool)
- miprsResponseStatus :: Lens' ModifyInstancePlacementResponse Int
Creating a Request
modifyInstancePlacement Source #
Creates a value of ModifyInstancePlacement
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
mipAffinity
- The affinity setting for the instance.mipHostId
- The ID of the Dedicated Host with which to associate the instance.mipTenancy
- The tenancy for the instance.mipGroupName
- The name of the placement group in which to place the instance. For spread placement groups, the instance must have a tenancy ofdefault
. For cluster placement groups, the instance must have a tenancy ofdefault
ordedicated
. To remove an instance from a placement group, specify an empty string ("").mipInstanceId
- The ID of the instance that you are modifying.
data ModifyInstancePlacement Source #
Contains the parameters for ModifyInstancePlacement.
See: modifyInstancePlacement
smart constructor.
Instances
Request Lenses
mipAffinity :: Lens' ModifyInstancePlacement (Maybe Affinity) Source #
The affinity setting for the instance.
mipHostId :: Lens' ModifyInstancePlacement (Maybe Text) Source #
The ID of the Dedicated Host with which to associate the instance.
mipTenancy :: Lens' ModifyInstancePlacement (Maybe HostTenancy) Source #
The tenancy for the instance.
mipGroupName :: Lens' ModifyInstancePlacement (Maybe Text) Source #
The name of the placement group in which to place the instance. For spread placement groups, the instance must have a tenancy of default
. For cluster placement groups, the instance must have a tenancy of default
or dedicated
. To remove an instance from a placement group, specify an empty string ("").
mipInstanceId :: Lens' ModifyInstancePlacement Text Source #
The ID of the instance that you are modifying.
Destructuring the Response
modifyInstancePlacementResponse Source #
Creates a value of ModifyInstancePlacementResponse
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
miprsReturn
- Istrue
if the request succeeds, and an error otherwise.miprsResponseStatus
- -- | The response status code.
data ModifyInstancePlacementResponse Source #
Contains the output of ModifyInstancePlacement.
See: modifyInstancePlacementResponse
smart constructor.
Instances
Response Lenses
miprsReturn :: Lens' ModifyInstancePlacementResponse (Maybe Bool) Source #
Is true
if the request succeeds, and an error otherwise.
miprsResponseStatus :: Lens' ModifyInstancePlacementResponse Int Source #
- - | The response status code.