aws-sdk-cloudtrail 1.49.0 → 1.50.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dec5d187176c43abe1b0f9e22af755232ba56d77e6046d484a4941906e768822
-  data.tar.gz: 031acc2864f6fd5fc8a6378177056166b3d6a13bc591565c69ced8c63513e5c4
+  metadata.gz: 92437a7a7cb64e0c36d4094799380ba953562fec2d133de0271299cfd9733f1b
+  data.tar.gz: a64de41244574754915618a7a79fc003a0c98ba7672fbff44ccdeebeab7a2895
 SHA512:
-  metadata.gz: 55e951e6f59972a6cf10f73ceebc98d1764dfd9171d5dc84cee5b1b0f3618cb6d0ad6a2ae671357eca2cc30d43a6b282f19a2cef37667153033195a027b63c0e
-  data.tar.gz: '0853615833aa071d8fce2194c44c1ae0c19f3c7d2e7c92ff79345f66b1b65abc9121ea292eacdd452f555dd2e92084c70d09d75e696d221591d0e43f4e8459d7'
+  metadata.gz: 3abd5b513985fe3c06e1497f965fbaa318686a627f5870f742204378909b24361c4a465308770a61530b10eebd6334b2238748ae3e5c606a3edc1d70651bff41
+  data.tar.gz: 0e89f2c4758a430eb4bdca0bc7d1a855bef3da80911cdb36f43686ebe570d2264d03da11d9f286f4cfeb88bcb629ff9199a5ce713b09ebf58e9ff1df5ee47578

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.50.0 (2022-09-09)
+------------------
+
+* Feature - This release adds CloudTrail getChannel and listChannels APIs to allow customer to view the ServiceLinkedChannel configurations.
+
 1.49.0 (2022-04-27)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.49.0
+1.50.0

data/lib/aws-sdk-cloudtrail/client.rb

@@ -469,7 +469,7 @@ module Aws::CloudTrail
     #
     # @option params [Integer] :retention_period
     #   The retention period of the event data store, in days. You can set a
-    #   retention period of up to 2555 days, the equivalent of seven years.
+    #   retention period of up to 2557 days, the equivalent of seven years.
     #
     # @option params [Boolean] :termination_protection_enabled
     #   Specifies whether termination protection is enabled for the event data
@@ -923,6 +923,63 @@ module Aws::CloudTrail
       req.send_request(options)
     end
 
