Copyright	(c) 2013-2023 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	Safe-Inferred
Language	Haskell2010

Amazonka.IoTData.GetRetainedMessage

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Gets the details of a single retained message for the specified topic.

This action returns the message payload of the retained message, which can incur messaging costs. To list only the topic names of the retained messages, call ListRetainedMessages.

Requires permission to access the GetRetainedMessage action.

For more information about messaging costs, see Amazon Web Services IoT Core pricing - Messaging.

Synopsis

Creating a Request

data GetRetainedMessage Source #

The input for the GetRetainedMessage operation.

See: newGetRetainedMessage smart constructor.

Constructors

GetRetainedMessage'
Fields topic :: Text The topic name of the retained message to retrieve.

Instances

Instances details

ToHeaders GetRetainedMessage Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage Methods toHeaders :: GetRetainedMessage -> [Header] #
ToPath GetRetainedMessage Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage Methods toPath :: GetRetainedMessage -> ByteString #
ToQuery GetRetainedMessage Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage Methods toQuery :: GetRetainedMessage -> QueryString #
AWSRequest GetRetainedMessage Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage Associated Types type AWSResponse GetRetainedMessage # Methods request :: (Service -> Service) -> GetRetainedMessage -> Request GetRetainedMessage # response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy GetRetainedMessage -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse GetRetainedMessage))) #
Generic GetRetainedMessage Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage Associated Types type Rep GetRetainedMessage :: Type -> Type # Methods from :: GetRetainedMessage -> Rep GetRetainedMessage x # to :: Rep GetRetainedMessage x -> GetRetainedMessage #
Read GetRetainedMessage Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage Methods readsPrec :: Int -> ReadS GetRetainedMessage # readList :: ReadS [GetRetainedMessage] # readPrec :: ReadPrec GetRetainedMessage # readListPrec :: ReadPrec [GetRetainedMessage] #
Show GetRetainedMessage Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage Methods showsPrec :: Int -> GetRetainedMessage -> ShowS # show :: GetRetainedMessage -> String # showList :: [GetRetainedMessage] -> ShowS #
NFData GetRetainedMessage Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage Methods rnf :: GetRetainedMessage -> () #
Eq GetRetainedMessage Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage Methods (==) :: GetRetainedMessage -> GetRetainedMessage -> Bool # (/=) :: GetRetainedMessage -> GetRetainedMessage -> Bool #
Hashable GetRetainedMessage Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage Methods hashWithSalt :: Int -> GetRetainedMessage -> Int # hash :: GetRetainedMessage -> Int #
type AWSResponse GetRetainedMessage Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage type AWSResponse GetRetainedMessage = GetRetainedMessageResponse
type Rep GetRetainedMessage Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage type Rep GetRetainedMessage = D1 ('MetaData "GetRetainedMessage" "Amazonka.IoTData.GetRetainedMessage" "amazonka-iot-dataplane-2.0-Fdc9p3E1INX2O9pOv9RFV7" 'False) (C1 ('MetaCons "GetRetainedMessage'" 'PrefixI 'True) (S1 ('MetaSel ('Just "topic") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))

newGetRetainedMessage Source #

Arguments

:: Text	`GetRetainedMessage`
-> GetRetainedMessage

Create a value of GetRetainedMessage with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

GetRetainedMessage, getRetainedMessage_topic - The topic name of the retained message to retrieve.

Request Lenses

getRetainedMessage_topic :: Lens' GetRetainedMessage Text Source #

The topic name of the retained message to retrieve.

Destructuring the Response

data GetRetainedMessageResponse Source #

The output from the GetRetainedMessage operation.

See: newGetRetainedMessageResponse smart constructor.

Constructors

GetRetainedMessageResponse'

Fields

lastModifiedTime :: Maybe Integer
The Epoch date and time, in milliseconds, when the retained message was stored by IoT.
payload :: Maybe Base64
The Base64-encoded message payload of the retained message body.
qos :: Maybe Natural
The quality of service (QoS) level used to publish the retained message.
topic :: Maybe Text
The topic name to which the retained message was published.
httpStatus :: Int
The response's http status code.

Instances

Instances details

Generic GetRetainedMessageResponse Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage Associated Types type Rep GetRetainedMessageResponse :: Type -> Type # Methods from :: GetRetainedMessageResponse -> Rep GetRetainedMessageResponse x # to :: Rep GetRetainedMessageResponse x -> GetRetainedMessageResponse #
Read GetRetainedMessageResponse Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage Methods readsPrec :: Int -> ReadS GetRetainedMessageResponse # readList :: ReadS [GetRetainedMessageResponse] # readPrec :: ReadPrec GetRetainedMessageResponse # readListPrec :: ReadPrec [GetRetainedMessageResponse] #
Show GetRetainedMessageResponse Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage Methods showsPrec :: Int -> GetRetainedMessageResponse -> ShowS # show :: GetRetainedMessageResponse -> String # showList :: [GetRetainedMessageResponse] -> ShowS #
NFData GetRetainedMessageResponse Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage Methods rnf :: GetRetainedMessageResponse -> () #
Eq GetRetainedMessageResponse Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage Methods (==) :: GetRetainedMessageResponse -> GetRetainedMessageResponse -> Bool # (/=) :: GetRetainedMessageResponse -> GetRetainedMessageResponse -> Bool #
type Rep GetRetainedMessageResponse Source #
Instance details Defined in Amazonka.IoTData.GetRetainedMessage type Rep GetRetainedMessageResponse = D1 ('MetaData "GetRetainedMessageResponse" "Amazonka.IoTData.GetRetainedMessage" "amazonka-iot-dataplane-2.0-Fdc9p3E1INX2O9pOv9RFV7" 'False) (C1 ('MetaCons "GetRetainedMessageResponse'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "lastModifiedTime") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Integer)) :: S1 ('MetaSel ('Just "payload") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Base64))) :: (S1 ('MetaSel ('Just "qos") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :: (S1 ('MetaSel ('Just "topic") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))))

