aws-sdk-cloudwatchlogs 1.74.0 → 1.76.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13943033023e378b5e79c7972c153e9a5a156c980044fab5ca57fcd4a9589002
-  data.tar.gz: 4be6b846386d9b1473b2a8c6b814613b9f3555b93e11e4a2040ed522f2058b09
+  metadata.gz: 3d0d35998ca54f9a04a515684b803b4a7b890de6f9bd8d19ea12c5ca4114abd3
+  data.tar.gz: 78c8699b98c8cb435696411e647ccd528226bc2983ee99806af1f541f2546a8e
 SHA512:
-  metadata.gz: 5df94f0b09408b74523378bb34a8099262b48c72fa5f5712c9ebafc36a5a1e7b79f12f8b8fd58337eb2c8e949f714f9e247c8c8b40bfabd9c3b98d1cb58a4aa6
-  data.tar.gz: 15ec806ce260c216c5323b18d0f8cf6f30609b158ce1159800e13c85617a5c6fc0613ba9d1de608ecde2b87dcd3d2bdcd5802a3879aa23866ea26bb2bef17127
+  metadata.gz: 7dfa1468403bcf30e534f03de7d6dc9025f3c8d36bc659f6d6d93a379f5695161fa823600020ed39883b53798ec57b9ed1d40e7952d0290fbf1e24b990c2f645
+  data.tar.gz: e7af85674f396f0bd7df7e982daf910e1844361cfe1f560e5f4b66328fe493e298281427a062c906ab51db6a3f0172065aca665fecf18382b7eea395e2f8e277

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.76.0 (2023-12-12)
+------------------
+
+* Feature - This release introduces the StartLiveTail API to tail ingested logs in near real time.
+
+1.75.0 (2023-11-28)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.74.0 (2023-11-27)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.74.0
+1.76.0

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

@@ -33,6 +33,7 @@ require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/sign.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
+require 'aws-sdk-core/plugins/event_stream_configuration.rb'
 
 Aws::Plugins::GlobalConfiguration.add_identifier(:cloudwatchlogs)
 
@@ -83,6 +84,7 @@ module Aws::CloudWatchLogs
     add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::Sign)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
+    add_plugin(Aws::Plugins::EventStreamConfiguration)
     add_plugin(Aws::CloudWatchLogs::Plugins::Endpoints)
 
     # @overload initialize(options)
@@ -216,10 +218,16 @@ module Aws::CloudWatchLogs
     #   @option options [Boolean] :endpoint_discovery (false)
     #     When set to `true`, endpoint discovery will be enabled for operations when available.
     #
+    #   @option options [Proc] :event_stream_handler
+    #     When an EventStream or Proc object is provided, it will be used as callback for each chunk of event stream response received along the way.
+    #
     #   @option options [Boolean] :ignore_configured_endpoint_urls
     #     Setting to true disables use of endpoint URLs provided via environment
     #     variables and the shared configuration file.
     #
+    #   @option options [Proc] :input_event_stream_handler
+    #     When an EventStream or Proc object is provided, it can be used for sending events for the event stream.
+    #
     #   @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
     #     The log formatter.
     #
@@ -236,6 +244,9 @@ module Aws::CloudWatchLogs
     #     setting this value to 5 will result in a request being retried up to
     #     4 times. Used in `standard` and `adaptive` retry modes.
     #
+    #   @option options [Proc] :output_event_stream_handler
+    #     When an EventStream or Proc object is provided, it will be used as callback for each chunk of event stream response received along the way.
+    #
     #   @option options [String] :profile ("default")
     #     Used when loading credentials from the shared credentials file
     #     at HOME/.aws/credentials.  When not specified, 'default' is used.
@@ -592,7 +603,7 @@ module Aws::CloudWatchLogs
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html
     # [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html
     # [3]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html
-    # [4]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationolicy.html
+    # [4]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html
     #
     # @option params [required, String] :delivery_source_name
     #   The name of the delivery source to use for this delivery.
@@ -777,8 +788,8 @@ module Aws::CloudWatchLogs
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/mask-sensitive-log-data.html
     #
     # @option params [required, Array<String>] :log_group_arn_list
-    #   An array containing the ARNs of the log groups that this anomaly
-    #   detector will watch. You must specify at least one ARN.
+    #   An array containing the ARN of the log group that this anomaly
+    #   detector will watch. You can specify only one log group ARN.
     #
     # @option params [String] :detector_name
     #   A name for this anomaly detector.
@@ -939,6 +950,8 @@ module Aws::CloudWatchLogs
     #
     #   If you omit this parameter, the default of `STANDARD` is used.
     #
+    #   After a log group is created, its class can't be changed.
+    #
     #   For details about the features supported by each class, see [Log
     #   classes][1]
     #
@@ -2107,7 +2120,9 @@ module Aws::CloudWatchLogs
     end
 
     # This operation returns a paginated list of your saved CloudWatch Logs
-    # Insights query definitions.
+    # Insights query definitions. You can retrieve query definitions from
+    # the current account or from a source account that is linked to the
+    # current account.
     #
     # You can use the `queryDefinitionNamePrefix` parameter to limit the
     # results to only the query definitions that have names that start with
@@ -3532,7 +3547,7 @@ module Aws::CloudWatchLogs
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html
-    # [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationolicy.html
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html
     # [3]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html
     # [4]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html
     #
