AWS::CloudTrail::Channel - AWS CloudFormation


Contains information about a returned CloudTrail channel.


To declare this entity in your AWS CloudFormation template, use the following syntax:


{ "Type" : "AWS::CloudTrail::Channel", "Properties" : { "Destinations" : [ Destination, ... ], "Name" : String, "Source" : String, "Tags" : [ Tag, ... ] } }


Type: AWS::CloudTrail::Channel Properties: Destinations: - Destination Name: String Source: String Tags: - Tag



One or more event data stores to which events arriving through a channel will be logged.

Required: No

Type: List of Destination

Maximum: 200

Update requires: No interruption


The name of the channel.

Required: No

Type: String

Minimum: 3

Maximum: 128

Pattern: ^[a-zA-Z0-9._\-]+$

Update requires: No interruption


The name of the partner or external event source. You cannot change this name after you create the channel. A maximum of one channel is allowed per source.

A source can be either Custom for all valid non-AWS events, or the name of a partner event source. For information about the source names for available partners, see Additional information about integration partners in the CloudTrail User Guide.

Required: No

Type: String

Minimum: 1

Maximum: 256

Pattern: .*

Update requires: Replacement


A list of tags.

Required: No

Type: List of Tag

Maximum: 200

Update requires: No interruption

Return values


When the logical ID of this resource is provided to the Ref intrinsic function, Ref returns the resource name.


The Fn::GetAttintrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAttintrinsic function, see Fn::GetAtt.


When you pass the logical ID of this resource to the intrinsic Reffunction, Refreturns the ARN of the CloudTrail channel, such as arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890.



The following example creates a channel for a CloudTrail Lake integration with an event source outside of AWS. For information about CloudTrail Lake integrations, see Create an integration with an event source outside of AWS in the AWS CloudTrail User Guide.


{ "Parameters": { "Name" : String, "EventDataStoreArn" : String, "Source" : String }, "Resources": { "myChannel": { "Type": "AWS::CloudTrail::Channel", "Properties": { "Name": { "Ref": "Name" }, "Source": { "Ref": "Source" }, "Destinations": [ { "Type": "EVENT_DATA_STORE", "Location": "{ "Ref": "arn:aws:cloudtrail:us-east-1:12345678910:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE" } } ], "Tags": [ { "Key": "TagKeyIntTest", "Value": "TagValueIntTest" }, { "Key": "TagKeyIntTest2", "Value": "TagValueIntTest2" } ] } } }, "Outputs": { "myChannelArn": { "Description": "The channel ARN", "Value": { "Fn::GetAtt": [ "myChannel", "arn:aws:cloudtrail:us-east-1:01234567890:channel/EXAMPLE8-0558-4f7e-a06a-43969EXAMPLE" ] } } } }


Parameters: Name: Type: String EventDataStoreArn: Type: String Source: Type: String Resources: myChannel: Type: AWS::CloudTrail::Channel Properties: Name: !Ref Name Source: !Ref Source Destinations: - Type: "EVENT_DATA_STORE" Location: !Ref arn:aws:cloudtrail:us-east-1:12345678910:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE Tags: - Key: "TagKeyIntTest" Value: "TagValueIntTest" - Key: "TagKeyIntTest2" Value: "TagValueIntTest2" Outputs: myChannelArn: Description: The channel ARN Value: 'Fn::GetAtt': - myChannel - arn:aws:cloudtrail:us-east-1:01234567890:channel/EXAMPLE8-0558-4f7e-a06a-43969EXAMPLE