aws-sdk-cloudtrail 1.47.0 → 1.50.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fbcb8829b7f62ec563c39d048e6cc41280bc6da20d8b6767c0fa2452b138eb7c
-  data.tar.gz: bf8c8cdf82589369124555546003c065a240447daef6d7cb5e7a685f30eb11b0
+  metadata.gz: 92437a7a7cb64e0c36d4094799380ba953562fec2d133de0271299cfd9733f1b
+  data.tar.gz: a64de41244574754915618a7a79fc003a0c98ba7672fbff44ccdeebeab7a2895
 SHA512:
-  metadata.gz: 9b8eb4ed5328581d3158efa597e10d5ee9742c9ca7f2848d9d5ba217b20373d89ad7c6d583a03c3037afe08e3227b17ca2b55f3602d21e4f181a7908dba0b398
-  data.tar.gz: cf1ab13ca158bd6c5273973298008c1dda4578723126b252a4dd1065de2383f109aeff173446cd7f1bc4fc1abc925c60f9f597c564ea8ce70e852fdea6f2fc83
+  metadata.gz: 3abd5b513985fe3c06e1497f965fbaa318686a627f5870f742204378909b24361c4a465308770a61530b10eebd6334b2238748ae3e5c606a3edc1d70651bff41
+  data.tar.gz: 0e89f2c4758a430eb4bdca0bc7d1a855bef3da80911cdb36f43686ebe570d2264d03da11d9f286f4cfeb88bcb629ff9199a5ce713b09ebf58e9ff1df5ee47578

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 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)
+------------------
+
+* Feature - Increases the retention period maximum to 2557 days. Deprecates unused fields of the ListEventDataStores API response. Updates documentation.
+
+1.48.0 (2022-03-02)
+------------------
+
+* Feature - Add bytesScanned field into responses of DescribeQuery and GetQueryResults.
+
 1.47.0 (2022-02-24)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.47.0
+1.50.0

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

@@ -361,18 +361,19 @@ module Aws::CloudTrail
 
     # @!group API Operations
 
-    # Adds one or more tags to a trail, up to a limit of 50. Overwrites an
-    # existing tag's value when a new value is specified for an existing
-    # tag key. Tag key names must be unique for a trail; you cannot have two
-    # keys with the same name but different values. If you specify a key
-    # without a value, the tag will be created with the specified key and a
-    # value of null. You can tag a trail that applies to all Amazon Web
-    # Services Regions only from the Region in which the trail was created
-    # (also known as its home region).
+    # Adds one or more tags to a trail or event data store, up to a limit of
+    # 50. Overwrites an existing tag's value when a new value is specified
+    # for an existing tag key. Tag key names must be unique for a trail; you
+    # cannot have two keys with the same name but different values. If you
+    # specify a key without a value, the tag will be created with the
+    # specified key and a value of null. You can tag a trail or event data
+    # store that applies to all Amazon Web Services Regions only from the
+    # Region in which the trail or event data store was created (also known
+    # as its home region).
     #
     # @option params [required, String] :resource_id
-    #   Specifies the ARN of the trail to which one or more tags will be
-    #   added. The format of a trail ARN is:
+    #   Specifies the ARN of the trail or event data store to which one or
+    #   more tags will be added. The format of a trail ARN is:
     #
     #   `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
     #
@@ -403,10 +404,10 @@ module Aws::CloudTrail
     end
 
     # Cancels a query if the query is not in a terminated state, such as
-    # `CANCELLED`, `FAILED` or `FINISHED`. You must specify an ARN value for
-    # `EventDataStore`. The ID of the query that you want to cancel is also
-    # required. When you run `CancelQuery`, the query status might show as
-    # `CANCELLED` even if the operation is not yet finished.
+    # `CANCELLED`, `FAILED`, `TIMED_OUT`, or `FINISHED`. You must specify an
+    # ARN value for `EventDataStore`. The ID of the query that you want to
+    # cancel is also required. When you run `CancelQuery`, the query status
+    # might show as `CANCELLED` even if the operation is not yet finished.
     #
     # @option params [required, String] :event_data_store
     #   The ARN (or the ID suffix of the ARN) of an event data store on which