@@ -3703,7 +3718,7 @@ module Aws::CloudWatchLogs
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html
-    # [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationolicy.html
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html
     # [3]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html
     # [4]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html
     #
@@ -4398,6 +4413,284 @@ module Aws::CloudWatchLogs
       req.send_request(options)
     end
 
+    # Starts a Live Tail streaming session for one or more log groups. A
+    # Live Tail session returns a stream of log events that have been
+    # recently ingested in the log groups. For more information, see [Use
+    # Live Tail to view logs in near real time][1].
+    #
+    # The response to this operation is a response stream, over which the
+    # server sends live log events and the client receives them.
+    #
+    # The following objects are sent over the stream:
+    #
+    # * A single [LiveTailSessionStart][2] object is sent at the start of
+    #   the session.
+    #
+    # * Every second, a [LiveTailSessionUpdate][3] object is sent. Each of
+    #   these objects contains an array of the actual log events.
+    #
+    #   If no new log events were ingested in the past second, the
+    #   `LiveTailSessionUpdate` object will contain an empty array.
+    #
+    #   The array of log events contained in a `LiveTailSessionUpdate` can
+    #   include as many as 500 log events. If the number of log events
+    #   matching the request exceeds 500 per second, the log events are
+    #   sampled down to 500 log events to be included in each
+    #   `LiveTailSessionUpdate` object.
+    #
+    #   If your client consumes the log events slower than the server
+    #   produces them, CloudWatch Logs buffers up to 10
+    #   `LiveTailSessionUpdate` events or 5000 log events, after which it
+    #   starts dropping the oldest events.
+    #
+    # * A [SessionStreamingException][4] object is returned if an unknown
+    #   error occurs on the server side.
+    #
+    # * A [SessionTimeoutException][5] object is returned when the session
+    #   times out, after it has been kept open for three hours.
+    #
+    # You can end a session before it times out by closing the session
+    # stream or by closing the client that is receiving the stream. The
+    # session also ends if the established connection between the client and
+    # the server breaks.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs_LiveTail.html
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_LiveTailSessionStart.html
+    # [3]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_LiveTailSessionUpdate.html
+    # [4]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_SessionStreamingException.html
+    # [5]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_SessionTimeoutException.html
+    #
+    # @option params [required, Array<String>] :log_group_identifiers
+    #   An array where each item in the array is a log group to include in the
+    #   Live Tail session.
+    #
+    #   Specify each log group by its ARN.
+    #
+    #   If you specify an ARN, the ARN can't end with an asterisk (*).
+    #
+    #   <note markdown="1"> You can include up to 10 log groups.
+    #
+    #    </note>
+    #
+    # @option params [Array<String>] :log_stream_names
+    #   If you specify this parameter, then only log events in the log streams
+    #   that you specify here are included in the Live Tail session.
+    #
+    #   <note markdown="1"> You can specify this parameter only if you specify only one log group
+    #   in `logGroupIdentifiers`.
+    #
+    #    </note>
+    #
+    # @option params [Array<String>] :log_stream_name_prefixes
+    #   If you specify this parameter, then only log events in the log streams
+    #   that have names that start with the prefixes that you specify here are
+    #   included in the Live Tail session.
+    #
+    #   <note markdown="1"> You can specify this parameter only if you specify only one log group
+    #   in `logGroupIdentifiers`.
+    #
+    #    </note>
+    #
+    # @option params [String] :log_event_filter_pattern
+    #   An optional pattern to use to filter the results to include only log
+    #   events that match the pattern. For example, a filter pattern of `error
+    #   404` causes only log events that include both `error` and `404` to be
+    #   included in the Live Tail stream.
+    #
+    #   Regular expression filter patterns are supported.
+    #
+    #   For more information about filter pattern syntax, see [Filter and
+    #   Pattern Syntax][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html
+    #
+    # @return [Types::StartLiveTailResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartLiveTailResponse#response_stream #response_stream} => Types::StartLiveTailResponseStream
+    #
+    # @example EventStream Operation Example
+    #
+    #   You can process event once it arrives immediately, or wait until
+    #   full response complete and iterate through eventstream enumerator.
+    #
+    #   To interact with event immediately, you need to register #start_live_tail
+    #   with callbacks, callbacks can be register for specifc events or for all events,
+    #   callback for errors in the event stream is also available for register.
+    #
+    #   Callbacks can be passed in by `:event_stream_handler` option or within block
+    #   statement attached to #start_live_tail call directly. Hybrid pattern of both
+    #   is also supported.
+    #
+    #   `:event_stream_handler` option takes in either Proc object or
+    #   Aws::CloudWatchLogs::EventStreams::StartLiveTailResponseStream object.
+    #
+    #   Usage pattern a): callbacks with a block attached to #start_live_tail
+    #     Example for registering callbacks for all event types and error event
+    #
+    #     client.start_live_tail( # params input# ) do |stream|
+    #       stream.on_error_event do |event|
+    #         # catch unmodeled error event in the stream
+    #         raise event
+    #         # => Aws::Errors::EventError
+    #         # event.event_type => :error
+    #         # event.error_code => String
+    #         # event.error_message => String
+    #       end
+    #
+    #       stream.on_event do |event|
+    #         # process all events arrive
+    #         puts event.event_type
+    #         ...
+    #       end
+    #
+    #     end
+    #
+    #   Usage pattern b): pass in `:event_stream_handler` for #start_live_tail
+    #
+    #     1) create a Aws::CloudWatchLogs::EventStreams::StartLiveTailResponseStream object
+    #     Example for registering callbacks with specific events
+    #
+    #       handler = Aws::CloudWatchLogs::EventStreams::StartLiveTailResponseStream.new
+    #       handler.on_session_start_event do |event|
+    #         event # => Aws::CloudWatchLogs::Types::sessionStart
+    #       end
+    #       handler.on_session_update_event do |event|
+    #         event # => Aws::CloudWatchLogs::Types::sessionUpdate
+    #       end
+    #       handler.on_session_timeout_exception_event do |event|
+    #         event # => Aws::CloudWatchLogs::Types::SessionTimeoutException
+    #       end
+    #       handler.on_session_streaming_exception_event do |event|
+    #         event # => Aws::CloudWatchLogs::Types::SessionStreamingException
+    #       end
+    #
+    #     client.start_live_tail( # params input #, event_stream_handler: handler)
+    #
+    #     2) use a Ruby Proc object
+    #     Example for registering callbacks with specific events
+    #
+    #     handler = Proc.new do |stream|
+    #       stream.on_session_start_event do |event|
+    #         event # => Aws::CloudWatchLogs::Types::sessionStart
+    #       end
+    #       stream.on_session_update_event do |event|
+    #         event # => Aws::CloudWatchLogs::Types::sessionUpdate
+    #       end
+    #       stream.on_session_timeout_exception_event do |event|
+    #         event # => Aws::CloudWatchLogs::Types::SessionTimeoutException
+    #       end
+    #       stream.on_session_streaming_exception_event do |event|
+    #         event # => Aws::CloudWatchLogs::Types::SessionStreamingException
+    #       end
+    #     end
+    #
+    #     client.start_live_tail( # params input #, event_stream_handler: handler)
+    #
+    #   Usage pattern c): hybird pattern of a) and b)
+    #
+    #       handler = Aws::CloudWatchLogs::EventStreams::StartLiveTailResponseStream.new
+    #       handler.on_session_start_event do |event|
+    #         event # => Aws::CloudWatchLogs::Types::sessionStart
+    #       end
+    #       handler.on_session_update_event do |event|
+    #         event # => Aws::CloudWatchLogs::Types::sessionUpdate
+    #       end
+    #       handler.on_session_timeout_exception_event do |event|
+    #         event # => Aws::CloudWatchLogs::Types::SessionTimeoutException
+    #       end
+    #       handler.on_session_streaming_exception_event do |event|
+    #         event # => Aws::CloudWatchLogs::Types::SessionStreamingException
+    #       end
+    #
+    #     client.start_live_tail( # params input #, event_stream_handler: handler) do |stream|
+    #       stream.on_error_event do |event|
+    #         # catch unmodeled error event in the stream
+    #         raise event
+    #         # => Aws::Errors::EventError
+    #         # event.event_type => :error
+    #         # event.error_code => String
+    #         # event.error_message => String
+    #       end
+    #     end
+    #
+    #   Besides above usage patterns for process events when they arrive immediately, you can also
+    #   iterate through events after response complete.
+    #
+    #   Events are available at resp.response_stream # => Enumerator
+    #   For parameter input example, please refer to following request syntax
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_live_tail({
+    #     log_group_identifiers: ["LogGroupIdentifier"], # required
+    #     log_stream_names: ["LogStreamName"],
+    #     log_stream_name_prefixes: ["LogStreamName"],
+    #     log_event_filter_pattern: "FilterPattern",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   All events are available at resp.response_stream:
+    #   resp.response_stream #=> Enumerator
+    #   resp.response_stream.event_types #=> [:session_start, :session_update, :session_timeout_exception, :session_streaming_exception]
+    #
+    #   For :session_start event available at #on_session_start_event callback and response eventstream enumerator:
+    #   event.request_id #=> String
+    #   event.session_id #=> String
+    #   event.log_group_identifiers #=> Array
+    #   event.log_group_identifiers[0] #=> String
+    #   event.log_stream_names #=> Array
+    #   event.log_stream_names[0] #=> String
+    #   event.log_stream_name_prefixes #=> Array
+    #   event.log_stream_name_prefixes[0] #=> String
+    #   event.log_event_filter_pattern #=> String
+    #
+    #   For :session_update event available at #on_session_update_event callback and response eventstream enumerator:
+    #   event.session_metadata.sampled #=> Boolean
+    #   event.session_results #=> Array
+    #   event.session_results[0].log_stream_name #=> String
+    #   event.session_results[0].log_group_identifier #=> String
+    #   event.session_results[0].message #=> String
+    #   event.session_results[0].timestamp #=> Integer
+    #   event.session_results[0].ingestion_time #=> Integer
+    #
+    #   For :session_timeout_exception event available at #on_session_timeout_exception_event callback and response eventstream enumerator:
+    #   event.message #=> String
+    #
+    #   For :session_streaming_exception event available at #on_session_streaming_exception_event callback and response eventstream enumerator:
+    #   event.message #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/StartLiveTail AWS API Documentation
+    #
+    # @overload start_live_tail(params = {})
+    # @param [Hash] params ({})
+    def start_live_tail(params = {}, options = {})
+      params = params.dup
+      event_stream_handler = case handler = params.delete(:event_stream_handler)
+        when EventStreams::StartLiveTailResponseStream then handler
+        when Proc then EventStreams::StartLiveTailResponseStream.new.tap(&handler)
+        when nil then EventStreams::StartLiveTailResponseStream.new
+        else
+          msg = "expected :event_stream_handler to be a block or "\
+                "instance of Aws::CloudWatchLogs::EventStreams::StartLiveTailResponseStream"\
+                ", got `#{handler.inspect}` instead"
+          raise ArgumentError, msg
+        end
+
+      yield(event_stream_handler) if block_given?
+
+      req = build_request(:start_live_tail, params)
+
+      req.context[:event_stream_handler] = event_stream_handler
+      req.handlers.add(Aws::Binary::DecodeHandler, priority: 95)
+
+      req.send_request(options)
+    end
+
     # Schedules a query of a log group using CloudWatch Logs Insights. You
     # specify the log group and time range to query and the query string to
     # use.
@@ -4912,7 +5205,7 @@ module Aws::CloudWatchLogs
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatchlogs'
-      context[:gem_version] = '1.74.0'
+      context[:gem_version] = '1.76.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -178,6 +178,7 @@ module Aws::CloudWatchLogs
     InvalidOperationException = Shapes::StructureShape.new(name: 'InvalidOperationException')
     InvalidParameterException = Shapes::StructureShape.new(name: 'InvalidParameterException')
     InvalidSequenceTokenException = Shapes::StructureShape.new(name: 'InvalidSequenceTokenException')
+    IsSampled = Shapes::BooleanShape.new(name: 'IsSampled')
     KmsKeyId = Shapes::StringShape.new(name: 'KmsKeyId')
     LimitExceededException = Shapes::StructureShape.new(name: 'LimitExceededException')
     ListAnomaliesLimit = Shapes::IntegerShape.new(name: 'ListAnomaliesLimit')
@@ -190,6 +191,11 @@ module Aws::CloudWatchLogs
     ListTagsForResourceResponse = Shapes::StructureShape.new(name: 'ListTagsForResourceResponse')
     ListTagsLogGroupRequest = Shapes::StructureShape.new(name: 'ListTagsLogGroupRequest')
     ListTagsLogGroupResponse = Shapes::StructureShape.new(name: 'ListTagsLogGroupResponse')
+    LiveTailSessionLogEvent = Shapes::StructureShape.new(name: 'LiveTailSessionLogEvent')
+    LiveTailSessionMetadata = Shapes::StructureShape.new(name: 'LiveTailSessionMetadata')
+    LiveTailSessionResults = Shapes::ListShape.new(name: 'LiveTailSessionResults')
+    LiveTailSessionStart = Shapes::StructureShape.new(name: 'LiveTailSessionStart')
+    LiveTailSessionUpdate = Shapes::StructureShape.new(name: 'LiveTailSessionUpdate')
     LogEvent = Shapes::StringShape.new(name: 'LogEvent')
     LogEventIndex = Shapes::IntegerShape.new(name: 'LogEventIndex')
     LogGroup = Shapes::StructureShape.new(name: 'LogGroup')
@@ -278,6 +284,7 @@ module Aws::CloudWatchLogs
     QueryStatus = Shapes::StringShape.new(name: 'QueryStatus')
     QueryString = Shapes::StringShape.new(name: 'QueryString')
     RejectedLogEventsInfo = Shapes::StructureShape.new(name: 'RejectedLogEventsInfo')
+    RequestId = Shapes::StringShape.new(name: 'RequestId')
     ResourceAlreadyExistsException = Shapes::StructureShape.new(name: 'ResourceAlreadyExistsException')
     ResourceArns = Shapes::ListShape.new(name: 'ResourceArns')
     ResourceIdentifier = Shapes::StringShape.new(name: 'ResourceIdentifier')
@@ -294,8 +301,15 @@ module Aws::CloudWatchLogs
     Service = Shapes::StringShape.new(name: 'Service')
     ServiceQuotaExceededException = Shapes::StructureShape.new(name: 'ServiceQuotaExceededException')
     ServiceUnavailableException = Shapes::StructureShape.new(name: 'ServiceUnavailableException')
+    SessionId = Shapes::StringShape.new(name: 'SessionId')
+    SessionStreamingException = Shapes::StructureShape.new(name: 'SessionStreamingException')
+    SessionTimeoutException = Shapes::StructureShape.new(name: 'SessionTimeoutException')
     StandardUnit = Shapes::StringShape.new(name: 'StandardUnit')
     StartFromHead = Shapes::BooleanShape.new(name: 'StartFromHead')
+    StartLiveTailLogGroupIdentifiers = Shapes::ListShape.new(name: 'StartLiveTailLogGroupIdentifiers')
+    StartLiveTailRequest = Shapes::StructureShape.new(name: 'StartLiveTailRequest')
+    StartLiveTailResponse = Shapes::StructureShape.new(name: 'StartLiveTailResponse')
+    StartLiveTailResponseStream = Shapes::StructureShape.new(name: 'StartLiveTailResponseStream')
     StartQueryRequest = Shapes::StructureShape.new(name: 'StartQueryRequest')
     StartQueryResponse = Shapes::StructureShape.new(name: 'StartQueryResponse')
     State = Shapes::StringShape.new(name: 'State')
@@ -864,6 +878,30 @@ module Aws::CloudWatchLogs
     ListTagsLogGroupResponse.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "tags"))
     ListTagsLogGroupResponse.struct_class = Types::ListTagsLogGroupResponse
 
