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:
An Amazon Kinesis stream belonging to the same account as the subscription filter, for same-account delivery.
A logical destination that belongs to a different account, for cross-account delivery.
An Amazon Kinesis Firehose delivery stream that belongs to the same account as the subscription filter, for same-account delivery.
An AWS Lambda function that belongs to the same account as the subscription filter, for same-account delivery.
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 )
Container for the necessary parameters to execute the PutSubscriptionFilter service method.
Exception | Condition |
---|---|
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. |
.NET Framework:
Supported in: 4.5, 4.0, 3.5