Network.AWS.EC2.GetPasswordData

Retrieves the encrypted administrator password for an instance running Windows.

The Windows password is generated at boot if the EC2Config service plugin, Ec2SetPassword, is enabled. This usually only happens the first time an AMI is launched, and then Ec2SetPassword is automatically disabled. The password is not generated for rebundled AMIs unless Ec2SetPassword is enabled before bundling.

The password is encrypted using the key pair that you specified when you launched the instance. You must provide the corresponding key pair file.

Password generation and encryption takes a few moments. We recommend that you wait up to 15 minutes after launching an instance before trying to retrieve the generated password.

Creating a Request

getPasswordData

Arguments

:: Text

gpdInstanceId

-> GetPasswordData

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

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

• gpdDryRun
• gpdInstanceId

data GetPasswordData

Contains the parameters for GetPasswordData.

See: getPasswordData smart constructor.

Instances

Eq GetPasswordData

Methods

(==) :: GetPasswordData -> GetPasswordData -> Bool

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

Data GetPasswordData

Methods

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

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

toConstr :: GetPasswordData -> Constr

dataTypeOf :: GetPasswordData -> DataType

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

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

gmapT :: (forall b. Data b => b -> b) -> GetPasswordData -> GetPasswordData

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

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

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

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

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

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

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

Read GetPasswordData

Methods

readsPrec :: Int -> ReadS GetPasswordData

readList :: ReadS [GetPasswordData]

readPrec :: ReadPrec GetPasswordData

readListPrec :: ReadPrec [GetPasswordData]

Show GetPasswordData

Methods

showsPrec :: Int -> GetPasswordData -> ShowS

show :: GetPasswordData -> String

showList :: [GetPasswordData] -> ShowS

Generic GetPasswordData

Associated Types

type Rep GetPasswordData :: * -> *

Methods

from :: GetPasswordData -> Rep GetPasswordData x

to :: Rep GetPasswordData x -> GetPasswordData

Hashable GetPasswordData

Methods

hashWithSalt :: Int -> GetPasswordData -> Int

hash :: GetPasswordData -> Int

NFData GetPasswordData

Methods

rnf :: GetPasswordData -> ()

AWSRequest GetPasswordData

Associated Types

type Rs GetPasswordData :: *

Methods

request :: GetPasswordData -> Request GetPasswordData

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

ToQuery GetPasswordData

Methods

toQuery :: GetPasswordData -> QueryString

ToPath GetPasswordData

Methods

toPath :: GetPasswordData -> ByteString

ToHeaders GetPasswordData

Methods

toHeaders :: GetPasswordData -> [Header]

type Rep GetPasswordData

type Rep GetPasswordData = D1 (MetaData "GetPasswordData" "Network.AWS.EC2.GetPasswordData" "amazonka-ec2-1.4.1-5DlWz6no0BoLQhxZVyzMyd" False) (C1 (MetaCons "GetPasswordData'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_gpdDryRun") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool))) (S1 (MetaSel (Just Symbol "_gpdInstanceId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text))))

type Rs GetPasswordData

type Rs GetPasswordData = GetPasswordDataResponse

Request Lenses

gpdDryRun :: Lens' GetPasswordData (Maybe Bool)

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.

gpdInstanceId :: Lens' GetPasswordData Text

The ID of the Windows instance.

Destructuring the Response

getPasswordDataResponse

Arguments

:: Int

gpdrsResponseStatus

-> Text

gpdrsInstanceId

-> Text

gpdrsPasswordData

-> UTCTime

gpdrsTimestamp

-> GetPasswordDataResponse

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

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

• gpdrsResponseStatus
• gpdrsInstanceId
• gpdrsPasswordData
• gpdrsTimestamp

data GetPasswordDataResponse

Contains the output of GetPasswordData.

See: getPasswordDataResponse smart constructor.

Instances

Eq GetPasswordDataResponse

Methods

(==) :: GetPasswordDataResponse -> GetPasswordDataResponse -> Bool

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

Data GetPasswordDataResponse

Methods

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

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

toConstr :: GetPasswordDataResponse -> Constr

dataTypeOf :: GetPasswordDataResponse -> DataType

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

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

gmapT :: (forall b. Data b => b -> b) -> GetPasswordDataResponse -> GetPasswordDataResponse

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

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

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

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

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

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

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

Read GetPasswordDataResponse

Methods

readsPrec :: Int -> ReadS GetPasswordDataResponse

readList :: ReadS [GetPasswordDataResponse]

readPrec :: ReadPrec GetPasswordDataResponse

readListPrec :: ReadPrec [GetPasswordDataResponse]

Show GetPasswordDataResponse

Methods

showsPrec :: Int -> GetPasswordDataResponse -> ShowS

show :: GetPasswordDataResponse -> String

showList :: [GetPasswordDataResponse] -> ShowS

Generic GetPasswordDataResponse

Associated Types

type Rep GetPasswordDataResponse :: * -> *

Methods

from :: GetPasswordDataResponse -> Rep GetPasswordDataResponse x

to :: Rep GetPasswordDataResponse x -> GetPasswordDataResponse

NFData GetPasswordDataResponse

Methods

rnf :: GetPasswordDataResponse -> ()

type Rep GetPasswordDataResponse

type Rep GetPasswordDataResponse = D1 (MetaData "GetPasswordDataResponse" "Network.AWS.EC2.GetPasswordData" "amazonka-ec2-1.4.1-5DlWz6no0BoLQhxZVyzMyd" False) (C1 (MetaCons "GetPasswordDataResponse'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_gpdrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)) (S1 (MetaSel (Just Symbol "_gpdrsInstanceId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text))) ((:*:) (S1 (MetaSel (Just Symbol "_gpdrsPasswordData") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)) (S1 (MetaSel (Just Symbol "_gpdrsTimestamp") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 ISO8601)))))

Response Lenses

gpdrsResponseStatus :: Lens' GetPasswordDataResponse Int

The response status code.

gpdrsInstanceId :: Lens' GetPasswordDataResponse Text

The ID of the Windows instance.

gpdrsPasswordData :: Lens' GetPasswordDataResponse Text

The password of the instance.

gpdrsTimestamp :: Lens' GetPasswordDataResponse UTCTime

The time the data was last updated.