AWS::Logs::SubscriptionFilter

Logs SubscriptionFilter

The AWS::Logs::SubscriptionFilter resource specifies 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 and have them delivered to a specific destination. Currently, the supported destinations are: + An Amazon Kinesis data 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-ac...

Properties

9 configurable properties. 3 required. Click a row to see details.

Filter:

Property	Type	Flags
`DestinationArn`	`string`	Required
`FilterPattern`	`string`	Required
`LogGroupName`	`string`	RequiredCreate-only
`ApplyOnTransformedLogs`	`boolean`
`Distribution`	`string`
`EmitSystemFields`	`Array<string>`
`FieldSelectionCriteria`	`string`
`FilterName`	`string`	Create-only
`RoleArn`	`string`

Sample CloudFormation Template

A minimal template with required properties and common optional ones.

template.yaml

AWSTemplateFormatVersion: "2010-09-09"
Description: Sample template for AWS::Logs::SubscriptionFilter

Resources:
  MyResource:
    Type: AWS::Logs::SubscriptionFilter
    Properties:
      DestinationArn: "arn:aws:service:region:account:resource"
      FilterPattern: "value"
      LogGroupName: "my-loggroupname"

Required IAM Permissions

Permissions CloudFormation needs in your IAM role to manage this resource.

create

iam:PassRolelogs:PutSubscriptionFilterlogs:DescribeSubscriptionFilters

read

logs:DescribeSubscriptionFilters

update

iam:PassRolelogs:PutSubscriptionFilterlogs:DescribeSubscriptionFilters

delete

logs:DeleteSubscriptionFilter

list

logs:DescribeSubscriptionFilters

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter

Quick Facts

ServiceLogs

Properties9

Required3

TaggingNot supported

Primary IDFilterName

Supported Operations

CreateReadUpdateDeleteList

Immutable After Creation

These properties cannot be changed after the resource is created. Updating them triggers a replacement.

FilterNameLogGroupName

Related Resources

External Links

AWS Documentation