AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Uploads a batch of log events to the specified log stream.

You must include the sequence token obtained from the response of the previous call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token in the expectedSequenceToken field from InvalidSequenceTokenException. If you call PutLogEvents twice within a narrow time period using the same value for sequenceToken, both calls might be successful or one might be rejected.

The batch of events must satisfy the following constraints:

If a call to PutLogEvents returns "UnrecognizedClientException" the most likely cause is an invalid AWS access key ID or secret key.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginPutLogEvents and EndPutLogEvents.

Namespace: Amazon.CloudWatchLogs
Assembly: AWSSDK.CloudWatchLogs.dll
Version: 3.x.y.z

Syntax

C#
public virtual Task<PutLogEventsResponse> PutLogEventsAsync(
         PutLogEventsRequest request,
         CancellationToken cancellationToken
)
Parameters
request
Type: Amazon.CloudWatchLogs.Model.PutLogEventsRequest

Container for the necessary parameters to execute the PutLogEvents service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value
The response from the PutLogEvents service method, as returned by CloudWatchLogs.

Exceptions

ExceptionCondition
DataAlreadyAcceptedException The event was already logged.
InvalidParameterException A parameter is specified incorrectly.
InvalidSequenceTokenException The sequence token is not valid. You can get the correct sequence token in the expectedSequenceToken field in the InvalidSequenceTokenException message.
ResourceNotFoundException The specified resource does not exist.
ServiceUnavailableException The service cannot complete the request.
UnrecognizedClientException The most likely cause is an invalid AWS access key ID or secret key.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0, 1.3

.NET Framework:
Supported in: 4.5

See Also