IoTDataPlane / Client / get_retained_message



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.

See also: AWS API Documentation

Request Syntax

response = client.get_retained_message(

topic (string) –


The topic name of the retained message to retrieve.

Return type:



Response Syntax

    'topic': 'string',
    'payload': b'bytes',
    'qos': 123,
    'lastModifiedTime': 123,
    'userProperties': b'bytes'

Response Structure

  • (dict) –

    The output from the GetRetainedMessage operation.

    • topic (string) –

      The topic name to which the retained message was published.

    • payload (bytes) –

      The Base64-encoded message payload of the retained message body.

    • qos (integer) –

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

    • lastModifiedTime (integer) –

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

    • userProperties (bytes) –

      A base64-encoded JSON string that includes an array of JSON objects, or null if the retained message doesn’t include any user properties.

      The following example userProperties parameter is a JSON string that represents two user properties. Note that it will be base64-encoded:

      [{"deviceName": "alpha"}, {"deviceCnt": "45"}]