+    LiveTailSessionLogEvent.add_member(:log_stream_name, Shapes::ShapeRef.new(shape: LogStreamName, location_name: "logStreamName"))
+    LiveTailSessionLogEvent.add_member(:log_group_identifier, Shapes::ShapeRef.new(shape: LogGroupIdentifier, location_name: "logGroupIdentifier"))
+    LiveTailSessionLogEvent.add_member(:message, Shapes::ShapeRef.new(shape: EventMessage, location_name: "message"))
+    LiveTailSessionLogEvent.add_member(:timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "timestamp"))
+    LiveTailSessionLogEvent.add_member(:ingestion_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "ingestionTime"))
+    LiveTailSessionLogEvent.struct_class = Types::LiveTailSessionLogEvent
+
+    LiveTailSessionMetadata.add_member(:sampled, Shapes::ShapeRef.new(shape: IsSampled, location_name: "sampled"))
+    LiveTailSessionMetadata.struct_class = Types::LiveTailSessionMetadata
+
+    LiveTailSessionResults.member = Shapes::ShapeRef.new(shape: LiveTailSessionLogEvent)
+
+    LiveTailSessionStart.add_member(:request_id, Shapes::ShapeRef.new(shape: RequestId, location_name: "requestId"))
+    LiveTailSessionStart.add_member(:session_id, Shapes::ShapeRef.new(shape: SessionId, location_name: "sessionId"))
+    LiveTailSessionStart.add_member(:log_group_identifiers, Shapes::ShapeRef.new(shape: StartLiveTailLogGroupIdentifiers, location_name: "logGroupIdentifiers"))
+    LiveTailSessionStart.add_member(:log_stream_names, Shapes::ShapeRef.new(shape: InputLogStreamNames, location_name: "logStreamNames"))
+    LiveTailSessionStart.add_member(:log_stream_name_prefixes, Shapes::ShapeRef.new(shape: InputLogStreamNames, location_name: "logStreamNamePrefixes"))
+    LiveTailSessionStart.add_member(:log_event_filter_pattern, Shapes::ShapeRef.new(shape: FilterPattern, location_name: "logEventFilterPattern"))
+    LiveTailSessionStart.struct_class = Types::LiveTailSessionStart
+
+    LiveTailSessionUpdate.add_member(:session_metadata, Shapes::ShapeRef.new(shape: LiveTailSessionMetadata, location_name: "sessionMetadata"))
+    LiveTailSessionUpdate.add_member(:session_results, Shapes::ShapeRef.new(shape: LiveTailSessionResults, location_name: "sessionResults"))
+    LiveTailSessionUpdate.struct_class = Types::LiveTailSessionUpdate
+
     LogGroup.add_member(:log_group_name, Shapes::ShapeRef.new(shape: LogGroupName, location_name: "logGroupName"))
     LogGroup.add_member(:creation_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "creationTime"))
     LogGroup.add_member(:retention_in_days, Shapes::ShapeRef.new(shape: Days, location_name: "retentionInDays"))
