/// <summary>
/// Creates or updates a <code>Destination</code>. A destination encapsulates a physical
/// resource (such as a Kinesis stream) and allows you to subscribe to a real-time stream
/// of log events of a different account, ingested through <code class="code">PutLogEvents</code>
/// requests. Currently, the only supported physical resource is a Amazon Kinesis stream
/// belonging to the same account as the destination.
///
///
/// <para>
/// A destination controls what is written to its Amazon Kinesis stream through an access
/// policy. By default, PutDestination does not set any access policy with the destination,
/// which means a cross-account user will not be able to call <code>PutSubscriptionFilter</code>
/// against this destination. To enable that, the destination owner must call <code>PutDestinationPolicy</code>
/// after PutDestination.
/// </para>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the PutDestination service method.</param>
///
/// <returns>The response from the PutDestination service method, as returned by CloudWatchLogs.</returns>
/// <exception cref="Amazon.CloudWatchLogs.Model.InvalidParameterException">
/// Returned if a parameter of the request is incorrectly specified.
/// </exception>
/// <exception cref="Amazon.CloudWatchLogs.Model.OperationAbortedException">
/// Returned if multiple requests to update the same resource were in conflict.
/// </exception>
/// <exception cref="Amazon.CloudWatchLogs.Model.ServiceUnavailableException">
/// Returned if the service cannot complete the request.
/// </exception>
public PutDestinationResponse PutDestination(PutDestinationRequest request)
{
var marshaller = new PutDestinationRequestMarshaller();
var unmarshaller = PutDestinationResponseUnmarshaller.Instance;
return Invoke<PutDestinationRequest,PutDestinationResponse>(request, marshaller, unmarshaller);
}
/// <summary>
/// Initiates the asynchronous execution of the PutDestination operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the PutDestination 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<PutDestinationResponse> PutDestinationAsync(PutDestinationRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken))
{
var marshaller = new PutDestinationRequestMarshaller();
var unmarshaller = PutDestinationResponseUnmarshaller.Instance;
return InvokeAsync<PutDestinationRequest,PutDestinationResponse>(request, marshaller,
unmarshaller, cancellationToken);
}
/// <summary>
/// Initiates the asynchronous execution of the PutDestination operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the PutDestination operation on AmazonCloudWatchLogsClient.</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 EndPutDestination
/// operation.</returns>
public IAsyncResult BeginPutDestination(PutDestinationRequest request, AsyncCallback callback, object state)
{
var marshaller = new PutDestinationRequestMarshaller();
var unmarshaller = PutDestinationResponseUnmarshaller.Instance;
return BeginInvoke<PutDestinationRequest>(request, marshaller, unmarshaller,
callback, state);
}
