AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

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.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginCreateChannel and EndCreateChannel.

Namespace: Amazon.CloudTrail
Assembly: AWSSDK.CloudTrail.dll
Version: 3.x.y.z

Syntax

C#
public virtual Task<CreateChannelResponse> CreateChannelAsync(
         CreateChannelRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.CloudTrail.Model.CreateChannelRequest

Container for the necessary parameters to execute the CreateChannel service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the CreateChannel service method, as returned by CloudTrail.

Exceptions

ExceptionCondition
ChannelAlreadyExistsException This exception is thrown when the provided channel already exists.
ChannelMaxLimitExceededException This exception is thrown when the maximum number of channels limit is exceeded.
EventDataStoreARNInvalidException The specified event data store ARN is not valid or does not map to an event data store in your account.
EventDataStoreNotFoundException The specified event data store was not found.
InactiveEventDataStoreException The event data store is inactive.
InvalidEventDataStoreCategoryException This exception is thrown when event categories of specified event data stores are not valid.
InvalidParameterException The request includes a parameter that is not valid.
InvalidSourceException This exception is thrown when the specified value of Source is not valid.
InvalidTagParameterException This exception is thrown when the specified tag key or values are not valid. It can also occur if there are duplicate tags or too many tags on the resource.
OperationNotPermittedException This exception is thrown when the requested operation is not permitted.
TagsLimitExceededException The number of tags per trail, event data store, or channel has exceeded the permitted amount. Currently, the limit is 50.
UnsupportedOperationException This exception is thrown when the requested operation is not supported.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also