aws-sdk-cloudwatchlogs 1.24.0 → 1.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: dffe775c3803f9e17ead875a4ed54147e5cab656
-  data.tar.gz: e61b62997345c6148877c8e74348bcfa58481b84
+  metadata.gz: 6bcd07ac61a97e4a3d3a6aea0db33d2809834f71
+  data.tar.gz: e684e8ce3ad743085472768182f1d61edd5e1f70
 SHA512:
-  metadata.gz: df565021126cb2a620ce75bd07fd1c8777da4100a604534ccc009872214ab309b32ab501f261c2128be7b9107e8be496ee258df43060b518deb3945f9961805c
-  data.tar.gz: 896a8e54b9f11186a78af3456ae03b37fac09fa1a046931aadf319e4022d5691741228e3a18a0d488072552e68bde08a088b4be0b4218caad0428c20e23a0bc9
+  metadata.gz: 69796f87bda84d1a99cab9d2c48e23efa4543df02c908689d10141e9f4845ff1a3cb1393c62c01aacdd7222828ec7514a1fc86dadbfd9d1726e18952f5cd6f05
+  data.tar.gz: cc49ae2326d06d8eaac4ce44e73820541c749a2cf5ddd17b238623e5d83b20f64d9de9a7bd9ac4d9bdcf44a314d1abb4da78aa6a81d26ba01b8d647f718777ea

data/lib/aws-sdk-cloudwatchlogs.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-cloudwatchlogs/customizations'
 # @service
 module Aws::CloudWatchLogs
 
-  GEM_VERSION = '1.24.0'
+  GEM_VERSION = '1.25.0'
 
 end

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

@@ -351,6 +351,9 @@ module Aws::CloudWatchLogs
     # you can specify a prefix to be used as the Amazon S3 key prefix for
     # all exported objects.
     #
+    # Exporting to S3 buckets that are encrypted with AES-256 is supported.
+    # Exporting to S3 buckets encrypted with SSE-KMS is not supported.
+    #
     # @option params [String] :task_name
     #   The name of the export task.
     #
@@ -1308,6 +1311,9 @@ module Aws::CloudWatchLogs
     #   the value is false, the latest log events are returned first. The
     #   default value is false.
     #
+    #   If you are using `nextToken` in this operation, you must specify
+    #   `true` for `startFromHead`.
+    #
     # @return [Types::GetLogEventsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetLogEventsResponse#events #events} => Array<Types::OutputLogEvent>
@@ -1432,8 +1438,7 @@ module Aws::CloudWatchLogs
       req.send_request(options)
     end
 
-    # Returns the results from the specified query. If the query is in
-    # progress, partial results of that current execution are returned.
+    # Returns the results from the specified query.
     #
     # Only the fields requested in the query are returned, along with a
     # `@ptr` field which is the identifier for the log record. You can use
@@ -1442,6 +1447,11 @@ module Aws::CloudWatchLogs
     # `GetQueryResults` does not start a query execution. To run a query,
     # use .
     #
+    # If the value of the `Status` field in the output is `Running`, this
+    # operation returns only partial results. If you see a value of
+    # `Scheduled` or `Running` for the status, you can retry the operation
+    # later to see the final results.
+    #
     # @option params [required, String] :query_id
     #   The ID number of the query.
     #
@@ -1509,15 +1519,15 @@ module Aws::CloudWatchLogs
     # Creates or updates a destination. A destination encapsulates a
     # physical resource (such as an Amazon Kinesis stream) and enables you
     # to subscribe to a real-time stream of log events for a different
-    # account, ingested using PutLogEvents. Currently, the only supported
-    # physical resource is a Kinesis stream belonging to the same account as
-    # the destination.
+    # account, ingested using PutLogEvents. A destination can be an Amazon
+    # Kinesis stream, Amazon Kinesis Data Firehose strea, or an AWS Lambda
+    # function.
     #
     # Through an access policy, a destination controls what is written to
