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

Network.AWS.EC2.ModifyInstancePlacement

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

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 to dedicated , or from dedicated to host .
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.

Creating a Request

modifyInstancePlacement #

Arguments

:: Text	`mipInstanceId`
-> ModifyInstancePlacement

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 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 - The ID of the instance that you are modifying.

data ModifyInstancePlacement #

Contains the parameters for ModifyInstancePlacement.

See: modifyInstancePlacement smart constructor.

Instances

Eq ModifyInstancePlacement #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement Methods (==) :: ModifyInstancePlacement -> ModifyInstancePlacement -> Bool # (/=) :: ModifyInstancePlacement -> ModifyInstancePlacement -> Bool #
Data ModifyInstancePlacement #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> ModifyInstancePlacement -> c ModifyInstancePlacement # gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c ModifyInstancePlacement # toConstr :: ModifyInstancePlacement -> Constr # dataTypeOf :: ModifyInstancePlacement -> DataType # dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c ModifyInstancePlacement) # dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c ModifyInstancePlacement) # gmapT :: (forall b. Data b => b -> b) -> ModifyInstancePlacement -> ModifyInstancePlacement # gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> ModifyInstancePlacement -> r # gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> ModifyInstancePlacement -> r # gmapQ :: (forall d. Data d => d -> u) -> ModifyInstancePlacement -> [u] # gmapQi :: Int -> (forall d. Data d => d -> u) -> ModifyInstancePlacement -> u # gmapM :: Monad m => (forall d. Data d => d -> m d) -> ModifyInstancePlacement -> m ModifyInstancePlacement # gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> ModifyInstancePlacement -> m ModifyInstancePlacement # gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> ModifyInstancePlacement -> m ModifyInstancePlacement #
Read ModifyInstancePlacement #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement Methods readsPrec :: Int -> ReadS ModifyInstancePlacement # readList :: ReadS [ModifyInstancePlacement] # readPrec :: ReadPrec ModifyInstancePlacement # readListPrec :: ReadPrec [ModifyInstancePlacement] #
Show ModifyInstancePlacement #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement Methods showsPrec :: Int -> ModifyInstancePlacement -> ShowS # show :: ModifyInstancePlacement -> String # showList :: [ModifyInstancePlacement] -> ShowS #
Generic ModifyInstancePlacement #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement Associated Types type Rep ModifyInstancePlacement :: Type -> Type # Methods from :: ModifyInstancePlacement -> Rep ModifyInstancePlacement x # to :: Rep ModifyInstancePlacement x -> ModifyInstancePlacement #
Hashable ModifyInstancePlacement #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement Methods hashWithSalt :: Int -> ModifyInstancePlacement -> Int # hash :: ModifyInstancePlacement -> Int #
AWSRequest ModifyInstancePlacement #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement Associated Types type Rs ModifyInstancePlacement :: Type # Methods request :: ModifyInstancePlacement -> Request ModifyInstancePlacement # response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy ModifyInstancePlacement -> ClientResponse -> m (Response ModifyInstancePlacement) #
ToHeaders ModifyInstancePlacement #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement Methods toHeaders :: ModifyInstancePlacement -> [Header] #
ToPath ModifyInstancePlacement #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement Methods toPath :: ModifyInstancePlacement -> ByteString #
ToQuery ModifyInstancePlacement #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement Methods toQuery :: ModifyInstancePlacement -> QueryString #
NFData ModifyInstancePlacement #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement Methods rnf :: ModifyInstancePlacement -> () #
type Rep ModifyInstancePlacement #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement type Rep ModifyInstancePlacement = D1 (MetaData "ModifyInstancePlacement" "Network.AWS.EC2.ModifyInstancePlacement" "amazonka-ec2-1.6.1-H98Zd65xIYr2z4e5UhW9ck" False) (C1 (MetaCons "ModifyInstancePlacement'" PrefixI True) ((S1 (MetaSel (Just "_mipAffinity") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Affinity)) :: S1 (MetaSel (Just "_mipHostId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) :: (S1 (MetaSel (Just "_mipTenancy") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe HostTenancy)) :: (S1 (MetaSel (Just "_mipGroupName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :: S1 (MetaSel (Just "_mipInstanceId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))))
type Rs ModifyInstancePlacement #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement type Rs ModifyInstancePlacement = ModifyInstancePlacementResponse