@@ -431,7 +432,7 @@ module Aws::CloudTrail
     # @example Response structure
     #
     #   resp.query_id #=> String
-    #   resp.query_status #=> String, one of "QUEUED", "RUNNING", "FINISHED", "FAILED", "CANCELLED"
+    #   resp.query_status #=> String, one of "QUEUED", "RUNNING", "FINISHED", "FAILED", "CANCELLED", "TIMED_OUT"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/CancelQuery AWS API Documentation
     #
@@ -468,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
@@ -831,9 +832,10 @@ module Aws::CloudTrail
     #
     #   resp.query_id #=> String
     #   resp.query_string #=> String
-    #   resp.query_status #=> String, one of "QUEUED", "RUNNING", "FINISHED", "FAILED", "CANCELLED"
+    #   resp.query_status #=> String, one of "QUEUED", "RUNNING", "FINISHED", "FAILED", "CANCELLED", "TIMED_OUT"
     #   resp.query_statistics.events_matched #=> Integer
     #   resp.query_statistics.events_scanned #=> Integer
+    #   resp.query_statistics.bytes_scanned #=> Integer
     #   resp.query_statistics.execution_time_in_millis #=> Integer
     #   resp.query_statistics.creation_time #=> Time
     #   resp.error_message #=> String
@@ -921,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.
     #
@@ -1172,9 +1231,10 @@ module Aws::CloudTrail
     #
     # @example Response structure
     #
-    #   resp.query_status #=> String, one of "QUEUED", "RUNNING", "FINISHED", "FAILED", "CANCELLED"
+    #   resp.query_status #=> String, one of "QUEUED", "RUNNING", "FINISHED", "FAILED", "CANCELLED", "TIMED_OUT"
     #   resp.query_statistics.results_count #=> Integer
     #   resp.query_statistics.total_results_count #=> Integer
+    #   resp.query_statistics.bytes_scanned #=> Integer
     #   resp.query_result_rows #=> Array
     #   resp.query_result_rows[0] #=> Array
     #   resp.query_result_rows[0][0] #=> Hash
@@ -1305,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.
     #
@@ -1430,7 +1528,7 @@ module Aws::CloudTrail
     # shorten the list of results, you can specify a time range, formatted
     # as timestamps, by adding `StartTime` and `EndTime` parameters, and a
     # `QueryStatus` value. Valid values for `QueryStatus` include `QUEUED`,
-    # `RUNNING`, `FINISHED`, `FAILED`, or `CANCELLED`.
+    # `RUNNING`, `FINISHED`, `FAILED`, `TIMED_OUT`, or `CANCELLED`.
     #
     # @option params [required, String] :event_data_store
     #   The ARN (or the ID suffix of the ARN) of an event data store on which
@@ -1453,7 +1551,7 @@ module Aws::CloudTrail
     # @option params [String] :query_status
     #   The status of queries that you want to return in results. Valid values
     #   for `QueryStatus` include `QUEUED`, `RUNNING`, `FINISHED`, `FAILED`,
-    #   or `CANCELLED`.
+    #   `TIMED_OUT`, or `CANCELLED`.
     #
     # @return [Types::ListQueriesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1470,14 +1568,14 @@ module Aws::CloudTrail
     #     max_results: 1,
     #     start_time: Time.now,
     #     end_time: Time.now,
-    #     query_status: "QUEUED", # accepts QUEUED, RUNNING, FINISHED, FAILED, CANCELLED
+    #     query_status: "QUEUED", # accepts QUEUED, RUNNING, FINISHED, FAILED, CANCELLED, TIMED_OUT
     #   })
     #
     # @example Response structure
     #
     #   resp.queries #=> Array
     #   resp.queries[0].query_id #=> String