+    # Returns the specified CloudTrail service-linked channel. Amazon Web
+    # Services services create service-linked channels to view CloudTrail
+    # events.
+    #
+    # @option params [required, String] :channel
+    #   The Amazon Resource Name (ARN) of the CloudTrail service-linked
+    #   channel.
+    #
+    # @return [Types::GetChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetChannelResponse#channel_arn #channel_arn} => String
+    #   * {Types::GetChannelResponse#name #name} => String
+    #   * {Types::GetChannelResponse#source #source} => String
+    #   * {Types::GetChannelResponse#source_config #source_config} => Types::SourceConfig
+    #   * {Types::GetChannelResponse#destinations #destinations} => Array<Types::Destination>
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_channel({
+    #     channel: "ChannelArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.channel_arn #=> String
+    #   resp.name #=> String
+    #   resp.source #=> String
+    #   resp.source_config.apply_to_all_regions #=> Boolean
+    #   resp.source_config.advanced_event_selectors #=> Array
+    #   resp.source_config.advanced_event_selectors[0].name #=> String
+    #   resp.source_config.advanced_event_selectors[0].field_selectors #=> Array
+    #   resp.source_config.advanced_event_selectors[0].field_selectors[0].field #=> String
+    #   resp.source_config.advanced_event_selectors[0].field_selectors[0].equals #=> Array
+    #   resp.source_config.advanced_event_selectors[0].field_selectors[0].equals[0] #=> String
+    #   resp.source_config.advanced_event_selectors[0].field_selectors[0].starts_with #=> Array
+    #   resp.source_config.advanced_event_selectors[0].field_selectors[0].starts_with[0] #=> String
+    #   resp.source_config.advanced_event_selectors[0].field_selectors[0].ends_with #=> Array
+    #   resp.source_config.advanced_event_selectors[0].field_selectors[0].ends_with[0] #=> String
+    #   resp.source_config.advanced_event_selectors[0].field_selectors[0].not_equals #=> Array
+    #   resp.source_config.advanced_event_selectors[0].field_selectors[0].not_equals[0] #=> String
+    #   resp.source_config.advanced_event_selectors[0].field_selectors[0].not_starts_with #=> Array
+    #   resp.source_config.advanced_event_selectors[0].field_selectors[0].not_starts_with[0] #=> String
+    #   resp.source_config.advanced_event_selectors[0].field_selectors[0].not_ends_with #=> Array
+    #   resp.source_config.advanced_event_selectors[0].field_selectors[0].not_ends_with[0] #=> String
+    #   resp.destinations #=> Array
+    #   resp.destinations[0].type #=> String, one of "EVENT_DATA_STORE", "AWS_SERVICE"
+    #   resp.destinations[0].location #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetChannel AWS API Documentation
+    #
+    # @overload get_channel(params = {})
+    # @param [Hash] params ({})
+    def get_channel(params = {}, options = {})
+      req = build_request(:get_channel, params)
+      req.send_request(options)
+    end
+
     # Returns information about an event data store specified as either an
     # ARN or the ID portion of the ARN.
     #
@@ -1308,6 +1365,44 @@ module Aws::CloudTrail
       req.send_request(options)
     end
 
+    # Returns all CloudTrail channels.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of CloudTrail channels to display on a single page.
+    #
+    # @option params [String] :next_token
+    #   A token you can use to get the next page of results.
+    #
+    # @return [Types::ListChannelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListChannelsResponse#channels #channels} => Array<Types::Channel>
+    #   * {Types::ListChannelsResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_channels({
+    #     max_results: 1,
+    #     next_token: "PaginationToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.channels #=> Array
+    #   resp.channels[0].channel_arn #=> String
+    #   resp.channels[0].name #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListChannels AWS API Documentation
+    #
+    # @overload list_channels(params = {})
+    # @param [Hash] params ({})
+    def list_channels(params = {}, options = {})
+      req = build_request(:list_channels, params)
+      req.send_request(options)
+    end
+
     # Returns information about all event data stores in the account, in the
     # current region.
     #
@@ -1540,7 +1635,7 @@ module Aws::CloudTrail
     # @option params [String] :next_token
     #   The token to use to get the next page of results after a previous API
     #   call. This token must be passed in with the same parameters that were
-    #   specified in the the original call. For example, if the original call
+    #   specified in the original call. For example, if the original call
     #   specified an AttributeKey of 'Username' with a value of 'root',
     #   the call with NextToken should include those same parameters.
     #
@@ -1642,7 +1737,7 @@ module Aws::CloudTrail
     # @option params [String] :next_token
     #   The token to use to get the next page of results after a previous API
     #   call. This token must be passed in with the same parameters that were
-    #   specified in the the original call. For example, if the original call
+    #   specified in the original call. For example, if the original call
     #   specified an AttributeKey of 'Username' with a value of 'root',
     #   the call with NextToken should include those same parameters.
     #
@@ -2113,7 +2208,7 @@ module Aws::CloudTrail
     # ARN or the ID portion of the ARN. Other parameters are optional, but
     # at least one optional parameter must be specified, or CloudTrail
     # throws an error. `RetentionPeriod` is in days, and valid values are
-    # integers between 90 and 2555. By default, `TerminationProtection` is
+    # integers between 90 and 2557. By default, `TerminationProtection` is
     # enabled. `AdvancedEventSelectors` includes or excludes management and
     # data events in your event data store; for more information about
     # `AdvancedEventSelectors`, see
@@ -2418,7 +2513,7 @@ module Aws::CloudTrail
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudtrail'
-      context[:gem_version] = '1.49.0'
+      context[:gem_version] = '1.50.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-cloudtrail/client_api.rb

@@ -23,6 +23,12 @@ module Aws::CloudTrail
     ByteBuffer = Shapes::BlobShape.new(name: 'ByteBuffer')
     CancelQueryRequest = Shapes::StructureShape.new(name: 'CancelQueryRequest')
     CancelQueryResponse = Shapes::StructureShape.new(name: 'CancelQueryResponse')
+    Channel = Shapes::StructureShape.new(name: 'Channel')
+    ChannelARNInvalidException = Shapes::StructureShape.new(name: 'ChannelARNInvalidException')
+    ChannelArn = Shapes::StringShape.new(name: 'ChannelArn')
+    ChannelName = Shapes::StringShape.new(name: 'ChannelName')
+    ChannelNotFoundException = Shapes::StructureShape.new(name: 'ChannelNotFoundException')
+    Channels = Shapes::ListShape.new(name: 'Channels')
     CloudTrailARNInvalidException = Shapes::StructureShape.new(name: 'CloudTrailARNInvalidException')
     CloudTrailAccessNotEnabledException = Shapes::StructureShape.new(name: 'CloudTrailAccessNotEnabledException')
     CloudTrailInvalidClientTokenIdException = Shapes::StructureShape.new(name: 'CloudTrailInvalidClientTokenIdException')
@@ -44,6 +50,9 @@ module Aws::CloudTrail
     DescribeQueryResponse = Shapes::StructureShape.new(name: 'DescribeQueryResponse')
     DescribeTrailsRequest = Shapes::StructureShape.new(name: 'DescribeTrailsRequest')
     DescribeTrailsResponse = Shapes::StructureShape.new(name: 'DescribeTrailsResponse')
+    Destination = Shapes::StructureShape.new(name: 'Destination')
+    DestinationType = Shapes::StringShape.new(name: 'DestinationType')
+    Destinations = Shapes::ListShape.new(name: 'Destinations')
     ErrorMessage = Shapes::StringShape.new(name: 'ErrorMessage')
     Event = Shapes::StructureShape.new(name: 'Event')
     EventCategory = Shapes::StringShape.new(name: 'EventCategory')
@@ -61,6 +70,8 @@ module Aws::CloudTrail
     EventSelectors = Shapes::ListShape.new(name: 'EventSelectors')
     EventsList = Shapes::ListShape.new(name: 'EventsList')
     ExcludeManagementEventSources = Shapes::ListShape.new(name: 'ExcludeManagementEventSources')
+    GetChannelRequest = Shapes::StructureShape.new(name: 'GetChannelRequest')
+    GetChannelResponse = Shapes::StructureShape.new(name: 'GetChannelResponse')
     GetEventDataStoreRequest = Shapes::StructureShape.new(name: 'GetEventDataStoreRequest')
     GetEventDataStoreResponse = Shapes::StructureShape.new(name: 'GetEventDataStoreResponse')
     GetEventSelectorsRequest = Shapes::StructureShape.new(name: 'GetEventSelectorsRequest')
@@ -110,6 +121,9 @@ module Aws::CloudTrail
     KmsException = Shapes::StructureShape.new(name: 'KmsException')
     KmsKeyDisabledException = Shapes::StructureShape.new(name: 'KmsKeyDisabledException')
     KmsKeyNotFoundException = Shapes::StructureShape.new(name: 'KmsKeyNotFoundException')
+    ListChannelsMaxResultsCount = Shapes::IntegerShape.new(name: 'ListChannelsMaxResultsCount')
+    ListChannelsRequest = Shapes::StructureShape.new(name: 'ListChannelsRequest')
+    ListChannelsResponse = Shapes::StructureShape.new(name: 'ListChannelsResponse')
     ListEventDataStoresMaxResultsCount = Shapes::IntegerShape.new(name: 'ListEventDataStoresMaxResultsCount')
     ListEventDataStoresRequest = Shapes::StructureShape.new(name: 'ListEventDataStoresRequest')
     ListEventDataStoresResponse = Shapes::StructureShape.new(name: 'ListEventDataStoresResponse')
@@ -122,6 +136,7 @@ module Aws::CloudTrail
     ListTagsResponse = Shapes::StructureShape.new(name: 'ListTagsResponse')
     ListTrailsRequest = Shapes::StructureShape.new(name: 'ListTrailsRequest')
     ListTrailsResponse = Shapes::StructureShape.new(name: 'ListTrailsResponse')
+    Location = Shapes::StringShape.new(name: 'Location')
     Long = Shapes::IntegerShape.new(name: 'Long')
     LookupAttribute = Shapes::StructureShape.new(name: 'LookupAttribute')
     LookupAttributeKey = Shapes::StringShape.new(name: 'LookupAttributeKey')
@@ -174,6 +189,8 @@ module Aws::CloudTrail
     S3BucketDoesNotExistException = Shapes::StructureShape.new(name: 'S3BucketDoesNotExistException')
     SelectorField = Shapes::StringShape.new(name: 'SelectorField')
     SelectorName = Shapes::StringShape.new(name: 'SelectorName')
+    Source = Shapes::StringShape.new(name: 'Source')
+    SourceConfig = Shapes::StructureShape.new(name: 'SourceConfig')
     StartLoggingRequest = Shapes::StructureShape.new(name: 'StartLoggingRequest')
     StartLoggingResponse = Shapes::StructureShape.new(name: 'StartLoggingResponse')
     StartQueryRequest = Shapes::StructureShape.new(name: 'StartQueryRequest')
@@ -233,6 +250,16 @@ module Aws::CloudTrail
     CancelQueryResponse.add_member(:query_status, Shapes::ShapeRef.new(shape: QueryStatus, required: true, location_name: "QueryStatus"))
     CancelQueryResponse.struct_class = Types::CancelQueryResponse
 
+    Channel.add_member(:channel_arn, Shapes::ShapeRef.new(shape: ChannelArn, location_name: "ChannelArn"))
+    Channel.add_member(:name, Shapes::ShapeRef.new(shape: ChannelName, location_name: "Name"))
+    Channel.struct_class = Types::Channel
+
+    ChannelARNInvalidException.struct_class = Types::ChannelARNInvalidException
+
+    ChannelNotFoundException.struct_class = Types::ChannelNotFoundException
+
+    Channels.member = Shapes::ShapeRef.new(shape: Channel)
+
     CloudTrailARNInvalidException.struct_class = Types::CloudTrailARNInvalidException
 
     CloudTrailAccessNotEnabledException.struct_class = Types::CloudTrailAccessNotEnabledException
@@ -330,6 +357,12 @@ module Aws::CloudTrail
     DescribeTrailsResponse.add_member(:trail_list, Shapes::ShapeRef.new(shape: TrailList, location_name: "trailList"))
     DescribeTrailsResponse.struct_class = Types::DescribeTrailsResponse
 
+    Destination.add_member(:type, Shapes::ShapeRef.new(shape: DestinationType, required: true, location_name: "Type"))
+    Destination.add_member(:location, Shapes::ShapeRef.new(shape: Location, required: true, location_name: "Location"))
+    Destination.struct_class = Types::Destination
+
+    Destinations.member = Shapes::ShapeRef.new(shape: Destination)
+
     Event.add_member(:event_id, Shapes::ShapeRef.new(shape: String, location_name: "EventId"))
     Event.add_member(:event_name, Shapes::ShapeRef.new(shape: String, location_name: "EventName"))
     Event.add_member(:read_only, Shapes::ShapeRef.new(shape: String, location_name: "ReadOnly"))
@@ -377,6 +410,16 @@ module Aws::CloudTrail
 
     ExcludeManagementEventSources.member = Shapes::ShapeRef.new(shape: String)
 
+    GetChannelRequest.add_member(:channel, Shapes::ShapeRef.new(shape: ChannelArn, required: true, location_name: "Channel"))
+    GetChannelRequest.struct_class = Types::GetChannelRequest
+
+    GetChannelResponse.add_member(:channel_arn, Shapes::ShapeRef.new(shape: ChannelArn, location_name: "ChannelArn"))
+    GetChannelResponse.add_member(:name, Shapes::ShapeRef.new(shape: ChannelName, location_name: "Name"))
+    GetChannelResponse.add_member(:source, Shapes::ShapeRef.new(shape: Source, location_name: "Source"))
+    GetChannelResponse.add_member(:source_config, Shapes::ShapeRef.new(shape: SourceConfig, location_name: "SourceConfig"))
+    GetChannelResponse.add_member(:destinations, Shapes::ShapeRef.new(shape: Destinations, location_name: "Destinations"))
+    GetChannelResponse.struct_class = Types::GetChannelResponse
+
     GetEventDataStoreRequest.add_member(:event_data_store, Shapes::ShapeRef.new(shape: EventDataStoreArn, required: true, location_name: "EventDataStore"))
     GetEventDataStoreRequest.struct_class = Types::GetEventDataStoreRequest
 
@@ -519,6 +562,14 @@ module Aws::CloudTrail
 
     KmsKeyNotFoundException.struct_class = Types::KmsKeyNotFoundException
 
+    ListChannelsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: ListChannelsMaxResultsCount, location_name: "MaxResults"))
+    ListChannelsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "NextToken"))
+    ListChannelsRequest.struct_class = Types::ListChannelsRequest
+
+    ListChannelsResponse.add_member(:channels, Shapes::ShapeRef.new(shape: Channels, location_name: "Channels"))
+    ListChannelsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "NextToken"))
+    ListChannelsResponse.struct_class = Types::ListChannelsResponse
+
     ListEventDataStoresRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "NextToken"))
     ListEventDataStoresRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: ListEventDataStoresMaxResultsCount, location_name: "MaxResults"))
     ListEventDataStoresRequest.struct_class = Types::ListEventDataStoresRequest