Request Lenses

mipAffinity :: Lens' ModifyInstancePlacement (Maybe Affinity) #

The affinity setting for the instance.

mipHostId :: Lens' ModifyInstancePlacement (Maybe Text) #

The ID of the Dedicated Host with which to associate the instance.

mipTenancy :: Lens' ModifyInstancePlacement (Maybe HostTenancy) #

The tenancy for the instance.

mipGroupName :: Lens' ModifyInstancePlacement (Maybe Text) #

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 #

The ID of the instance that you are modifying.

Destructuring the Response

modifyInstancePlacementResponse #

Arguments

:: Int	`miprsResponseStatus`
-> ModifyInstancePlacementResponse

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 - Is true if the request succeeds, and an error otherwise.
miprsResponseStatus - -- | The response status code.

data ModifyInstancePlacementResponse #

Contains the output of ModifyInstancePlacement.

See: modifyInstancePlacementResponse smart constructor.

Instances

Eq ModifyInstancePlacementResponse #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement Methods (==) :: ModifyInstancePlacementResponse -> ModifyInstancePlacementResponse -> Bool # (/=) :: ModifyInstancePlacementResponse -> ModifyInstancePlacementResponse -> Bool #
Data ModifyInstancePlacementResponse #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> ModifyInstancePlacementResponse -> c ModifyInstancePlacementResponse # gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c ModifyInstancePlacementResponse # toConstr :: ModifyInstancePlacementResponse -> Constr # dataTypeOf :: ModifyInstancePlacementResponse -> DataType # dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c ModifyInstancePlacementResponse) # dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c ModifyInstancePlacementResponse) # gmapT :: (forall b. Data b => b -> b) -> ModifyInstancePlacementResponse -> ModifyInstancePlacementResponse # gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> ModifyInstancePlacementResponse -> r # gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> ModifyInstancePlacementResponse -> r # gmapQ :: (forall d. Data d => d -> u) -> ModifyInstancePlacementResponse -> [u] # gmapQi :: Int -> (forall d. Data d => d -> u) -> ModifyInstancePlacementResponse -> u # gmapM :: Monad m => (forall d. Data d => d -> m d) -> ModifyInstancePlacementResponse -> m ModifyInstancePlacementResponse # gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> ModifyInstancePlacementResponse -> m ModifyInstancePlacementResponse # gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> ModifyInstancePlacementResponse -> m ModifyInstancePlacementResponse #
Read ModifyInstancePlacementResponse #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement Methods readsPrec :: Int -> ReadS ModifyInstancePlacementResponse # readList :: ReadS [ModifyInstancePlacementResponse] # readPrec :: ReadPrec ModifyInstancePlacementResponse # readListPrec :: ReadPrec [ModifyInstancePlacementResponse] #
Show ModifyInstancePlacementResponse #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement Methods showsPrec :: Int -> ModifyInstancePlacementResponse -> ShowS # show :: ModifyInstancePlacementResponse -> String # showList :: [ModifyInstancePlacementResponse] -> ShowS #
Generic ModifyInstancePlacementResponse #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement Associated Types type Rep ModifyInstancePlacementResponse :: Type -> Type # Methods from :: ModifyInstancePlacementResponse -> Rep ModifyInstancePlacementResponse x # to :: Rep ModifyInstancePlacementResponse x -> ModifyInstancePlacementResponse #
NFData ModifyInstancePlacementResponse #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement Methods rnf :: ModifyInstancePlacementResponse -> () #
type Rep ModifyInstancePlacementResponse #
Instance details Defined in Network.AWS.EC2.ModifyInstancePlacement type Rep ModifyInstancePlacementResponse = D1 (MetaData "ModifyInstancePlacementResponse" "Network.AWS.EC2.ModifyInstancePlacement" "amazonka-ec2-1.6.1-H98Zd65xIYr2z4e5UhW9ck" False) (C1 (MetaCons "ModifyInstancePlacementResponse'" PrefixI True) (S1 (MetaSel (Just "_miprsReturn") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 (MetaSel (Just "_miprsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))

Response Lenses

miprsReturn :: Lens' ModifyInstancePlacementResponse (Maybe Bool) #

Is true if the request succeeds, and an error otherwise.

miprsResponseStatus :: Lens' ModifyInstancePlacementResponse Int #

- | The response status code.