Network.AWS.EC2.ModifyInstancePlacement

Set the instance affinity value for a specific stopped instance and modify the instance tenancy setting.

Instance affinity is disabled by default. When instance affinity is host and it is not associated with a specific Dedicated Host, the next time it is launched it will automatically be associated with the host it lands on. This relationship will persist if the instance is stopped/started, or rebooted.

You can modify the host ID associated with a stopped instance. If a stopped instance has a new host ID association, the instance will target that host when restarted.

You can modify the tenancy of a stopped instance with a tenancy of host or dedicated .

Affinity, hostID, and tenancy are not required parameters, but at least one of them must be specified in the request. Affinity and tenancy can be modified in the same request, but tenancy can only be modified on instances that are stopped.

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 new affinity setting for the instance.
• mipHostId - The ID of the Dedicated Host that the instance will have affinity with.
• mipTenancy - The tenancy of the instance that you are modifying.
• mipInstanceId - The ID of the instance that you are modifying.

data ModifyInstancePlacement

Contains the parameters for ModifyInstancePlacement.

See: modifyInstancePlacement smart constructor.

Instances

Eq ModifyInstancePlacement

Methods

(==) :: ModifyInstancePlacement -> ModifyInstancePlacement -> Bool

(/=) :: ModifyInstancePlacement -> ModifyInstancePlacement -> Bool

Data 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

Methods

readsPrec :: Int -> ReadS ModifyInstancePlacement

readList :: ReadS [ModifyInstancePlacement]

readPrec :: ReadPrec ModifyInstancePlacement

readListPrec :: ReadPrec [ModifyInstancePlacement]

Show ModifyInstancePlacement

Methods

showsPrec :: Int -> ModifyInstancePlacement -> ShowS

show :: ModifyInstancePlacement -> String

showList :: [ModifyInstancePlacement] -> ShowS

Generic ModifyInstancePlacement

Associated Types

type Rep ModifyInstancePlacement :: * -> *

Methods

from :: ModifyInstancePlacement -> Rep ModifyInstancePlacement x

to :: Rep ModifyInstancePlacement x -> ModifyInstancePlacement

Hashable ModifyInstancePlacement

Methods

hashWithSalt :: Int -> ModifyInstancePlacement -> Int

hash :: ModifyInstancePlacement -> Int

NFData ModifyInstancePlacement

Methods

rnf :: ModifyInstancePlacement -> ()

AWSRequest ModifyInstancePlacement

Associated Types

type Rs ModifyInstancePlacement :: *

Methods

request :: ModifyInstancePlacement -> Request ModifyInstancePlacement

response :: MonadResource m => Logger -> Service -> Proxy * ModifyInstancePlacement -> ClientResponse -> m (Response ModifyInstancePlacement)

ToPath ModifyInstancePlacement

Methods

toPath :: ModifyInstancePlacement -> ByteString

ToHeaders ModifyInstancePlacement

Methods

toHeaders :: ModifyInstancePlacement -> [Header]

ToQuery ModifyInstancePlacement

Methods

toQuery :: ModifyInstancePlacement -> QueryString

type Rep ModifyInstancePlacement

type Rep ModifyInstancePlacement = D1 (MetaData "ModifyInstancePlacement" "Network.AWS.EC2.ModifyInstancePlacement" "amazonka-ec2-1.4.5-4J1X1aohvSR7xjHvMmTrf6" False) (C1 (MetaCons "ModifyInstancePlacement'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_mipAffinity") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Affinity))) (S1 (MetaSel (Just Symbol "_mipHostId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))) ((:*:) (S1 (MetaSel (Just Symbol "_mipTenancy") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe HostTenancy))) (S1 (MetaSel (Just Symbol "_mipInstanceId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))))

type Rs ModifyInstancePlacement

type Rs ModifyInstancePlacement = ModifyInstancePlacementResponse

Request Lenses

mipAffinity :: Lens' ModifyInstancePlacement (Maybe Affinity)

The new affinity setting for the instance.

mipHostId :: Lens' ModifyInstancePlacement (Maybe Text)

The ID of the Dedicated Host that the instance will have affinity with.

mipTenancy :: Lens' ModifyInstancePlacement (Maybe HostTenancy)

The tenancy of the instance that you are modifying.

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

Methods

(==) :: ModifyInstancePlacementResponse -> ModifyInstancePlacementResponse -> Bool

(/=) :: ModifyInstancePlacementResponse -> ModifyInstancePlacementResponse -> Bool

Data ModifyInstancePlacementResponse

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

Methods

readsPrec :: Int -> ReadS ModifyInstancePlacementResponse

readList :: ReadS [ModifyInstancePlacementResponse]

readPrec :: ReadPrec ModifyInstancePlacementResponse

readListPrec :: ReadPrec [ModifyInstancePlacementResponse]

Show ModifyInstancePlacementResponse

Methods

showsPrec :: Int -> ModifyInstancePlacementResponse -> ShowS

show :: ModifyInstancePlacementResponse -> String

showList :: [ModifyInstancePlacementResponse] -> ShowS

Generic ModifyInstancePlacementResponse

Associated Types

type Rep ModifyInstancePlacementResponse :: * -> *

Methods

from :: ModifyInstancePlacementResponse -> Rep ModifyInstancePlacementResponse x

to :: Rep ModifyInstancePlacementResponse x -> ModifyInstancePlacementResponse

NFData ModifyInstancePlacementResponse

Methods

rnf :: ModifyInstancePlacementResponse -> ()

type Rep ModifyInstancePlacementResponse

type Rep ModifyInstancePlacementResponse = D1 (MetaData "ModifyInstancePlacementResponse" "Network.AWS.EC2.ModifyInstancePlacement" "amazonka-ec2-1.4.5-4J1X1aohvSR7xjHvMmTrf6" False) (C1 (MetaCons "ModifyInstancePlacementResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_miprsReturn") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool))) (S1 (MetaSel (Just Symbol "_miprsResponseStatus") NoSourceUnpackedness SourceStrict DecidedUnpack) (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.