subscription_filter

Gets an individual subscription_filter resource

Overview

Name	subscription_filter
Type	Resource
Description	subscription_filter
Id	awscc.logs.subscription_filter

Fields

Name	Datatype	Description
filter_name	string	The name of the filter generated by resource.
destination_arn	string	The Amazon Resource Name (ARN) of the destination.
filter_pattern	string	The filtering expressions that restrict what gets delivered to the destination AWS resource.
log_group_name	string	Existing log group that you want to associate with this filter.
role_arn	string	The ARN of an IAM role that grants CloudWatch Logs permissions to deliver ingested log events to the destination stream. You don't need to provide the ARN when you are working with a logical destination for cross-account delivery.
distribution	string	The method used to distribute log data to the destination. By default, log data is grouped by log stream, but the grouping can be set to random for a more even distribution. This property is only applicable when the destination is an Amazon Kinesis stream.
region	string	AWS region.

Methods

Currently only SELECT is supported for this resource resource.

Example

SELECT
region,
filter_name,
destination_arn,
filter_pattern,
log_group_name,
role_arn,
distribution
FROM awscc.logs.subscription_filter
WHERE data__Identifier = '<FilterName>|<LogGroupName>';

Permissions

To operate on the subscription_filter resource, the following permissions are required:

Read

logs:DescribeSubscriptionFilters

Update

iam:PassRole,
logs:PutSubscriptionFilter,
logs:DescribeSubscriptionFilters

Delete

logs:DeleteSubscriptionFilter