aws-sdk-cloudwatchlogs 1.59.0 → 1.60.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 49f0c4a3d43626e0a933285c40bdb54ea7e3603865c42d2d5deda1ca093ab4c6
-  data.tar.gz: 57666b4c102356595f67702175c26fcc866fc37aead83ec5d5635cc59898de73
+  metadata.gz: 341bed9e6e853a58919d069b60c8b1413f1a7666e0762854bbd785b737854924
+  data.tar.gz: a1de67b3ce6a3edbca499540ce24062fc897149b4bfb57446057f8beaf2cbe0d
 SHA512:
-  metadata.gz: 55d23914b7c9daa000eb24013104edd1fce730f4685ef09963806f33709eb3e5de32f09c0a8e7f592c45e17e5bc5dfb04f267be0f4ea01ac197c852283aa0601
-  data.tar.gz: 21fd13627ec5731c651fad8a6d672546136b8bff9408dbf00ac1004308a867bfc00ba375352eb85087b5af52f8b4de04c25f734f1035102082405be131c1ddb9
+  metadata.gz: 906d9d57ddff2ebb8857bbacf59854aac40317c8ac219b6894bbc97529f2c749e02df8641db9c85a70a47a176121dbb506a6ccef3dc329f398e96641535c1029
+  data.tar.gz: 58f26fff52290987bc0be5631c86f13c042e6f07870ce0e2023ab0bdfa3561849128ecdb7ff344839552a37c74ecf9d1c7a866484a5670ec15464643404ac937

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.60.0 (2023-01-12)
+------------------
+
+* Feature - Bug fix: logGroupName is now not a required field in GetLogEvents, FilterLogEvents, GetLogGroupFields, and DescribeLogStreams APIs as logGroupIdentifier can be provided instead
+
 1.59.0 (2023-01-04)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.59.0
+1.60.0

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

@@ -1146,6 +1146,10 @@ module Aws::CloudWatchLogs
     # the log streams or filter the results by prefix. You can also control
     # how the results are ordered.
     #
+    # You can specify the log group to search by using either
+    # `logGroupIdentifier` or `logGroupName`. You must include one of these
+    # two parameters, but you can't include both.
+    #
     # This operation has a limit of five transactions per second, after
     # which transactions are throttled.
     #
@@ -1158,7 +1162,7 @@ module Aws::CloudWatchLogs
     #
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
     #
-    # @option params [required, String] :log_group_name
+    # @option params [String] :log_group_name
     #   The name of the log group.
     #
     #   <note markdown="1"> If you specify values for both `logGroupName` and
@@ -1172,10 +1176,12 @@ module Aws::CloudWatchLogs
     #   group is in a source account and you are using a monitoring account,
     #   you must use the log group ARN.
     #
-    #   If you specify values for both `logGroupName` and
+    #   <note markdown="1"> If you specify values for both `logGroupName` and
     #   `logGroupIdentifier`, the action returns an
     #   `InvalidParameterException` error.
     #
+    #    </note>
+    #
     # @option params [String] :log_stream_name_prefix
     #   The prefix to match.
     #