@@ -1125,6 +1163,29 @@ module Aws::CloudWatchLogs
 
     ServiceUnavailableException.struct_class = Types::ServiceUnavailableException
 
+    SessionStreamingException.add_member(:message, Shapes::ShapeRef.new(shape: Message, location_name: "message"))
+    SessionStreamingException.struct_class = Types::SessionStreamingException
+
+    SessionTimeoutException.add_member(:message, Shapes::ShapeRef.new(shape: Message, location_name: "message"))
+    SessionTimeoutException.struct_class = Types::SessionTimeoutException
+
+    StartLiveTailLogGroupIdentifiers.member = Shapes::ShapeRef.new(shape: LogGroupIdentifier)
+
+    StartLiveTailRequest.add_member(:log_group_identifiers, Shapes::ShapeRef.new(shape: StartLiveTailLogGroupIdentifiers, required: true, location_name: "logGroupIdentifiers"))
+    StartLiveTailRequest.add_member(:log_stream_names, Shapes::ShapeRef.new(shape: InputLogStreamNames, location_name: "logStreamNames"))
+    StartLiveTailRequest.add_member(:log_stream_name_prefixes, Shapes::ShapeRef.new(shape: InputLogStreamNames, location_name: "logStreamNamePrefixes"))
+    StartLiveTailRequest.add_member(:log_event_filter_pattern, Shapes::ShapeRef.new(shape: FilterPattern, location_name: "logEventFilterPattern"))
+    StartLiveTailRequest.struct_class = Types::StartLiveTailRequest
+
+    StartLiveTailResponse.add_member(:response_stream, Shapes::ShapeRef.new(shape: StartLiveTailResponseStream, eventstream: true, location_name: "responseStream"))
+    StartLiveTailResponse.struct_class = Types::StartLiveTailResponse
+
+    StartLiveTailResponseStream.add_member(:session_start, Shapes::ShapeRef.new(shape: LiveTailSessionStart, event: true, location_name: "sessionStart"))
+    StartLiveTailResponseStream.add_member(:session_update, Shapes::ShapeRef.new(shape: LiveTailSessionUpdate, event: true, location_name: "sessionUpdate"))
+    StartLiveTailResponseStream.add_member(:session_timeout_exception, Shapes::ShapeRef.new(shape: SessionTimeoutException, location_name: "SessionTimeoutException"))
+    StartLiveTailResponseStream.add_member(:session_streaming_exception, Shapes::ShapeRef.new(shape: SessionStreamingException, location_name: "SessionStreamingException"))
+    StartLiveTailResponseStream.struct_class = Types::StartLiveTailResponseStream
+
     StartQueryRequest.add_member(:log_group_name, Shapes::ShapeRef.new(shape: LogGroupName, location_name: "logGroupName"))
     StartQueryRequest.add_member(:log_group_names, Shapes::ShapeRef.new(shape: LogGroupNames, location_name: "logGroupNames"))
     StartQueryRequest.add_member(:log_group_identifiers, Shapes::ShapeRef.new(shape: LogGroupIdentifiers, location_name: "logGroupIdentifiers"))
