/// <summary>
/// Publishes state information.
///
///
/// <para>
/// For more information, see <a href="http://docs.aws.amazon.com/iot/latest/developerguide/protocols.html#http">HTTP
/// Protocol</a> in the <i>AWS IoT Developer Guide</i>.
/// </para>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the Publish service method.</param>
///
/// <returns>The response from the Publish 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.UnauthorizedException">
/// You are not authorized to perform this operation.
/// </exception>
public PublishResponse Publish(PublishRequest request)
{
var marshaller = new PublishRequestMarshaller();
var unmarshaller = PublishResponseUnmarshaller.Instance;
return Invoke<PublishRequest,PublishResponse>(request, marshaller, unmarshaller);
}
/// <summary>
/// Initiates the asynchronous execution of the Publish operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the Publish operation.</param>
/// <param name="cancellationToken">
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
/// </param>
/// <returns>The task object representing the asynchronous operation.</returns>
public Task<PublishResponse> PublishAsync(PublishRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken))
{
var marshaller = new PublishRequestMarshaller();
var unmarshaller = PublishResponseUnmarshaller.Instance;
return InvokeAsync<PublishRequest,PublishResponse>(request, marshaller,
unmarshaller, cancellationToken);
}
/// <summary>
/// Initiates the asynchronous execution of the Publish operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the Publish 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 EndPublish
/// operation.</returns>
public IAsyncResult BeginPublish(PublishRequest request, AsyncCallback callback, object state)
{
var marshaller = new PublishRequestMarshaller();
var unmarshaller = PublishResponseUnmarshaller.Instance;
return BeginInvoke<PublishRequest>(request, marshaller, unmarshaller,
callback, state);
}