-    #   resp.queries[0].query_status #=> String, one of "QUEUED", "RUNNING", "FINISHED", "FAILED", "CANCELLED"
+    #   resp.queries[0].query_status #=> String, one of "QUEUED", "RUNNING", "FINISHED", "FAILED", "CANCELLED", "TIMED_OUT"
     #   resp.queries[0].creation_time #=> Time
     #   resp.next_token #=> String
     #
@@ -1490,13 +1588,12 @@ module Aws::CloudTrail
       req.send_request(options)
     end
 
-    # Lists the tags for the trail in the current region.
+    # Lists the tags for the trail or event data store in the current
+    # region.
     #
     # @option params [required, Array<String>] :resource_id_list
-    #   Specifies a list of trail ARNs whose tags will be listed. The list has
-    #   a limit of 20 ARNs. The following is the format of a trail ARN.
-    #
-    #   `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
+    #   Specifies a list of trail and event data store ARNs whose tags will be
+    #   listed. The list has a limit of 20 ARNs.
     #
     # @option params [String] :next_token
     #   Reserved for future use.
@@ -1538,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.
     #
@@ -1640,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.
     #
@@ -1909,14 +2006,18 @@ module Aws::CloudTrail
       req.send_request(options)
     end
 
-    # Removes the specified tags from a trail.
+    # Removes the specified tags from a trail or event data store.
     #
     # @option params [required, String] :resource_id
-    #   Specifies the ARN of the trail from which tags should be removed. The
-    #   format of a trail ARN is:
+    #   Specifies the ARN of the trail or event data store from which tags
+    #   should be removed.
     #
+    #   Example trail ARN format:
     #   `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
     #
+    #   Example event data store ARN format:
+    #   `arn:aws:cloudtrail:us-east-2:12345678910:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
+    #
     # @option params [required, Array<Types::Tag>] :tags_list
     #   Specifies a list of tags to be removed.
     #
@@ -2107,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
@@ -2412,7 +2513,7 @@ module Aws::CloudTrail
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudtrail'
-      context[:gem_version] = '1.47.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"))
@@ -343,14 +376,14 @@ module Aws::CloudTrail
 
     EventDataStore.add_member(:event_data_store_arn, Shapes::ShapeRef.new(shape: EventDataStoreArn, location_name: "EventDataStoreArn"))
     EventDataStore.add_member(:name, Shapes::ShapeRef.new(shape: EventDataStoreName, location_name: "Name"))
