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.

Creates or updates a subscription filter and associates it with the specified log group. Subscription filters allow you to subscribe to a real-time stream of log events ingested through PutLogEvents and have them delivered to a specific destination. When log events are sent to the receiving service, they are Base64 encoded and compressed with the gzip format.

The following destinations are supported for subscription filters:

There can only be one subscription filter associated with a log group. If you are updating an existing filter, you must specify the correct name in filterName. Otherwise, the call fails because you cannot associate a second filter with a log group.

To perform a PutSubscriptionFilter operation, you must also have the iam:PassRole permission.


For .NET Core this operation is only available in asynchronous form. Please refer to PutSubscriptionFilterAsync.

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


public virtual PutSubscriptionFilterResponse PutSubscriptionFilter(
         PutSubscriptionFilterRequest request
Type: Amazon.CloudWatchLogs.Model.PutSubscriptionFilterRequest

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

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


InvalidParameterException A parameter is specified incorrectly.
LimitExceededException You have reached the maximum number of resources that can be created.
OperationAbortedException Multiple requests to update the same resource were in conflict.
ResourceNotFoundException The specified resource does not exist.
ServiceUnavailableException The service cannot complete the request.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

See Also