/// <summary>
/// Lists summary information about the retained messages stored for the account.
///
///
/// <para>
/// This action returns only the topic names of the retained messages. It doesn't return
/// any message payloads. Although this action doesn't return a message payload, it can
/// still incur messaging costs.
/// </para>
///
/// <para>
/// To get the message payload of a retained message, call <a href="https://docs.aws.amazon.com/iot/latest/developerguide/API_iotdata_GetRetainedMessage.html">GetRetainedMessage</a>
/// with the topic name of the retained message.
/// </para>
///
/// <para>
/// Requires permission to access the <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotfleethubfordevicemanagement.html#awsiotfleethubfordevicemanagement-actions-as-permissions">ListRetainedMessages</a>
/// action.
/// </para>
///
/// <para>
/// For more information about messaging costs, see <a href="http://aws.amazon.com/iot-core/pricing/#Messaging">Amazon
/// Web Services IoT Core pricing - Messaging</a>.
/// </para>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the ListRetainedMessages service method.</param>
///
/// <returns>The response from the ListRetainedMessages service method, as returned by IotData.</returns>
/// <exception cref="Amazon.IotData.Model.InternalFailureException">
/// An unexpected error has occurred.
/// </exception>
/// <exception cref="Amazon.IotData.Model.InvalidRequestException">
/// The request is not valid.
/// </exception>
/// <exception cref="Amazon.IotData.Model.MethodNotAllowedException">
/// The specified combination of HTTP verb and URI is not supported.
/// </exception>
/// <exception cref="Amazon.IotData.Model.ServiceUnavailableException">
/// The service is temporarily unavailable.
/// </exception>
/// <exception cref="Amazon.IotData.Model.ThrottlingException">
/// The rate exceeds the limit.
/// </exception>
/// <exception cref="Amazon.IotData.Model.UnauthorizedException">
/// You are not authorized to perform this operation.
/// </exception>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/iot-data-2015-05-28/ListRetainedMessages">REST API Reference for ListRetainedMessages Operation</seealso>
public virtual ListRetainedMessagesResponse ListRetainedMessages(ListRetainedMessagesRequest request)
{
var options = new InvokeOptions();
options.RequestMarshaller = ListRetainedMessagesRequestMarshaller.Instance;
options.ResponseUnmarshaller = ListRetainedMessagesResponseUnmarshaller.Instance;
return(Invoke <ListRetainedMessagesResponse>(request, options));
}
/// <summary>
/// Initiates the asynchronous execution of the ListRetainedMessages operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the ListRetainedMessages operation on AmazonIotDataClient.</param>
/// <param name="callback">An AsyncCallback delegate that is invoked when the operation completes.</param>
/// <param name="state">A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.</param>
///
/// <returns>An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndListRetainedMessages
/// operation.</returns>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/iot-data-2015-05-28/ListRetainedMessages">REST API Reference for ListRetainedMessages Operation</seealso>
public virtual IAsyncResult BeginListRetainedMessages(ListRetainedMessagesRequest request, AsyncCallback callback, object state)
{
var options = new InvokeOptions();
options.RequestMarshaller = ListRetainedMessagesRequestMarshaller.Instance;
options.ResponseUnmarshaller = ListRetainedMessagesResponseUnmarshaller.Instance;
return(BeginInvoke(request, options, callback, state));
}
/// <summary>
/// Lists summary information about the retained messages stored for the account.
///
///
/// <para>
/// This action returns only the topic names of the retained messages. It doesn't return
/// any message payloads. Although this action doesn't return a message payload, it can
/// still incur messaging costs.
/// </para>
///
/// <para>
/// To get the message payload of a retained message, call <a href="https://docs.aws.amazon.com/iot/latest/developerguide/API_iotdata_GetRetainedMessage.html">GetRetainedMessage</a>
/// with the topic name of the retained message.
/// </para>
///
/// <para>
/// Requires permission to access the <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotfleethubfordevicemanagement.html#awsiotfleethubfordevicemanagement-actions-as-permissions">ListRetainedMessages</a>
/// action.
/// </para>
///
/// <para>
/// For more information about messaging costs, see <a href="http://aws.amazon.com/iot-core/pricing/#Messaging">IoT
/// Core pricing - Messaging</a>.
/// </para>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the ListRetainedMessages service method.</param>
/// <param name="cancellationToken">
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
/// </param>
///
/// <returns>The response from the ListRetainedMessages service method, as returned by IotData.</returns>
/// <exception cref="Amazon.IotData.Model.InternalFailureException">
/// An unexpected error has occurred.
/// </exception>
/// <exception cref="Amazon.IotData.Model.InvalidRequestException">
/// The request is not valid.
/// </exception>
/// <exception cref="Amazon.IotData.Model.MethodNotAllowedException">
/// The specified combination of HTTP verb and URI is not supported.
/// </exception>
/// <exception cref="Amazon.IotData.Model.ServiceUnavailableException">
/// The service is temporarily unavailable.
/// </exception>
/// <exception cref="Amazon.IotData.Model.ThrottlingException">
/// The rate exceeds the limit.
/// </exception>
/// <exception cref="Amazon.IotData.Model.UnauthorizedException">
/// You are not authorized to perform this operation.
/// </exception>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/iot-data-2015-05-28/ListRetainedMessages">REST API Reference for ListRetainedMessages Operation</seealso>
public virtual Task <ListRetainedMessagesResponse> ListRetainedMessagesAsync(ListRetainedMessagesRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken))
{
var options = new InvokeOptions();
options.RequestMarshaller = ListRetainedMessagesRequestMarshaller.Instance;
options.ResponseUnmarshaller = ListRetainedMessagesResponseUnmarshaller.Instance;
return(InvokeAsync <ListRetainedMessagesResponse>(request, options, cancellationToken));
}
