CloudTrail / Client / create_channel

create_channel¶

CloudTrail.Client.create_channel(**kwargs)¶

Warning

CloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see CloudTrail Lake availability change.

Creates a channel for CloudTrail to ingest events from a partner or external source. After you create a channel, a CloudTrail Lake event data store can log events from the partner or source that you specify.

Request Syntax

response = client.create_channel(
    Name='string',
    Source='string',
    Destinations=[
        {
            'Type': 'EVENT_DATA_STORE'|'AWS_SERVICE',
            'Location': 'string'
        },
    ],
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)

Parameters:

Name (string) –
[REQUIRED]

The name of the channel.
Source (string) –
[REQUIRED]

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-Amazon Web Services 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.
Destinations (list) –
[REQUIRED]

One or more event data stores to which events arriving through a channel will be logged.
- (dict) –
  
  Contains information about the destination receiving events.
  - Type (string) – [REQUIRED]
    
    The type of destination for events arriving from a channel. For channels used for a CloudTrail Lake integration, the value is EVENT_DATA_STORE. For service-linked channels, the value is AWS_SERVICE.
  - Location (string) – [REQUIRED]
    
    For channels used for a CloudTrail Lake integration, the location is the ARN of an event data store that receives events from a channel. For service-linked channels, the location is the name of the Amazon Web Services service.
Tags (list) –
A list of tags.
- (dict) –
  
  A custom key-value pair associated with a resource such as a CloudTrail trail, event data store, dashboard, or channel.
  - Key (string) – [REQUIRED]
    
    The key in a key-value pair. The key must be must be no longer than 128 Unicode characters. The key must be unique for the resource to which it applies.
  - Value (string) –
    
    The value in a key-value pair of a tag. The value must be no longer than 256 Unicode characters.

Return type:

dict

Returns:

Response Syntax

{
    'ChannelArn': 'string',
    'Name': 'string',
    'Source': 'string',
    'Destinations': [
        {
            'Type': 'EVENT_DATA_STORE'|'AWS_SERVICE',
            'Location': 'string'
        },
    ],
    'Tags': [
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
}

Response Structure

(dict) –
- ChannelArn (string) –
  
  The Amazon Resource Name (ARN) of the new channel.
- Name (string) –
  
  The name of the new channel.
- Source (string) –
  
  The partner or external event source name.
- Destinations (list) –
  
  The event data stores that log the events arriving through the channel.
  - (dict) –
    
    Contains information about the destination receiving events.
    - Type (string) –
      
      The type of destination for events arriving from a channel. For channels used for a CloudTrail Lake integration, the value is EVENT_DATA_STORE. For service-linked channels, the value is AWS_SERVICE.
    - Location (string) –
      
      For channels used for a CloudTrail Lake integration, the location is the ARN of an event data store that receives events from a channel. For service-linked channels, the location is the name of the Amazon Web Services service.
- Tags (list) –
  
  A list of tags.
  - (dict) –
    
    A custom key-value pair associated with a resource such as a CloudTrail trail, event data store, dashboard, or channel.
    - Key (string) –
      
      The key in a key-value pair. The key must be must be no longer than 128 Unicode characters. The key must be unique for the resource to which it applies.
    - Value (string) –
      
      The value in a key-value pair of a tag. The value must be no longer than 256 Unicode characters.