CloudTrail / Client / update_channel

update_channel#

CloudTrail.Client.update_channel(**kwargs)#

Updates a channel specified by a required channel ARN or UUID.

See also: AWS API Documentation

Request Syntax

response = client.update_channel(
    Channel='string',
    Destinations=[
        {
            'Type': 'EVENT_DATA_STORE'|'AWS_SERVICE',
            'Location': 'string'
        },
    ],
    Name='string'
)
Parameters:
  • Channel (string) –

    [REQUIRED]

    The ARN or ID (the ARN suffix) of the channel that you want to update.

  • Destinations (list) –

    The ARNs of event data stores that you want to log events arriving through the channel.

    • (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.

  • Name (string) – Changes the name of the channel.

Return type:

dict

Returns:

Response Syntax

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

Response Structure

  • (dict) –

    • ChannelArn (string) –

      The ARN of the channel that was updated.

    • Name (string) –

      The name of the channel that was updated.

    • Source (string) –

      The event source of the channel that was updated.

    • Destinations (list) –

      The event data stores that log 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.

Exceptions

  • CloudTrail.Client.exceptions.ChannelARNInvalidException

  • CloudTrail.Client.exceptions.ChannelNotFoundException

  • CloudTrail.Client.exceptions.ChannelAlreadyExistsException

  • CloudTrail.Client.exceptions.EventDataStoreARNInvalidException

  • CloudTrail.Client.exceptions.EventDataStoreNotFoundException

  • CloudTrail.Client.exceptions.InvalidEventDataStoreCategoryException

  • CloudTrail.Client.exceptions.InactiveEventDataStoreException

  • CloudTrail.Client.exceptions.InvalidParameterException

  • CloudTrail.Client.exceptions.OperationNotPermittedException

  • CloudTrail.Client.exceptions.UnsupportedOperationException