IoTDataPlane / Client / get_retained_message

get_retained_message#

IoTDataPlane.Client.get_retained_message(**kwargs)#

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.

Request Syntax

response = client.get_retained_message(
    topic='string'
)

Parameters:

topic (string) –

[REQUIRED]

The topic name of the retained message to retrieve.

Return type:

dict

Returns:

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"}]

Exceptions

IoTDataPlane.Client.exceptions.InvalidRequestException
IoTDataPlane.Client.exceptions.ResourceNotFoundException
IoTDataPlane.Client.exceptions.ThrottlingException
IoTDataPlane.Client.exceptions.UnauthorizedException
IoTDataPlane.Client.exceptions.ServiceUnavailableException
IoTDataPlane.Client.exceptions.InternalFailureException
IoTDataPlane.Client.exceptions.MethodNotAllowedException