newGetRetainedMessageResponse Source #

Arguments

:: Int	`$sel:httpStatus:GetRetainedMessageResponse'`
-> GetRetainedMessageResponse

Create a value of GetRetainedMessageResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

GetRetainedMessageResponse, getRetainedMessageResponse_lastModifiedTime - The Epoch date and time, in milliseconds, when the retained message was stored by IoT.

$sel:payload:GetRetainedMessageResponse', getRetainedMessageResponse_payload - The Base64-encoded message payload of the retained message body.-- -- Note: This Lens automatically encodes and decodes Base64 data. -- The underlying isomorphism will encode to Base64 representation during -- serialisation, and decode from Base64 representation during deserialisation. -- This Lens accepts and returns only raw unencoded data.

GetRetainedMessageResponse, getRetainedMessageResponse_qos - The quality of service (QoS) level used to publish the retained message.

GetRetainedMessage, getRetainedMessageResponse_topic - The topic name to which the retained message was published.

$sel:httpStatus:GetRetainedMessageResponse', getRetainedMessageResponse_httpStatus - The response's http status code.

Response Lenses

getRetainedMessageResponse_lastModifiedTime :: Lens' GetRetainedMessageResponse (Maybe Integer) Source #

The Epoch date and time, in milliseconds, when the retained message was stored by IoT.

getRetainedMessageResponse_payload :: Lens' GetRetainedMessageResponse (Maybe ByteString) Source #

The Base64-encoded message payload of the retained message body.-- -- Note: This Lens automatically encodes and decodes Base64 data. -- The underlying isomorphism will encode to Base64 representation during -- serialisation, and decode from Base64 representation during deserialisation. -- This Lens accepts and returns only raw unencoded data.

getRetainedMessageResponse_qos :: Lens' GetRetainedMessageResponse (Maybe Natural) Source #

The quality of service (QoS) level used to publish the retained message.

getRetainedMessageResponse_topic :: Lens' GetRetainedMessageResponse (Maybe Text) Source #

The topic name to which the retained message was published.

getRetainedMessageResponse_httpStatus :: Lens' GetRetainedMessageResponse Int Source #

The response's http status code.