-    EventDataStore.add_member(:termination_protection_enabled, Shapes::ShapeRef.new(shape: TerminationProtectionEnabled, location_name: "TerminationProtectionEnabled"))
-    EventDataStore.add_member(:status, Shapes::ShapeRef.new(shape: EventDataStoreStatus, location_name: "Status"))
-    EventDataStore.add_member(:advanced_event_selectors, Shapes::ShapeRef.new(shape: AdvancedEventSelectors, location_name: "AdvancedEventSelectors"))
-    EventDataStore.add_member(:multi_region_enabled, Shapes::ShapeRef.new(shape: Boolean, location_name: "MultiRegionEnabled"))
-    EventDataStore.add_member(:organization_enabled, Shapes::ShapeRef.new(shape: Boolean, location_name: "OrganizationEnabled"))
-    EventDataStore.add_member(:retention_period, Shapes::ShapeRef.new(shape: RetentionPeriod, location_name: "RetentionPeriod"))
-    EventDataStore.add_member(:created_timestamp, Shapes::ShapeRef.new(shape: Date, location_name: "CreatedTimestamp"))
-    EventDataStore.add_member(:updated_timestamp, Shapes::ShapeRef.new(shape: Date, location_name: "UpdatedTimestamp"))
+    EventDataStore.add_member(:termination_protection_enabled, Shapes::ShapeRef.new(shape: TerminationProtectionEnabled, deprecated: true, location_name: "TerminationProtectionEnabled", metadata: {"deprecatedMessage"=>"TerminationProtectionEnabled is no longer returned by ListEventDataStores"}))
+    EventDataStore.add_member(:status, Shapes::ShapeRef.new(shape: EventDataStoreStatus, deprecated: true, location_name: "Status", metadata: {"deprecatedMessage"=>"Status is no longer returned by ListEventDataStores"}))
+    EventDataStore.add_member(:advanced_event_selectors, Shapes::ShapeRef.new(shape: AdvancedEventSelectors, deprecated: true, location_name: "AdvancedEventSelectors", metadata: {"deprecatedMessage"=>"AdvancedEventSelectors is no longer returned by ListEventDataStores"}))
+    EventDataStore.add_member(:multi_region_enabled, Shapes::ShapeRef.new(shape: Boolean, deprecated: true, location_name: "MultiRegionEnabled", metadata: {"deprecatedMessage"=>"MultiRegionEnabled is no longer returned by ListEventDataStores"}))
+    EventDataStore.add_member(:organization_enabled, Shapes::ShapeRef.new(shape: Boolean, deprecated: true, location_name: "OrganizationEnabled", metadata: {"deprecatedMessage"=>"OrganizationEnabled is no longer returned by ListEventDataStores"}))
+    EventDataStore.add_member(:retention_period, Shapes::ShapeRef.new(shape: RetentionPeriod, deprecated: true, location_name: "RetentionPeriod", metadata: {"deprecatedMessage"=>"RetentionPeriod is no longer returned by ListEventDataStores"}))
+    EventDataStore.add_member(:created_timestamp, Shapes::ShapeRef.new(shape: Date, deprecated: true, location_name: "CreatedTimestamp", metadata: {"deprecatedMessage"=>"CreatedTimestamp is no longer returned by ListEventDataStores"}))
+    EventDataStore.add_member(:updated_timestamp, Shapes::ShapeRef.new(shape: Date, deprecated: true, location_name: "UpdatedTimestamp", metadata: {"deprecatedMessage"=>"UpdatedTimestamp is no longer returned by ListEventDataStores"}))
     EventDataStore.struct_class = Types::EventDataStore
 
     EventDataStoreARNInvalidException.struct_class = Types::EventDataStoreARNInvalidException
@@ -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
@@ -639,10 +690,12 @@ module Aws::CloudTrail
 
     QueryStatistics.add_member(:results_count, Shapes::ShapeRef.new(shape: Integer, location_name: "ResultsCount"))
     QueryStatistics.add_member(:total_results_count, Shapes::ShapeRef.new(shape: Integer, location_name: "TotalResultsCount"))
+    QueryStatistics.add_member(:bytes_scanned, Shapes::ShapeRef.new(shape: Long, location_name: "BytesScanned"))
     QueryStatistics.struct_class = Types::QueryStatistics
 
     QueryStatisticsForDescribeQuery.add_member(:events_matched, Shapes::ShapeRef.new(shape: Long, location_name: "EventsMatched"))
     QueryStatisticsForDescribeQuery.add_member(:events_scanned, Shapes::ShapeRef.new(shape: Long, location_name: "EventsScanned"))
+    QueryStatisticsForDescribeQuery.add_member(:bytes_scanned, Shapes::ShapeRef.new(shape: Long, location_name: "BytesScanned"))
     QueryStatisticsForDescribeQuery.add_member(:execution_time_in_millis, Shapes::ShapeRef.new(shape: Integer, location_name: "ExecutionTimeInMillis"))
     QueryStatisticsForDescribeQuery.add_member(:creation_time, Shapes::ShapeRef.new(shape: Date, location_name: "CreationTime"))
     QueryStatisticsForDescribeQuery.struct_class = Types::QueryStatisticsForDescribeQuery
@@ -688,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
 
@@ -969,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"
@@ -1053,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

@@ -10,7 +10,7 @@
 module Aws::CloudTrail
   module Types
 