@@ -2072,6 +2133,22 @@ module Aws::CloudWatchLogs
         o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
       end)
 
+      api.add_operation(:start_live_tail, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "StartLiveTail"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.endpoint_pattern = {
+          "hostPrefix" => "streaming-",
+        }
+        o.input = Shapes::ShapeRef.new(shape: StartLiveTailRequest)
+        o.output = Shapes::ShapeRef.new(shape: StartLiveTailResponse)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidOperationException)
+      end)
+
       api.add_operation(:start_query, Seahorse::Model::Operation.new.tap do |o|
         o.name = "StartQuery"
         o.http_method = "POST"

data/lib/aws-sdk-cloudwatchlogs/endpoints.rb

@@ -908,6 +908,20 @@ module Aws::CloudWatchLogs
       end
     end
 
+    class StartLiveTail
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::CloudWatchLogs::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class StartQuery
       def self.build(context)
         unless context.config.regional_endpoint

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

@@ -40,6 +40,8 @@ module Aws::CloudWatchLogs
   # * {ResourceNotFoundException}
   # * {ServiceQuotaExceededException}
   # * {ServiceUnavailableException}
+  # * {SessionStreamingException}
+  # * {SessionTimeoutException}
   # * {ThrottlingException}
   # * {TooManyTagsException}
   # * {UnrecognizedClientException}
@@ -196,6 +198,36 @@ module Aws::CloudWatchLogs
       end
     end
 
+    class SessionStreamingException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::CloudWatchLogs::Types::SessionStreamingException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
+    class SessionTimeoutException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::CloudWatchLogs::Types::SessionTimeoutException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
     class ThrottlingException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

data/lib/aws-sdk-cloudwatchlogs/event_streams.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing guide for more information:
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+module Aws::CloudWatchLogs
+  module EventStreams
+    class StartLiveTailResponseStream
+
+      def initialize
+        @event_emitter = Aws::EventEmitter.new
+      end
+
+      def on_session_start_event(&block)
+        @event_emitter.on(:session_start, block) if block_given?
+      end
+
+      def on_session_update_event(&block)
+        @event_emitter.on(:session_update, block) if block_given?
+      end
+
+      def on_session_timeout_exception_event(&block)
+        @event_emitter.on(:session_timeout_exception, block) if block_given?
+      end
+
+      def on_session_streaming_exception_event(&block)
+        @event_emitter.on(:session_streaming_exception, block) if block_given?
+      end
+
+      def on_error_event(&block)
+        @event_emitter.on(:error, block) if block_given?
+      end
+
+      def on_initial_response_event(&block)
+        @event_emitter.on(:initial_response, block) if block_given?
+      end
+
+      def on_unknown_event(&block)
+        @event_emitter.on(:unknown_event, block) if block_given?
+      end
+
+      def on_event(&block)
+        on_session_start_event(&block)
+        on_session_update_event(&block)
+        on_session_timeout_exception_event(&block)
+        on_session_streaming_exception_event(&block)
+        on_error_event(&block)
+        on_initial_response_event(&block)
+        on_unknown_event(&block)
+      end
+
+      # @api private
+      # @return Aws::EventEmitter
+      attr_reader :event_emitter
+
+    end
+
+  end
+end
+

data/lib/aws-sdk-cloudwatchlogs/plugins/endpoints.rb

@@ -25,16 +25,17 @@ module Aws::CloudWatchLogs
       # @api private
       class Handler < Seahorse::Client::Handler
         def call(context)
-          # If endpoint was discovered, do not resolve or apply the endpoint.
           unless context[:discovered_endpoint]
             params = parameters_for_operation(context)
             endpoint = context.config.endpoint_provider.resolve_endpoint(params)
 
             context.http_request.endpoint = endpoint.url
             apply_endpoint_headers(context, endpoint.headers)
+
+            context[:endpoint_params] = params
+            context[:endpoint_properties] = endpoint.properties
           end
 
-          context[:endpoint_params] = params
           context[:auth_scheme] =
             Aws::Endpoints.resolve_auth_scheme(context, endpoint)
 
@@ -184,6 +185,8 @@ module Aws::CloudWatchLogs
             Aws::CloudWatchLogs::Endpoints::PutRetentionPolicy.build(context)
           when :put_subscription_filter
             Aws::CloudWatchLogs::Endpoints::PutSubscriptionFilter.build(context)
+          when :start_live_tail
+            Aws::CloudWatchLogs::Endpoints::StartLiveTail.build(context)
           when :start_query
             Aws::CloudWatchLogs::Endpoints::StartQuery.build(context)
           when :stop_query

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

@@ -458,8 +458,8 @@ module Aws::CloudWatchLogs
     end
 
     # @!attribute [rw] log_group_arn_list
-    #   An array containing the ARNs of the log groups that this anomaly
-    #   detector will watch. You must specify at least one ARN.
+    #   An array containing the ARN of the log group that this anomaly
+    #   detector will watch. You can specify only one log group ARN.
     #   @return [Array<String>]
     #
     # @!attribute [rw] detector_name
@@ -589,6 +589,8 @@ module Aws::CloudWatchLogs
     #
     #   If you omit this parameter, the default of `STANDARD` is used.
     #
+    #   After a log group is created, its class can't be changed.
+    #
     #   For details about the features supported by each class, see [Log
     #   classes][1]
     #
@@ -969,7 +971,7 @@ module Aws::CloudWatchLogs
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html
-    # [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationolicy.html
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html
     # [3]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html
     #
     # @!attribute [rw] name
@@ -1069,7 +1071,7 @@ module Aws::CloudWatchLogs
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html
     # [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html
     # [3]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html
-    # [4]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationolicy.html
+    # [4]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html
     # [5]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html
     #
     # @!attribute [rw] name
@@ -2853,6 +2855,152 @@ module Aws::CloudWatchLogs
       include Aws::Structure
     end
 
+    # This object contains the information for one log event returned in a
+    # Live Tail stream.
+    #
+    # @!attribute [rw] log_stream_name
+    #   The name of the log stream that ingested this log event.
+    #   @return [String]
+    #
+    # @!attribute [rw] log_group_identifier
+    #   The name or ARN of the log group that ingested this log event.
+    #   @return [String]
+    #
+    # @!attribute [rw] message
+    #   The log event message text.
+    #   @return [String]
+    #
+    # @!attribute [rw] timestamp
+    #   The timestamp specifying when this log event was created.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] ingestion_time
+    #   The timestamp specifying when this log event was ingested into the
+    #   log group.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/LiveTailSessionLogEvent AWS API Documentation
+    #
+    class LiveTailSessionLogEvent < Struct.new(
+      :log_stream_name,
+      :log_group_identifier,
+      :message,
+      :timestamp,
+      :ingestion_time)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # This object contains the metadata for one `LiveTailSessionUpdate`
+    # structure. It indicates whether that update includes only a sample of
+    # 500 log events out of a larger number of ingested log events, or if it
+    # contains all of the matching log events ingested during that second of
+    # time.
+    #
+    # @!attribute [rw] sampled
+    #   If this is `true`, then more than 500 log events matched the request
+    #   for this update, and the `sessionResults` includes a sample of 500
+    #   of those events.
+    #
+    #   If this is `false`, then 500 or fewer log events matched the request
+    #   for this update, so no sampling was necessary. In this case, the
+    #   `sessionResults` array includes all log events that matched your
+    #   request during this time.
+    #   @return [Boolean]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/LiveTailSessionMetadata AWS API Documentation
+    #
+    class LiveTailSessionMetadata < Struct.new(
+      :sampled)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # This object contains information about this Live Tail session,
+    # including the log groups included and the log stream filters, if any.
+    #
+    # @!attribute [rw] request_id
+    #   The unique ID generated by CloudWatch Logs to identify this Live
+    #   Tail session request.
+    #   @return [String]
+    #
+    # @!attribute [rw] session_id
+    #   The unique ID generated by CloudWatch Logs to identify this Live
+    #   Tail session.
+    #   @return [String]
+    #
+    # @!attribute [rw] log_group_identifiers
+    #   An array of the names and ARNs of the log groups included in this
+    #   Live Tail session.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] log_stream_names
+    #   If your StartLiveTail operation request included a `logStreamNames`
+    #   parameter that filtered the session to only include certain log
+    #   streams, these streams are listed here.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] log_stream_name_prefixes
+    #   If your StartLiveTail operation request included a
+    #   `logStreamNamePrefixes` parameter that filtered the session to only
+    #   include log streams that have names that start with certain
+    #   prefixes, these prefixes are listed here.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] log_event_filter_pattern
+    #   An optional pattern to filter the results to include only log events
+    #   that match the pattern. For example, a filter pattern of `error 404`
+    #   displays only log events that include both `error` and `404`.
+    #
+    #   For more information about filter pattern syntax, see [Filter and
+    #   Pattern Syntax][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/LiveTailSessionStart AWS API Documentation
+    #
+    class LiveTailSessionStart < Struct.new(
+      :request_id,
+      :session_id,
+      :log_group_identifiers,
+      :log_stream_names,
+      :log_stream_name_prefixes,
+      :log_event_filter_pattern,
+      :event_type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # This object contains the log events and metadata for a Live Tail
+    # session.
+    #
+    # @!attribute [rw] session_metadata
+    #   This object contains the session metadata for a Live Tail session.
+    #   @return [Types::LiveTailSessionMetadata]
+    #
+    # @!attribute [rw] session_results
+    #   An array, where each member of the array includes the information
+    #   for one log event in the Live Tail session.
+    #
+    #   A `sessionResults` array can include as many as 500 log events. If
+    #   the number of log events matching the request exceeds 500 per
+    #   second, the log events are sampled down to 500 log events to be
+    #   included in each `sessionUpdate` structure.
+    #   @return [Array<Types::LiveTailSessionLogEvent>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/LiveTailSessionUpdate AWS API Documentation
+    #
+    class LiveTailSessionUpdate < Struct.new(
+      :session_metadata,
+      :session_results,
+      :event_type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Represents a log group.
     #
     # @!attribute [rw] log_group_name
@@ -4251,6 +4399,110 @@ module Aws::CloudWatchLogs
     #
     class ServiceUnavailableException < Aws::EmptyStructure; end
 
+    # his exception is returned if an unknown error occurs during a Live
+    # Tail session.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/SessionStreamingException AWS API Documentation
+    #
+    class SessionStreamingException < Struct.new(
+      :message,
+      :event_type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # This exception is returned in a Live Tail stream when the Live Tail
+    # session times out. Live Tail sessions time out after three hours.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/SessionTimeoutException AWS API Documentation
+    #
+    class SessionTimeoutException < Struct.new(
+      :message,
+      :event_type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] log_group_identifiers
+    #   An array where each item in the array is a log group to include in
+    #   the Live Tail session.
+    #
+    #   Specify each log group by its ARN.
+    #
+    #   If you specify an ARN, the ARN can't end with an asterisk (*).
+    #
+    #   <note markdown="1"> You can include up to 10 log groups.
+    #
+    #    </note>
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] log_stream_names
+    #   If you specify this parameter, then only log events in the log
+    #   streams that you specify here are included in the Live Tail session.
+    #
+    #   <note markdown="1"> You can specify this parameter only if you specify only one log
+    #   group in `logGroupIdentifiers`.
+    #
+    #    </note>
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] log_stream_name_prefixes
+    #   If you specify this parameter, then only log events in the log
+    #   streams that have names that start with the prefixes that you
+    #   specify here are included in the Live Tail session.
+    #
+    #   <note markdown="1"> You can specify this parameter only if you specify only one log
+    #   group in `logGroupIdentifiers`.
+    #
+    #    </note>
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] log_event_filter_pattern
+    #   An optional pattern to use to filter the results to include only log
+    #   events that match the pattern. For example, a filter pattern of
+    #   `error 404` causes only log events that include both `error` and
+    #   `404` to be included in the Live Tail stream.
+    #
+    #   Regular expression filter patterns are supported.
+    #
+    #   For more information about filter pattern syntax, see [Filter and
+    #   Pattern Syntax][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/StartLiveTailRequest AWS API Documentation
+    #
+    class StartLiveTailRequest < Struct.new(
+      :log_group_identifiers,
+      :log_stream_names,
+      :log_stream_name_prefixes,
+      :log_event_filter_pattern)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] response_stream
+    #   An object that includes the stream returned by your request. It can
+    #   include both log events and exceptions.
+    #   @return [Types::StartLiveTailResponseStream]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/StartLiveTailResponse AWS API Documentation
+    #
+    class StartLiveTailResponse < Struct.new(
+      :response_stream)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] log_group_name
     #   The log group on which to perform the query.
     #
