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

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

Network.AWS.EC2.GetConsoleOutput

Contents

Description

Gets the console output for the specified instance. For Linux instances, the instance console output displays the exact console output that would normally be displayed on a physical monitor attached to a computer. For Windows instances, the instance console output includes output from the EC2Config service.

GetConsoleOutput returns up to 64 KB of console output shortly after it's generated by the instance.

By default, the console output returns buffered information that was posted shortly after an instance transition state (start, stop, reboot, or terminate). This information is available for at least one hour after the most recent post.

You can optionally retrieve the latest serial console output at any time during the instance lifecycle. This option is only supported on C5, M5, and i3.metal instances.

Synopsis

Creating a Request

getConsoleOutput Source #

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

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

  • gcoLatest - When enabled, retrieves the latest console output for the instance. Default: disabled (false )
  • gcoDryRun - Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation . Otherwise, it is UnauthorizedOperation .
  • gcoInstanceId - The ID of the instance.

data GetConsoleOutput Source #

Contains the parameters for GetConsoleOutput.

See: getConsoleOutput smart constructor.

Instances

Eq GetConsoleOutput Source # 
Data GetConsoleOutput Source # 

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> GetConsoleOutput -> c GetConsoleOutput #

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c GetConsoleOutput #

toConstr :: GetConsoleOutput -> Constr #

dataTypeOf :: GetConsoleOutput -> DataType #

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c GetConsoleOutput) #

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c GetConsoleOutput) #

gmapT :: (forall b. Data b => b -> b) -> GetConsoleOutput -> GetConsoleOutput #

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> GetConsoleOutput -> r #

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> GetConsoleOutput -> r #

gmapQ :: (forall d. Data d => d -> u) -> GetConsoleOutput -> [u] #

gmapQi :: Int -> (forall d. Data d => d -> u) -> GetConsoleOutput -> u #

gmapM :: Monad m => (forall d. Data d => d -> m d) -> GetConsoleOutput -> m GetConsoleOutput #

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> GetConsoleOutput -> m GetConsoleOutput #

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> GetConsoleOutput -> m GetConsoleOutput #

Read GetConsoleOutput Source # 
Show GetConsoleOutput Source # 
Generic GetConsoleOutput Source # 
Hashable GetConsoleOutput Source # 
NFData GetConsoleOutput Source # 

Methods

rnf :: GetConsoleOutput -> () #

AWSRequest GetConsoleOutput Source # 
ToHeaders GetConsoleOutput Source # 
ToPath GetConsoleOutput Source # 
ToQuery GetConsoleOutput Source # 
type Rep GetConsoleOutput Source # 
type Rep GetConsoleOutput = D1 * (MetaData "GetConsoleOutput" "Network.AWS.EC2.GetConsoleOutput" "amazonka-ec2-1.6.0-Kkew7Kpgof6EYi20Z0WOzs" False) (C1 * (MetaCons "GetConsoleOutput'" PrefixI True) ((:*:) * (S1 * (MetaSel (Just Symbol "_gcoLatest") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Bool))) ((:*:) * (S1 * (MetaSel (Just Symbol "_gcoDryRun") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Bool))) (S1 * (MetaSel (Just Symbol "_gcoInstanceId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text)))))
type Rs GetConsoleOutput Source # 

Request Lenses

gcoLatest :: Lens' GetConsoleOutput (Maybe Bool) Source #

When enabled, retrieves the latest console output for the instance. Default: disabled (false )

gcoDryRun :: Lens' GetConsoleOutput (Maybe Bool) Source #

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation . Otherwise, it is UnauthorizedOperation .

gcoInstanceId :: Lens' GetConsoleOutput Text Source #

The ID of the instance.

Destructuring the Response

getConsoleOutputResponse Source #

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

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

data GetConsoleOutputResponse Source #

Contains the output of GetConsoleOutput.

See: getConsoleOutputResponse smart constructor.

Instances

Eq GetConsoleOutputResponse Source # 
Data GetConsoleOutputResponse Source # 

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> GetConsoleOutputResponse -> c GetConsoleOutputResponse #

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c GetConsoleOutputResponse #

toConstr :: GetConsoleOutputResponse -> Constr #

dataTypeOf :: GetConsoleOutputResponse -> DataType #

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c GetConsoleOutputResponse) #

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c GetConsoleOutputResponse) #

gmapT :: (forall b. Data b => b -> b) -> GetConsoleOutputResponse -> GetConsoleOutputResponse #

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> GetConsoleOutputResponse -> r #

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> GetConsoleOutputResponse -> r #

gmapQ :: (forall d. Data d => d -> u) -> GetConsoleOutputResponse -> [u] #

gmapQi :: Int -> (forall d. Data d => d -> u) -> GetConsoleOutputResponse -> u #

gmapM :: Monad m => (forall d. Data d => d -> m d) -> GetConsoleOutputResponse -> m GetConsoleOutputResponse #

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> GetConsoleOutputResponse -> m GetConsoleOutputResponse #

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> GetConsoleOutputResponse -> m GetConsoleOutputResponse #

Read GetConsoleOutputResponse Source # 
Show GetConsoleOutputResponse Source # 
Generic GetConsoleOutputResponse Source # 
NFData GetConsoleOutputResponse Source # 
type Rep GetConsoleOutputResponse Source # 
type Rep GetConsoleOutputResponse = D1 * (MetaData "GetConsoleOutputResponse" "Network.AWS.EC2.GetConsoleOutput" "amazonka-ec2-1.6.0-Kkew7Kpgof6EYi20Z0WOzs" False) (C1 * (MetaCons "GetConsoleOutputResponse'" PrefixI True) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_gcorsInstanceId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_gcorsOutput") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text)))) ((:*:) * (S1 * (MetaSel (Just Symbol "_gcorsTimestamp") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe ISO8601))) (S1 * (MetaSel (Just Symbol "_gcorsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Int)))))

Response Lenses

gcorsOutput :: Lens' GetConsoleOutputResponse (Maybe Text) Source #

The console output, base64-encoded. If you are using a command line tool, the tool decodes the output for you.

gcorsTimestamp :: Lens' GetConsoleOutputResponse (Maybe UTCTime) Source #

The time at which the output was last updated.