-    # Specifies the tags to add to a trail.
+    # Specifies the tags to add to a trail or event data store.
     #
     # @note When making an API call, you may pass AddTagsRequest
     #   data as a hash:
@@ -26,8 +26,8 @@ module Aws::CloudTrail
     #       }
     #
     # @!attribute [rw] resource_id
-    #   Specifies the ARN of the trail to which one or more tags will be
-    #   added. The format of a trail ARN is:
+    #   Specifies the ARN of the trail or event data store to which one or
+    #   more tags will be added. The format of a trail ARN is:
     #
     #   `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
     #   @return [String]
@@ -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.
     #
@@ -403,8 +439,8 @@ module Aws::CloudTrail
 
     # This exception is thrown when the specified resource is not ready for
     # an operation. This can occur when you try to run an operation on a
-    # trail before CloudTrail has time to fully load the trail. If this
-    # exception occurs, wait a few minutes, and then try the operation
+    # resource before CloudTrail has time to fully load the resource. If
+    # this exception occurs, wait a few minutes, and then try the operation
     # again.
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ConflictException AWS API Documentation
@@ -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
@@ -1074,7 +1110,7 @@ module Aws::CloudTrail
     #
     # @!attribute [rw] query_status
     #   The status of a query. Values for `QueryStatus` include `QUEUED`,
-    #   `RUNNING`, `FINISHED`, `FAILED`, or `CANCELLED`
+    #   `RUNNING`, `FINISHED`, `FAILED`, `TIMED_OUT`, or `CANCELLED`
     #   @return [String]
     #
     # @!attribute [rw] query_statistics
@@ -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].
     #
@@ -1250,42 +1308,44 @@ module Aws::CloudTrail
     #   @return [String]
     #
     # @!attribute [rw] termination_protection_enabled
-    #   Indicates whether the event data store is protected from
-    #   termination.
+    #   This field is being deprecated. Indicates whether the event data
+    #   store is protected from termination.
     #   @return [Boolean]
     #
     # @!attribute [rw] status
-    #   The status of an event data store. Values are `ENABLED` and
-    #   `PENDING_DELETION`.
+    #   This field is being deprecated. The status of an event data store.
+    #   Values are `ENABLED` and `PENDING_DELETION`.
     #   @return [String]
     #
     # @!attribute [rw] advanced_event_selectors
-    #   The advanced event selectors that were used to select events for the
-    #   data store.
+    #   This field is being deprecated. The advanced event selectors that
+    #   were used to select events for the data store.
     #   @return [Array<Types::AdvancedEventSelector>]
     #
     # @!attribute [rw] multi_region_enabled
-    #   Indicates whether the event data store includes events from all
-    #   regions, or only from the region in which it was created.
+    #   This field is being deprecated. Indicates whether the event data
+    #   store includes events from all regions, or only from the region in
+    #   which it was created.
     #   @return [Boolean]
     #
     # @!attribute [rw] organization_enabled
-    #   Indicates that an event data store is collecting logged events for
-    #   an organization.
+    #   This field is being deprecated. Indicates that an event data store
+    #   is collecting logged events for an organization.
     #   @return [Boolean]
     #
     # @!attribute [rw] retention_period
-    #   The retention period, in days.
+    #   This field is being deprecated. The retention period, in days.
     #   @return [Integer]
     #
     # @!attribute [rw] created_timestamp
-    #   The timestamp of the event data store's creation.
+    #   This field is being deprecated. The timestamp of the event data
+    #   store's creation.
     #   @return [Time]
     #
     # @!attribute [rw] updated_timestamp
-    #   The timestamp showing when an event data store was updated, if
-    #   applicable. `UpdatedTimestamp` is always either the same or newer
-    #   than the time shown in `CreatedTimestamp`.
+    #   This field is being deprecated. The timestamp showing when an event
+    #   data store was updated, if applicable. `UpdatedTimestamp` is always
+    #   either the same or newer than the time shown in `CreatedTimestamp`.
     #   @return [Time]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/EventDataStore AWS API Documentation