@@ -4693,5 +4945,30 @@ module Aws::CloudWatchLogs
     #
     class ValidationException < Aws::EmptyStructure; end
 
+    # This object includes the stream returned by your [StartLiveTail][1]
+    # request.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartLiveTail.html
+    #
+    # EventStream is an Enumerator of Events.
+    #  #event_types #=> Array, returns all modeled event types in the stream
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/StartLiveTailResponseStream AWS API Documentation
+    #
+    class StartLiveTailResponseStream < Enumerator
+
+      def event_types
+        [
+          :session_start,
+          :session_update,
+          :session_timeout_exception,
+          :session_streaming_exception
+        ]
+      end
+
+    end
+
   end
 end

data/lib/aws-sdk-cloudwatchlogs.rb

@@ -21,6 +21,7 @@ require_relative 'aws-sdk-cloudwatchlogs/endpoint_parameters'
 require_relative 'aws-sdk-cloudwatchlogs/endpoint_provider'
 require_relative 'aws-sdk-cloudwatchlogs/endpoints'
 require_relative 'aws-sdk-cloudwatchlogs/customizations'
+require_relative 'aws-sdk-cloudwatchlogs/event_streams'
 
 # This module provides support for Amazon CloudWatch Logs. This module is available in the
 # `aws-sdk-cloudwatchlogs` gem.
@@ -52,6 +53,6 @@ require_relative 'aws-sdk-cloudwatchlogs/customizations'
 # @!group service
 module Aws::CloudWatchLogs
 
-  GEM_VERSION = '1.74.0'
+  GEM_VERSION = '1.76.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudwatchlogs
 version: !ruby/object:Gem::Version
-  version: 1.74.0
+  version: 1.76.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-11-27 00:00:00.000000000 Z
+date: 2023-12-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -63,6 +63,7 @@ files:
 - lib/aws-sdk-cloudwatchlogs/endpoint_provider.rb
 - lib/aws-sdk-cloudwatchlogs/endpoints.rb
 - lib/aws-sdk-cloudwatchlogs/errors.rb
+- lib/aws-sdk-cloudwatchlogs/event_streams.rb
 - lib/aws-sdk-cloudwatchlogs/plugins/endpoints.rb
 - lib/aws-sdk-cloudwatchlogs/resource.rb
 - lib/aws-sdk-cloudwatchlogs/types.rb