-    # its Kinesis stream. By default, `PutDestination` does not set any
-    # access policy with the destination, which means a cross-account user
-    # cannot call PutSubscriptionFilter against this destination. To enable
-    # this, the destination owner must call PutDestinationPolicy after
+    # it. By default, `PutDestination` does not set any access policy with
+    # the destination, which means a cross-account user cannot call
+    # PutSubscriptionFilter against this destination. To enable this, the
+    # destination owner must call PutDestinationPolicy after
     # `PutDestination`.
     #
     # @option params [required, String] :destination_name
@@ -1908,9 +1918,19 @@ module Aws::CloudWatchLogs
     #
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html
     #
-    # @option params [required, String] :log_group_name
+    # @option params [String] :log_group_name
     #   The log group on which to perform the query.
     #
+    #   A `StartQuery` operation must include a `logGroupNames` or a
+    #   `logGroupName` parameter, but not both.
+    #
+    # @option params [Array<String>] :log_group_names
+    #   The list of log groups to be queried. You can include up to 20 log
+    #   groups.
+    #
+    #   A `StartQuery` operation must include a `logGroupNames` or a
+    #   `logGroupName` parameter, but not both.
+    #
     # @option params [required, Integer] :start_time
     #   The beginning of the time range to query. The range is inclusive, so
     #   the specified start time is included in the query. Specified as epoch
@@ -1941,7 +1961,8 @@ module Aws::CloudWatchLogs
     # @example Request syntax with placeholder values
     #
     #   resp = client.start_query({
-    #     log_group_name: "LogGroupName", # required
+    #     log_group_name: "LogGroupName",
+    #     log_group_names: ["LogGroupName"],
     #     start_time: 1, # required
     #     end_time: 1, # required
     #     query_string: "QueryString", # required
@@ -2113,7 +2134,7 @@ module Aws::CloudWatchLogs
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatchlogs'
-      context[:gem_version] = '1.24.0'
+      context[:gem_version] = '1.25.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -101,6 +101,7 @@ module Aws::CloudWatchLogs
     LogGroupField = Shapes::StructureShape.new(name: 'LogGroupField')
     LogGroupFieldList = Shapes::ListShape.new(name: 'LogGroupFieldList')
     LogGroupName = Shapes::StringShape.new(name: 'LogGroupName')
+    LogGroupNames = Shapes::ListShape.new(name: 'LogGroupNames')
     LogGroups = Shapes::ListShape.new(name: 'LogGroups')
     LogRecord = Shapes::MapShape.new(name: 'LogRecord')
     LogRecordPointer = Shapes::StringShape.new(name: 'LogRecordPointer')
@@ -364,7 +365,7 @@ module Aws::CloudWatchLogs
     FilterLogEventsRequest.add_member(:filter_pattern, Shapes::ShapeRef.new(shape: FilterPattern, location_name: "filterPattern"))
     FilterLogEventsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
     FilterLogEventsRequest.add_member(:limit, Shapes::ShapeRef.new(shape: EventsLimit, location_name: "limit"))
-    FilterLogEventsRequest.add_member(:interleaved, Shapes::ShapeRef.new(shape: Interleaved, location_name: "interleaved"))
+    FilterLogEventsRequest.add_member(:interleaved, Shapes::ShapeRef.new(shape: Interleaved, deprecated: true, location_name: "interleaved", metadata: {"deprecatedMessage"=>"Starting on June 17, 2019, this parameter will be ignored and the value will be assumed to be true. The response from this operation will always interleave events from multiple log streams within a log group."}))
     FilterLogEventsRequest.struct_class = Types::FilterLogEventsRequest
 
     FilterLogEventsResponse.add_member(:events, Shapes::ShapeRef.new(shape: FilteredLogEvents, location_name: "events"))
@@ -448,6 +449,8 @@ module Aws::CloudWatchLogs
 
     LogGroupFieldList.member = Shapes::ShapeRef.new(shape: LogGroupField)
 