@@ -1434,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:
     #
@@ -1671,7 +1792,7 @@ module Aws::CloudTrail
 
     # @!attribute [rw] query_status
     #   The status of the query. Values include `QUEUED`, `RUNNING`,
-    #   `FINISHED`, `FAILED`, or `CANCELLED`.
+    #   `FINISHED`, `FAILED`, `TIMED_OUT`, or `CANCELLED`.
     #   @return [String]
     #
     # @!attribute [rw] query_statistics
@@ -1900,14 +2021,14 @@ module Aws::CloudTrail
       include Aws::Structure
     end
 
-    # The event data store against which you ran your query is inactive.
+    # The event data store is inactive.
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/InactiveEventDataStoreException AWS API Documentation
     #
     class InactiveEventDataStoreException < Aws::EmptyStructure; end
 
     # The specified query cannot be canceled because it is in the
-    # `FINISHED`, `FAILED`, or `CANCELLED` state.
+    # `FINISHED`, `FAILED`, `TIMED_OUT`, or `CANCELLED` state.
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/InactiveQueryException AWS API Documentation
     #
@@ -1945,14 +2066,9 @@ module Aws::CloudTrail
     end
 
     # This exception is thrown when the IAM user or role that is used to
-    # create the organization trail is lacking one or more required
-    # permissions for creating an organization trail in a required service.
-    # For more information, see [Prepare For Creating a Trail For Your
-    # Organization][1].
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-an-organizational-trail-prepare.html
+    # create the organization resource lacks one or more required
+    # permissions for creating an organization resource in a required
+    # service.
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/InsufficientDependencyServiceAccessPermissionException AWS API Documentation
     #
@@ -1992,7 +2108,8 @@ module Aws::CloudTrail
     #
     class InvalidCloudWatchLogsRoleArnException < Aws::EmptyStructure; end
 
-    # A date range for the query was specified that is not valid. For more
+    # A date range for the query was specified that is not valid. Be sure
+    # that the start time is chronologically before the end time. For more
     # information about writing a query, see [Create or edit a query][1] in
     # the *CloudTrail User Guide*.
     #
@@ -2203,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:
     #
@@ -2317,7 +2477,7 @@ module Aws::CloudTrail
     #         max_results: 1,
     #         start_time: Time.now,
     #         end_time: Time.now,
-    #         query_status: "QUEUED", # accepts QUEUED, RUNNING, FINISHED, FAILED, CANCELLED
+    #         query_status: "QUEUED", # accepts QUEUED, RUNNING, FINISHED, FAILED, CANCELLED, TIMED_OUT
     #       }
     #
     # @!attribute [rw] event_data_store
@@ -2346,7 +2506,7 @@ module Aws::CloudTrail
     # @!attribute [rw] query_status
     #   The status of queries that you want to return in results. Valid
     #   values for `QueryStatus` include `QUEUED`, `RUNNING`, `FINISHED`,
-    #   `FAILED`, or `CANCELLED`.
+    #   `FAILED`, `TIMED_OUT`, or `CANCELLED`.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListQueriesRequest AWS API Documentation
@@ -2380,7 +2540,7 @@ module Aws::CloudTrail
       include Aws::Structure
     end
 
-    # Specifies a list of trail tags to return.
+    # Specifies a list of tags to return.
     #
     # @note When making an API call, you may pass ListTagsRequest
     #   data as a hash:
@@ -2391,10 +2551,8 @@ module Aws::CloudTrail
     #       }
     #
     # @!attribute [rw] resource_id_list
-    #   Specifies a list of trail ARNs whose tags will be listed. The list
-    #   has a limit of 20 ARNs. The following is the format of a trail ARN.
-    #
-    #   `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
+    #   Specifies a list of trail and event data store ARNs whose tags will
+    #   be listed. The list has a limit of 20 ARNs.
     #   @return [Array<String>]
     #
     # @!attribute [rw] next_token
@@ -2440,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]
     #
@@ -2555,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]
     #
