AWS Fundamentals Logo
AWS Fundamentals
L1 ConstructAWS::Logs::Destination

CfnDestination

The AWS::Logs::Destination resource specifies a CloudWatch Logs destination. A destination encapsulates a physical resource (such as an Amazon Kinesis data stream) and enables you to subscribe that resource to a stream of log events.

Import

import { CfnDestination } from 'aws-cdk-lib/aws-logs';

Or use the module namespace:

import * as logs from 'aws-cdk-lib/aws-logs';
// logs.CfnDestination

Properties

Configuration passed to the constructor as CfnDestinationProps.

destinationNameRequired
string

The name of the destination.

roleArnRequired
string | IRoleRef

The ARN of an IAM role that permits CloudWatch Logs to send data to the specified AWS resource.

targetArnRequired
string | IStreamRef | IDeliveryStreamRef | IFunctionRef

The Amazon Resource Name (ARN) of the physical target where the log events are delivered (for example, a Kinesis stream).

destinationPolicyOptional
string

An IAM policy document that governs which AWS accounts can create subscription filters against this destination.

tagsOptional
CfnTag[]

The tags that have been assigned to this delivery destination.

CloudFormation Resource

This L1 construct maps directly to the following CloudFormation resource type.

Learn AWS the Practical Way

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

Subscribe to Newsletter