@@ -1219,7 +1225,7 @@ module Aws::CloudWatchLogs
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_log_streams({
-    #     log_group_name: "LogGroupName", # required
+    #     log_group_name: "LogGroupName",
     #     log_group_identifier: "LogGroupIdentifier",
     #     log_stream_name_prefix: "LogStreamName",
     #     order_by: "LogStreamName", # accepts LogStreamName, LastEventTime
@@ -1560,6 +1566,10 @@ module Aws::CloudWatchLogs
     # You must have the `logs;FilterLogEvents` permission to perform this
     # operation.
     #
+    # You can specify the log group to search by using either
+    # `logGroupIdentifier` or `logGroupName`. You must include one of these
+    # two parameters, but you can't include both.
+    #
     # By default, this operation returns as many log events as can fit in 1
     # MB (up to 10,000 log events) or all the events found within the
     # specified time range. If the results include a token, that means there
@@ -1581,7 +1591,7 @@ module Aws::CloudWatchLogs
     #
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
     #
-    # @option params [required, String] :log_group_name
+    # @option params [String] :log_group_name
     #   The name of the log group to search.
     #
     #   <note markdown="1"> If you specify values for both `logGroupName` and
@@ -1595,10 +1605,12 @@ module Aws::CloudWatchLogs
     #   from. If the log group is in a source account and you are using a
     #   monitoring account, you must use the log group ARN.
     #
-    #   If you specify values for both `logGroupName` and
+    #   <note markdown="1"> If you specify values for both `logGroupName` and
     #   `logGroupIdentifier`, the action returns an
     #   `InvalidParameterException` error.
     #
+    #    </note>
+    #
     # @option params [Array<String>] :log_stream_names
     #   Filters the results to only logs from the log streams in this list.
     #
@@ -1671,7 +1683,7 @@ module Aws::CloudWatchLogs
     # @example Request syntax with placeholder values
     #
     #   resp = client.filter_log_events({
-    #     log_group_name: "LogGroupName", # required
+    #     log_group_name: "LogGroupName",
     #     log_group_identifier: "LogGroupIdentifier",
     #     log_stream_names: ["LogStreamName"],
     #     log_stream_name_prefix: "LogStreamName",
@@ -1753,11 +1765,15 @@ module Aws::CloudWatchLogs
     # source accounts. For more information, see [CloudWatch cross-account
     # observability][1].
     #
+    # You can specify the log group to search by using either
+    # `logGroupIdentifier` or `logGroupName`. You must include one of these
+    # two parameters, but you can't include both.
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
     #
-    # @option params [required, String] :log_group_name
+    # @option params [String] :log_group_name
     #   The name of the log group.
     #
     #   <note markdown="1"> If you specify values for both `logGroupName` and
@@ -1771,10 +1787,12 @@ module Aws::CloudWatchLogs
     #   If the log group is in a source account and you are using a monitoring
     #   account, you must use the log group ARN.
     #
-    #   If you specify values for both `logGroupName` and
+    #   <note markdown="1"> If you specify values for both `logGroupName` and
     #   `logGroupIdentifier`, the action returns an
     #   `InvalidParameterException` error.
     #
+    #    </note>
+    #
     # @option params [required, String] :log_stream_name
     #   The name of the log stream.
     #
@@ -1825,7 +1843,7 @@ module Aws::CloudWatchLogs
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_log_events({
-    #     log_group_name: "LogGroupName", # required
+    #     log_group_name: "LogGroupName",
     #     log_group_identifier: "LogGroupIdentifier",
     #     log_stream_name: "LogStreamName", # required
     #     start_time: 1,
@@ -1859,6 +1877,10 @@ module Aws::CloudWatchLogs
     # contain each field. The search is limited to a time period that you
     # specify.
     #
+    # You can specify the log group to search by using either
+    # `logGroupIdentifier` or `logGroupName`. You must specify one of these
+    # parameters, but you can't specify both.
+    #
     # In the results, fields that start with `@` are fields generated by
     # CloudWatch Logs. For example, `@timestamp` is the timestamp of each
     # log event. For more information about the fields that are generated by
@@ -1877,13 +1899,15 @@ module Aws::CloudWatchLogs
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_AnalyzeLogData-discoverable-fields.html
     # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
     #
-    # @option params [required, String] :log_group_name
+    # @option params [String] :log_group_name
     #   The name of the log group to search.
     #
-    #   If you specify values for both `logGroupName` and
+    #   <note markdown="1"> If you specify values for both `logGroupName` and
     #   `logGroupIdentifier`, the action returns an
     #   `InvalidParameterException` error.
     #
+    #    </note>
+    #
     # @option params [Integer] :time
     #   The time to set as the center of the query. If you specify `time`, the
     #   15 minutes before this time are queries. If you omit `time`, the 8
@@ -1897,10 +1921,12 @@ module Aws::CloudWatchLogs
     #   group is in a source account and you are using a monitoring account,
     #   you must specify the ARN.
     #
-    #   If you specify values for both `logGroupName` and
+    #   <note markdown="1"> If you specify values for both `logGroupName` and
     #   `logGroupIdentifier`, the action returns an
     #   `InvalidParameterException` error.
     #
+    #    </note>
+    #
     # @return [Types::GetLogGroupFieldsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetLogGroupFieldsResponse#log_group_fields #log_group_fields} => Array&lt;Types::LogGroupField&gt;
@@ -1908,7 +1934,7 @@ module Aws::CloudWatchLogs
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_log_group_fields({
-    #     log_group_name: "LogGroupName", # required
+    #     log_group_name: "LogGroupName",
     #     time: 1,
     #     log_group_identifier: "LogGroupIdentifier",
     #   })
@@ -3201,7 +3227,7 @@ module Aws::CloudWatchLogs
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatchlogs'
-      context[:gem_version] = '1.59.0'
+      context[:gem_version] = '1.60.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -321,7 +321,7 @@ module Aws::CloudWatchLogs
     DescribeLogGroupsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
     DescribeLogGroupsResponse.struct_class = Types::DescribeLogGroupsResponse
 
-    DescribeLogStreamsRequest.add_member(:log_group_name, Shapes::ShapeRef.new(shape: LogGroupName, required: true, location_name: "logGroupName"))
+    DescribeLogStreamsRequest.add_member(:log_group_name, Shapes::ShapeRef.new(shape: LogGroupName, location_name: "logGroupName"))
     DescribeLogStreamsRequest.add_member(:log_group_identifier, Shapes::ShapeRef.new(shape: LogGroupIdentifier, location_name: "logGroupIdentifier"))
     DescribeLogStreamsRequest.add_member(:log_stream_name_prefix, Shapes::ShapeRef.new(shape: LogStreamName, location_name: "logStreamNamePrefix"))
     DescribeLogStreamsRequest.add_member(:order_by, Shapes::ShapeRef.new(shape: OrderBy, location_name: "orderBy"))
@@ -423,7 +423,7 @@ module Aws::CloudWatchLogs
     ExtractedValues.key = Shapes::ShapeRef.new(shape: Token)
     ExtractedValues.value = Shapes::ShapeRef.new(shape: Value)
 
-    FilterLogEventsRequest.add_member(:log_group_name, Shapes::ShapeRef.new(shape: LogGroupName, required: true, location_name: "logGroupName"))
+    FilterLogEventsRequest.add_member(:log_group_name, Shapes::ShapeRef.new(shape: LogGroupName, location_name: "logGroupName"))
     FilterLogEventsRequest.add_member(:log_group_identifier, Shapes::ShapeRef.new(shape: LogGroupIdentifier, location_name: "logGroupIdentifier"))
     FilterLogEventsRequest.add_member(:log_stream_names, Shapes::ShapeRef.new(shape: InputLogStreamNames, location_name: "logStreamNames"))
     FilterLogEventsRequest.add_member(:log_stream_name_prefix, Shapes::ShapeRef.new(shape: LogStreamName, location_name: "logStreamNamePrefix"))
@@ -458,7 +458,7 @@ module Aws::CloudWatchLogs
     GetDataProtectionPolicyResponse.add_member(:last_updated_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "lastUpdatedTime"))
     GetDataProtectionPolicyResponse.struct_class = Types::GetDataProtectionPolicyResponse
 
-    GetLogEventsRequest.add_member(:log_group_name, Shapes::ShapeRef.new(shape: LogGroupName, required: true, location_name: "logGroupName"))
+    GetLogEventsRequest.add_member(:log_group_name, Shapes::ShapeRef.new(shape: LogGroupName, location_name: "logGroupName"))
     GetLogEventsRequest.add_member(:log_group_identifier, Shapes::ShapeRef.new(shape: LogGroupIdentifier, location_name: "logGroupIdentifier"))
     GetLogEventsRequest.add_member(:log_stream_name, Shapes::ShapeRef.new(shape: LogStreamName, required: true, location_name: "logStreamName"))
     GetLogEventsRequest.add_member(:start_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "startTime"))
@@ -474,7 +474,7 @@ module Aws::CloudWatchLogs
     GetLogEventsResponse.add_member(:next_backward_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextBackwardToken"))
     GetLogEventsResponse.struct_class = Types::GetLogEventsResponse
 
-    GetLogGroupFieldsRequest.add_member(:log_group_name, Shapes::ShapeRef.new(shape: LogGroupName, required: true, location_name: "logGroupName"))
+    GetLogGroupFieldsRequest.add_member(:log_group_name, Shapes::ShapeRef.new(shape: LogGroupName, location_name: "logGroupName"))
     GetLogGroupFieldsRequest.add_member(:time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "time"))
     GetLogGroupFieldsRequest.add_member(:log_group_identifier, Shapes::ShapeRef.new(shape: LogGroupIdentifier, location_name: "logGroupIdentifier"))
     GetLogGroupFieldsRequest.struct_class = Types::GetLogGroupFieldsRequest

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

@@ -525,9 +525,11 @@ module Aws::CloudWatchLogs
     #   group is in a source account and you are using a monitoring account,
     #   you must use the log group ARN.
     #
-    #   If you specify values for both `logGroupName` and
+    #   <note markdown="1"> If you specify values for both `logGroupName` and
     #   `logGroupIdentifier`, the action returns an
     #   `InvalidParameterException` error.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] log_stream_name_prefix
@@ -1010,9 +1012,11 @@ module Aws::CloudWatchLogs
     #   from. If the log group is in a source account and you are using a
     #   monitoring account, you must use the log group ARN.
     #
-    #   If you specify values for both `logGroupName` and
+    #   <note markdown="1"> If you specify values for both `logGroupName` and
     #   `logGroupIdentifier`, the action returns an
     #   `InvalidParameterException` error.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] log_stream_names
@@ -1217,9 +1221,11 @@ module Aws::CloudWatchLogs
     #   If the log group is in a source account and you are using a
     #   monitoring account, you must use the log group ARN.
     #
-    #   If you specify values for both `logGroupName` and
+    #   <note markdown="1"> If you specify values for both `logGroupName` and
     #   `logGroupIdentifier`, the action returns an
     #   `InvalidParameterException` error.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] log_stream_name
@@ -1314,9 +1320,11 @@ module Aws::CloudWatchLogs
     # @!attribute [rw] log_group_name
     #   The name of the log group to search.
     #
-    #   If you specify values for both `logGroupName` and
+    #   <note markdown="1"> If you specify values for both `logGroupName` and
     #   `logGroupIdentifier`, the action returns an
     #   `InvalidParameterException` error.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] time
@@ -1333,9 +1341,11 @@ module Aws::CloudWatchLogs
     #   group is in a source account and you are using a monitoring account,
     #   you must specify the ARN.
     #
-    #   If you specify values for both `logGroupName` and
+    #   <note markdown="1"> If you specify values for both `logGroupName` and
     #   `logGroupIdentifier`, the action returns an
     #   `InvalidParameterException` error.
+    #
+    #    </note>
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/GetLogGroupFieldsRequest AWS API Documentation

data/lib/aws-sdk-cloudwatchlogs.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-cloudwatchlogs/customizations'
 # @!group service
 module Aws::CloudWatchLogs
 
-  GEM_VERSION = '1.59.0'
+  GEM_VERSION = '1.60.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudwatchlogs
 version: !ruby/object:Gem::Version
-  version: 1.59.0
+  version: 1.60.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-04 00:00:00.000000000 Z
+date: 2023-01-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core