@@ -2614,14 +2772,15 @@ module Aws::CloudTrail
     class MaximumNumberOfTrailsExceededException < Aws::EmptyStructure; end
 
     # This exception is thrown when the Amazon Web Services account making
-    # the request to create or update an organization trail is not the
-    # management account for an organization in Organizations. For more
-    # information, see [Prepare For Creating a Trail For Your
-    # Organization][1].
+    # the request to create or update an organization trail or event data
+    # store is not the management account for an organization in
+    # Organizations. For more information, see [Prepare For Creating a Trail
+    # For Your Organization][1] or [Create an event data store][2].
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-an-organizational-trail-prepare.html
+    # [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/query-event-data-store.html
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/NotOrganizationMasterAccountException AWS API Documentation
     #
@@ -2636,12 +2795,7 @@ module Aws::CloudTrail
 
     # This exception is thrown when Organizations is not configured to
     # support all features. All features must be enabled in Organizations to
-    # support creating an organization trail. For more information, see
-    # [Prepare For Creating a Trail For Your Organization][1].
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-an-organizational-trail-prepare.html
+    # support creating an organization trail or event data store.
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/OrganizationNotInAllFeaturesModeException AWS API Documentation
     #
@@ -2863,7 +3017,7 @@ module Aws::CloudTrail
     #
     # @!attribute [rw] query_status
     #   The status of the query. This can be `QUEUED`, `RUNNING`,
-    #   `FINISHED`, `FAILED`, or `CANCELLED`.
+    #   `FINISHED`, `FAILED`, `TIMED_OUT`, or `CANCELLED`.
     #   @return [String]
     #
     # @!attribute [rw] creation_time
@@ -2896,11 +3050,18 @@ module Aws::CloudTrail
     #   The total number of results returned by a query.
     #   @return [Integer]
     #
+    # @!attribute [rw] bytes_scanned
+    #   The total bytes that the query scanned in the event data store. This
+    #   value matches the number of bytes for which your account is billed
+    #   for the query, unless the query is still running.
+    #   @return [Integer]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/QueryStatistics AWS API Documentation
     #
     class QueryStatistics < Struct.new(
       :results_count,
-      :total_results_count)
+      :total_results_count,
+      :bytes_scanned)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2917,6 +3078,12 @@ module Aws::CloudTrail
     #   The number of events that the query scanned in the event data store.
     #   @return [Integer]
     #
+    # @!attribute [rw] bytes_scanned
+    #   The total bytes that the query scanned in the event data store. This
+    #   value matches the number of bytes for which your account is billed
+    #   for the query, unless the query is still running.
+    #   @return [Integer]
+    #
     # @!attribute [rw] execution_time_in_millis
     #   The query's run time, in milliseconds.
     #   @return [Integer]
@@ -2930,13 +3097,14 @@ module Aws::CloudTrail
     class QueryStatisticsForDescribeQuery < Struct.new(
       :events_matched,
       :events_scanned,
+      :bytes_scanned,
       :execution_time_in_millis,
       :creation_time)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # Specifies the tags to remove from a trail.
+    # Specifies the tags to remove from a trail or event data store.
     #
     # @note When making an API call, you may pass RemoveTagsRequest
     #   data as a hash:
@@ -2952,10 +3120,14 @@ module Aws::CloudTrail
     #       }
     #
     # @!attribute [rw] resource_id
-    #   Specifies the ARN of the trail from which tags should be removed.
-    #   The format of a trail ARN is:
+    #   Specifies the ARN of the trail or event data store from which tags
+    #   should be removed.
     #
+    #   Example trail ARN format:
     #   `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
+    #
+    #   Example event data store ARN format:
+    #   `arn:aws:cloudtrail:us-east-2:12345678910:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
     #   @return [String]
     #
     # @!attribute [rw] tags_list
@@ -3131,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.47.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.47.0
+  version: 1.50.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-24 00:00:00.000000000 Z
+date: 2022-09-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core