+    LogGroupNames.member = Shapes::ShapeRef.new(shape: LogGroupName)
+
     LogGroups.member = Shapes::ShapeRef.new(shape: LogGroup)
 
     LogRecord.key = Shapes::ShapeRef.new(shape: Field)
@@ -460,7 +463,7 @@ module Aws::CloudWatchLogs
     LogStream.add_member(:last_ingestion_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "lastIngestionTime"))
     LogStream.add_member(:upload_sequence_token, Shapes::ShapeRef.new(shape: SequenceToken, location_name: "uploadSequenceToken"))
     LogStream.add_member(:arn, Shapes::ShapeRef.new(shape: Arn, location_name: "arn"))
-    LogStream.add_member(:stored_bytes, Shapes::ShapeRef.new(shape: StoredBytes, location_name: "storedBytes"))
+    LogStream.add_member(:stored_bytes, Shapes::ShapeRef.new(shape: StoredBytes, deprecated: true, location_name: "storedBytes", metadata: {"deprecatedMessage"=>"Starting on June 17, 2019, this parameter will be deprecated for log streams, and will be reported as zero. This change applies only to log streams. The storedBytes parameter for log groups is not affected."}))
     LogStream.struct_class = Types::LogStream
 
     LogStreams.member = Shapes::ShapeRef.new(shape: LogStream)
@@ -594,7 +597,8 @@ module Aws::CloudWatchLogs
 
     SearchedLogStreams.member = Shapes::ShapeRef.new(shape: SearchedLogStream)
 
-    StartQueryRequest.add_member(:log_group_name, Shapes::ShapeRef.new(shape: LogGroupName, required: true, location_name: "logGroupName"))
+    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(:start_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "startTime"))
     StartQueryRequest.add_member(:end_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "endTime"))
     StartQueryRequest.add_member(:query_string, Shapes::ShapeRef.new(shape: QueryString, required: true, location_name: "queryString"))

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

@@ -1175,6 +1175,9 @@ module Aws::CloudWatchLogs
     #   If the value is true, the earliest log events are returned first. If
     #   the value is false, the latest log events are returned first. The
     #   default value is false.
+    #
+    #   If you are using `nextToken` in this operation, you must specify
+    #   `true` for `startFromHead`.
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/GetLogEventsRequest AWS API Documentation
@@ -2196,7 +2199,8 @@ module Aws::CloudWatchLogs
     #   data as a hash:
     #
     #       {
-    #         log_group_name: "LogGroupName", # required
+    #         log_group_name: "LogGroupName",
+    #         log_group_names: ["LogGroupName"],
     #         start_time: 1, # required
     #         end_time: 1, # required
     #         query_string: "QueryString", # required
@@ -2205,8 +2209,19 @@ module Aws::CloudWatchLogs
     #
     # @!attribute [rw] log_group_name
     #   The log group on which to perform the query.
+    #
+    #   A `StartQuery` operation must include a `logGroupNames` or a
+    #   `logGroupName` parameter, but not both.
     #   @return [String]
     #
+    # @!attribute [rw] log_group_names
+    #   The list of log groups to be queried. You can include up to 20 log
+    #   groups.
+    #
+    #   A `StartQuery` operation must include a `logGroupNames` or a
+    #   `logGroupName` parameter, but not both.
+    #   @return [Array<String>]
+    #
     # @!attribute [rw] start_time
     #   The beginning of the time range to query. The range is inclusive, so
     #   the specified start time is included in the query. Specified as
@@ -2239,6 +2254,7 @@ module Aws::CloudWatchLogs
     #
     class StartQueryRequest < Struct.new(
       :log_group_name,
+      :log_group_names,
       :start_time,
       :end_time,
       :query_string,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudwatchlogs
 version: !ruby/object:Gem::Version
-  version: 1.24.0
+  version: 1.25.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-25 00:00:00.000000000 Z
+date: 2019-07-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core