@@ -690,6 +741,10 @@ module Aws::CloudTrail
 
     S3BucketDoesNotExistException.struct_class = Types::S3BucketDoesNotExistException
 
+    SourceConfig.add_member(:apply_to_all_regions, Shapes::ShapeRef.new(shape: Boolean, location_name: "ApplyToAllRegions"))
+    SourceConfig.add_member(:advanced_event_selectors, Shapes::ShapeRef.new(shape: AdvancedEventSelectors, location_name: "AdvancedEventSelectors"))
+    SourceConfig.struct_class = Types::SourceConfig
+
     StartLoggingRequest.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name"))
     StartLoggingRequest.struct_class = Types::StartLoggingRequest
 
@@ -971,6 +1026,18 @@ module Aws::CloudTrail
         o.errors << Shapes::ShapeRef.new(shape: InvalidTrailNameException)
       end)
 
+      api.add_operation(:get_channel, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetChannel"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetChannelRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetChannelResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ChannelARNInvalidException)
+        o.errors << Shapes::ShapeRef.new(shape: ChannelNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
+        o.errors << Shapes::ShapeRef.new(shape: UnsupportedOperationException)
+      end)
+
       api.add_operation(:get_event_data_store, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetEventDataStore"
         o.http_method = "POST"
@@ -1055,6 +1122,23 @@ module Aws::CloudTrail
         o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
       end)
 
+      api.add_operation(:list_channels, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListChannels"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListChannelsRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListChannelsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
+        o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
+        o.errors << Shapes::ShapeRef.new(shape: UnsupportedOperationException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:list_event_data_stores, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListEventDataStores"
         o.http_method = "POST"

data/lib/aws-sdk-cloudtrail/errors.rb

@@ -27,6 +27,8 @@ module Aws::CloudTrail
   # See {Seahorse::Client::RequestContext} for more information.
   #
   # ## Error Classes
+  # * {ChannelARNInvalidException}
+  # * {ChannelNotFoundException}
   # * {CloudTrailARNInvalidException}
   # * {CloudTrailAccessNotEnabledException}
   # * {CloudTrailInvalidClientTokenIdException}
@@ -92,6 +94,26 @@ module Aws::CloudTrail
 
     extend Aws::Errors::DynamicErrors
 
+    class ChannelARNInvalidException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::CloudTrail::Types::ChannelARNInvalidException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
+    class ChannelNotFoundException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::CloudTrail::Types::ChannelNotFoundException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
     class CloudTrailARNInvalidException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

data/lib/aws-sdk-cloudtrail/types.rb

@@ -136,9 +136,9 @@ module Aws::CloudTrail
     #
     #   * <b> <code>readOnly</code> </b> - Optional. Can be set to `Equals`
     #     a value of `true` or `false`. If you do not add this field,
-    #     CloudTrail logs both both `read` and `write` events. A value of
-    #     `true` logs only `read` events. A value of `false` logs only
-    #     `write` events.
+    #     CloudTrail logs both `read` and `write` events. A value of `true`
+    #     logs only `read` events. A value of `false` logs only `write`
+    #     events.
     #
     #   * <b> <code>eventSource</code> </b> - For filtering management
     #     events only. This can be set only to `NotEquals`
@@ -363,6 +363,42 @@ module Aws::CloudTrail
       include Aws::Structure
     end
 
+    # Contains information about a returned CloudTrail channel.
+    #
+    # @!attribute [rw] channel_arn
+    #   The Amazon Resource Name (ARN) of the channel.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The name of the CloudTrail channel. For service-linked channels, the
+    #   name is `aws-service-channel/service-name/custom-suffix` where
+    #   `service-name` represents the name of the Amazon Web Services
+    #   service that created the channel and `custom-suffix` represents the
+    #   suffix created by the Amazon Web Services service.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/Channel AWS API Documentation
+    #
+    class Channel < Struct.new(
+      :channel_arn,
+      :name)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The specified channel ARN is not valid or does not map to a channel in
+    # your account.
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ChannelARNInvalidException AWS API Documentation
+    #
+    class ChannelARNInvalidException < Aws::EmptyStructure; end
+
+    # The specified channel was not found.
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ChannelNotFoundException AWS API Documentation
+    #
+    class ChannelNotFoundException < Aws::EmptyStructure; end
+
     # This exception is thrown when an operation is called with a trail ARN
     # that is not valid. The following is the format of a trail ARN.
     #
@@ -472,7 +508,7 @@ module Aws::CloudTrail
     #
     # @!attribute [rw] retention_period
     #   The retention period of the event data store, in days. You can set a
-    #   retention period of up to 2555 days, the equivalent of seven years.
+    #   retention period of up to 2557 days, the equivalent of seven years.
     #   @return [Integer]
     #
     # @!attribute [rw] termination_protection_enabled
@@ -1172,6 +1208,28 @@ module Aws::CloudTrail
       include Aws::Structure
     end
 
+    # Contains information about the service where CloudTrail delivers
+    # events.
+    #
+    # @!attribute [rw] type
+    #   The type of service. For service-linked channels, the value is
+    #   `AWS_SERVICE`.
+    #   @return [String]
+    #
+    # @!attribute [rw] location
+    #   The location of the service. For service-linked channels, this is
+    #   the name of the Amazon Web Services service.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/Destination AWS API Documentation
+    #
+    class Destination < Struct.new(
+      :type,
+      :location)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains information about an event that was returned by a lookup
     # request. The result includes a representation of a CloudTrail event.
     #
@@ -1233,7 +1291,7 @@ module Aws::CloudTrail
 
     # A storage lake of event data against which you can run complex
     # SQL-based queries. An event data store can include events that you
-    # have logged on your account from the last 90 to 2555 days (about three
+    # have logged on your account from the last 90 to 2557 days (about three
     # months to up to seven years). To select events for an event data
     # store, use [advanced event selectors][1].
     #
@@ -1436,6 +1494,67 @@ module Aws::CloudTrail
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetChannelRequest
+    #   data as a hash:
+    #
+    #       {
+    #         channel: "ChannelArn", # required
+    #       }
+    #
+    # @!attribute [rw] channel
+    #   The Amazon Resource Name (ARN) of the CloudTrail service-linked
+    #   channel.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetChannelRequest AWS API Documentation
+    #
+    class GetChannelRequest < Struct.new(
+      :channel)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] channel_arn
+    #   The ARN of the CloudTrail service-linked channel.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The name of the CloudTrail service-linked channel. For
+    #   service-linked channels, the value is
+    #   `aws-service-channel/service-name/custom-suffix` where
+    #   `service-name` represents the name of the Amazon Web Services
+    #   service that created the channel and `custom-suffix` represents the
+    #   suffix generated by the Amazon Web Services service.
+    #   @return [String]
+    #
+    # @!attribute [rw] source
+    #   The trail or event data store for the CloudTrail service-linked
+    #   channel.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_config
+    #   Provides information about the advanced event selectors configured
+    #   for the service-linked channel, and whether the service-linked
+    #   channel applies to all regions or one region.
+    #   @return [Types::SourceConfig]
+    #
+    # @!attribute [rw] destinations
+    #   The Amazon Web Services service that created the CloudTrail
+    #   service-linked channel.
+    #   @return [Array<Types::Destination>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetChannelResponse AWS API Documentation
+    #
+    class GetChannelResponse < Struct.new(
+      :channel_arn,
+      :name,
+      :source,
+      :source_config,
+      :destinations)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass GetEventDataStoreRequest
     #   data as a hash:
     #
@@ -2201,6 +2320,49 @@ module Aws::CloudTrail
     #
     class KmsKeyNotFoundException < Aws::EmptyStructure; end
 
+    # @note When making an API call, you may pass ListChannelsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         max_results: 1,
+    #         next_token: "PaginationToken",
+    #       }
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of CloudTrail channels to display on a single
+    #   page.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   A token you can use to get the next page of results.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListChannelsRequest AWS API Documentation
+    #
+    class ListChannelsRequest < Struct.new(
+      :max_results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] channels
+    #   The list of CloudTrail channels.
+    #   @return [Array<Types::Channel>]
+    #
+    # @!attribute [rw] next_token
+    #   A token used to get the next page of results.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListChannelsResponse AWS API Documentation
+    #
+    class ListChannelsResponse < Struct.new(
+      :channels,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ListEventDataStoresRequest
     #   data as a hash:
     #
@@ -2436,9 +2598,9 @@ module Aws::CloudTrail
     # @!attribute [rw] next_token
     #   The token to use to get the next page of results after a previous
     #   API call. This token must be passed in with the same parameters that
-    #   were specified in the the original call. For example, if the
-    #   original call specified an AttributeKey of 'Username' with a value
-    #   of 'root', the call with NextToken should include those same
+    #   were specified in the original call. For example, if the original
+    #   call specified an AttributeKey of 'Username' with a value of
+    #   'root', the call with NextToken should include those same
     #   parameters.
     #   @return [String]
     #
@@ -2551,9 +2713,9 @@ module Aws::CloudTrail
     # @!attribute [rw] next_token
     #   The token to use to get the next page of results after a previous
     #   API call. This token must be passed in with the same parameters that
-    #   were specified in the the original call. For example, if the
-    #   original call specified an AttributeKey of 'Username' with a value
-    #   of 'root', the call with NextToken should include those same
+    #   were specified in the original call. For example, if the original
+    #   call specified an AttributeKey of 'Username' with a value of
+    #   'root', the call with NextToken should include those same
     #   parameters.
     #   @return [String]
     #
@@ -3141,6 +3303,27 @@ module Aws::CloudTrail
     #
     class S3BucketDoesNotExistException < Aws::EmptyStructure; end
 
+    # Contains configuration information about the service-linked channel.
+    #
+    # @!attribute [rw] apply_to_all_regions
+    #   Specifies whether the service-linked channel applies to one region
+    #   or all regions.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] advanced_event_selectors
+    #   The advanced event selectors configured for the service-linked
+    #   channel.
+    #   @return [Array<Types::AdvancedEventSelector>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/SourceConfig AWS API Documentation
+    #
+    class SourceConfig < Struct.new(
+      :apply_to_all_regions,
+      :advanced_event_selectors)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The request to CloudTrail to start logging Amazon Web Services API
     # calls for an account.
     #

data/lib/aws-sdk-cloudtrail.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-cloudtrail/customizations'
 # @!group service
 module Aws::CloudTrail
 
-  GEM_VERSION = '1.49.0'
+  GEM_VERSION = '1.50.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudtrail
 version: !ruby/object:Gem::Version
-  version: 1.49.0
+  version: 1.50.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-04-27 00:00:00.000000000 Z
+date: 2022-09-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core