aws-sdk-cloudwatchlogs 1.113.0 → 1.116.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1573fc39b3ee1523379b7af532b56eb770e4b6e08f2ca196eb561989015a11fb
-  data.tar.gz: ab9f880e2f7fe1d6b7146ed7aef2b3029d6cc77f0444508844fdcb477ccee6ce
+  metadata.gz: a3f05aa5f3992cba19243482e408e0db41d02ac6e93d92541b3e0d46f42c7e7b
+  data.tar.gz: 29b906f32e86c2f374f7692472aa19007388a3ef7cd08747b13516617c98a31d
 SHA512:
-  metadata.gz: a884f1832b5978449aceac8212c925257c1f3c1ad5eeba75f8df3445950f87026a5549070bec3b38d39f8ebb258d7171e3953ee918491ae094aae8a3180e1f12
-  data.tar.gz: a5a31f9280f4c92c8aac3a4245fa62e4902db8d3b93721a6294983de8625b540377502ba748cca27effa3456824428915eedb227fa9cdbc54adc1d96fc800981
+  metadata.gz: 9d15df850344c249500543c67981af6bdc8b31510294263e8470e6f5c9c054335eeed2f9ab52fed5fce9d5291c0a401559386234ee8421fb454cb622aa9c9904
+  data.tar.gz: df18817c6003b12d70a53055c9af7639508c685c687c28693cb01b2f4e5e410f15b284342244f71cdd51f06043a5a7ebeb8ac93d2ac5dad2c107a661639f3e70

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.116.0 (2025-05-14)
+------------------
+
+* Feature - This release adds a new API "ListLogGroups" and an improvement in API "DescribeLogGroups"
+
+1.115.0 (2025-05-12)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.114.0 (2025-05-09)
+------------------
+
+* Feature - We are pleased to announce limit increases to our grok processor logs transformation feature. Now you can define 20 Grok patterns in their configurations, with an expanded total pattern matching limit of 512 characters.
+
 1.113.0 (2025-05-01)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.113.0
+1.116.0

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

@@ -202,8 +202,7 @@ module Aws::CloudWatchLogs
     #     accepted modes and the configuration defaults that are included.
     #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
-    #     Set to true to disable SDK automatically adding host prefix
-    #     to default service endpoint when available.
+    #     When `true`, the SDK will not prepend the modeled host prefix to the endpoint.
     #
     #   @option options [Boolean] :disable_request_compression (false)
     #     When set to 'true' the request body will not be compressed
@@ -2249,9 +2248,9 @@ module Aws::CloudWatchLogs
       req.send_request(options)
     end
 
-    # Lists the specified log groups. You can list all your log groups or
-    # filter the results by prefix. The results are ASCII-sorted by log
-    # group name.
+    # Returns information about log groups. You can return all your log
+    # groups or filter the results by prefix. The results are ASCII-sorted
+    # by log group name.
     #
     # CloudWatch Logs doesn't support IAM policies that control access to
     # the `DescribeLogGroups` action by using the `aws:ResourceTag/key-name
@@ -2271,7 +2270,7 @@ module Aws::CloudWatchLogs
     # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
     #
     # @option params [Array<String>] :account_identifiers
-    #   When `includeLinkedAccounts` is set to `True`, use this parameter to
+    #   When `includeLinkedAccounts` is set to `true`, use this parameter to
     #   specify the list of accounts to search. You can specify as many as 20
     #   account IDs in the array.
     #
@@ -2307,7 +2306,7 @@ module Aws::CloudWatchLogs
     #   the default is up to 50 items.
     #
     # @option params [Boolean] :include_linked_accounts
-    #   If you are using a monitoring account, set this to `True` to have the
+    #   If you are using a monitoring account, set this to `true` to have the
     #   operation return log groups in the accounts listed in
     #   `accountIdentifiers`.
     #
@@ -2316,7 +2315,13 @@ module Aws::CloudWatchLogs
     #   account and all log groups in all source accounts that are linked to
     #   the monitoring account.
     #
+    #   The default for this parameter is `false`.
+    #
     # @option params [String] :log_group_class
+    #   Use this parameter to limit the results to only those log groups in
+    #   the specified log group class. If you omit this parameter, log groups
+    #   of all classes can be returned.
+    #
     #   Specifies the log group class for this log group. There are three
     #   classes:
     #
@@ -2338,6 +2343,17 @@ module Aws::CloudWatchLogs
     #
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch_Logs_Log_Classes.html
     #
+    # @option params [Array<String>] :log_group_identifiers
+    #   Use this array to filter the list of log groups returned. If you
+    #   specify this parameter, the only other filter that you can choose to
+    #   specify is `includeLinkedAccounts`.
+    #
+    #   If you are using this operation in a monitoring account, you can
+    #   specify the ARNs of log groups in source accounts and in the
+    #   monitoring account itself. If you are using this operation in an
+    #   account that is not a cross-account monitoring account, you can
+    #   specify only log group names in the same account as the operation.
+    #
     # @return [Types::DescribeLogGroupsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DescribeLogGroupsResponse#log_groups #log_groups} => Array&lt;Types::LogGroup&gt;
@@ -2355,6 +2371,7 @@ module Aws::CloudWatchLogs
     #     limit: 1,
     #     include_linked_accounts: false,
     #     log_group_class: "STANDARD", # accepts STANDARD, INFREQUENT_ACCESS, DELIVERY
+    #     log_group_identifiers: ["LogGroupIdentifier"],
     #   })
     #
     # @example Response structure
@@ -2901,14 +2918,9 @@ module Aws::CloudWatchLogs
     # If the results don't include a `nextToken`, then pagination is
     # finished.
     #
-    # <note markdown="1"> If you set `startFromHead` to `true` and you don’t include `endTime`
-    # in your request, you can end up in a situation where the pagination
-    # doesn't terminate. This can happen when the new log events are being
-    # added to the target log streams faster than they are being read. This
-    # situation is a good use case for the CloudWatch Logs [Live Tail][1]
-    # feature.
-    #
-    #  </note>
+    # Specifying the `limit` parameter only guarantees that a single page
+    # doesn't return more log events than the specified limit, but it might
+    # return fewer events than the limit. This is the expected API behavior.
     #
     # The returned log events are sorted by event timestamp, the timestamp
     # when the event was ingested by CloudWatch Logs, and the ID of the
@@ -2917,21 +2929,20 @@ module Aws::CloudWatchLogs
     # If you are using CloudWatch cross-account observability, you can use
     # this operation in a monitoring account and view data from the linked
     # source accounts. For more information, see [CloudWatch cross-account
-    # observability][2].
+    # observability][1].
     #
-    # <note markdown="1"> If you are using [log transformation][3], the `FilterLogEvents`
+    # <note markdown="1"> If you are using [log transformation][2], the `FilterLogEvents`
     # operation returns only the original versions of log events, before
     # they were transformed. To view the transformed versions, you must use
-    # a [CloudWatch Logs query.][4]
+    # a [CloudWatch Logs query.][3]
     #
     #  </note>
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs_LiveTail.html
-    # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
-    # [3]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation.html
-    # [4]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation.html
+    # [3]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html
     #
     # @option params [String] :log_group_name
     #   The name of the log group to search.
@@ -4006,6 +4017,108 @@ module Aws::CloudWatchLogs
       req.send_request(options)
     end
 
+    # Returns a list of log groups in the Region in your account. If you are
+    # performing this action in a monitoring account, you can choose to also
+    # return log groups from source accounts that are linked to the
+    # monitoring account. For more information about using cross-account
+    # observability to set up monitoring accounts and source accounts, see [
+    # CloudWatch cross-account observability][1].
+    #
+    # You can optionally filter the list by log group class and by using
+    # regular expressions in your request to match strings in the log group
+    # names.
+    #
+    # This operation is paginated. By default, your first use of this
+    # operation returns 50 results, and includes a token to use in a
+    # subsequent operation to return more results.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
+    #
+    # @option params [String] :log_group_name_pattern
+    #   Use this parameter to limit the returned log groups to only those with
+    #   names that match the pattern that you specify. This parameter is a
+    #   regular expression that can match prefixes and substrings, and
+    #   supports wildcard matching and matching multiple patterns, as in the
+    #   following examples.
+    #
+    #   * Use `^` to match log group names by prefix.
+    #
+    #   * For a substring match, specify the string to match. All matches are
+    #     case sensitive
+    #
+    #   * To match multiple patterns, separate them with a `|` as in the
+    #     example `^/aws/lambda|discovery`
+    #
+    #   You can specify as many as five different regular expression patterns
+    #   in this field, each of which must be between 3 and 24 characters. You
+    #   can include the `^` symbol as many as five times, and include the `|`
+    #   symbol as many as four times.
+    #
+    # @option params [String] :log_group_class
+    #   Use this parameter to limit the results to only those log groups in
+    #   the specified log group class. If you omit this parameter, log groups
+    #   of all classes can be returned.
+    #
+    # @option params [Boolean] :include_linked_accounts
+    #   If you are using a monitoring account, set this to `true` to have the
+    #   operation return log groups in the accounts listed in
+    #   `accountIdentifiers`.
+    #
+    #   If this parameter is set to `true` and `accountIdentifiers` contains a
+    #   null value, the operation returns all log groups in the monitoring
+    #   account and all log groups in all source accounts that are linked to
+    #   the monitoring account.
+    #
+    #   The default for this parameter is `false`.
+    #
+    # @option params [Array<String>] :account_identifiers
+    #   When `includeLinkedAccounts` is set to `true`, use this parameter to
+    #   specify the list of accounts to search. You can specify as many as 20
+    #   account IDs in the array.
+    #
+    # @option params [String] :next_token
+    #   The token for the next set of items to return. The token expires after
+    #   24 hours.
+    #
+    # @option params [Integer] :limit
+    #   The maximum number of log groups to return. If you omit this
+    #   parameter, the default is up to 50 log groups.
+    #
+    # @return [Types::ListLogGroupsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListLogGroupsResponse#log_groups #log_groups} => Array&lt;Types::LogGroupSummary&gt;
+    #   * {Types::ListLogGroupsResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_log_groups({
+    #     log_group_name_pattern: "LogGroupNameRegexPattern",
+    #     log_group_class: "STANDARD", # accepts STANDARD, INFREQUENT_ACCESS, DELIVERY
+    #     include_linked_accounts: false,
+    #     account_identifiers: ["AccountId"],
+    #     next_token: "NextToken",
+    #     limit: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.log_groups #=> Array
+    #   resp.log_groups[0].log_group_name #=> String
+    #   resp.log_groups[0].log_group_arn #=> String
+    #   resp.log_groups[0].log_group_class #=> String, one of "STANDARD", "INFREQUENT_ACCESS", "DELIVERY"
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/ListLogGroups AWS API Documentation
+    #
+    # @overload list_log_groups(params = {})
+    # @param [Hash] params ({})
+    def list_log_groups(params = {}, options = {})
+      req = build_request(:list_log_groups, params)
+      req.send_request(options)
+    end
+
     # Returns a list of the log groups that were analyzed during a single
     # CloudWatch Logs Insights query. This can be useful for queries that
     # use log group name prefixes or the `filterIndex` command, because the
@@ -5959,7 +6072,7 @@ module Aws::CloudWatchLogs
     #           entries: [ # required
     #             {
     #               source: "Source", # required
-    #               delimiter: "Delimiter", # required
+    #               delimiter: "SplitStringDelimiter", # required
     #             },
     #           ],
     #         },
@@ -6759,7 +6872,7 @@ module Aws::CloudWatchLogs
     #           entries: [ # required
     #             {
     #               source: "Source", # required
-    #               delimiter: "Delimiter", # required
+    #               delimiter: "SplitStringDelimiter", # required
     #             },
     #           ],
     #         },
@@ -7085,7 +7198,7 @@ module Aws::CloudWatchLogs
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-cloudwatchlogs'
-      context[:gem_version] = '1.113.0'
+      context[:gem_version] = '1.116.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -131,6 +131,7 @@ module Aws::CloudWatchLogs
     DescribeIndexPoliciesRequest = Shapes::StructureShape.new(name: 'DescribeIndexPoliciesRequest')
     DescribeIndexPoliciesResponse = Shapes::StructureShape.new(name: 'DescribeIndexPoliciesResponse')
     DescribeLimit = Shapes::IntegerShape.new(name: 'DescribeLimit')
+    DescribeLogGroupsLogGroupIdentifiers = Shapes::ListShape.new(name: 'DescribeLogGroupsLogGroupIdentifiers')
     DescribeLogGroupsRequest = Shapes::StructureShape.new(name: 'DescribeLogGroupsRequest')
     DescribeLogGroupsResponse = Shapes::StructureShape.new(name: 'DescribeLogGroupsResponse')
     DescribeLogStreamsRequest = Shapes::StructureShape.new(name: 'DescribeLogStreamsRequest')
@@ -266,12 +267,15 @@ module Aws::CloudWatchLogs
     ListAnomaliesResponse = Shapes::StructureShape.new(name: 'ListAnomaliesResponse')
     ListIntegrationsRequest = Shapes::StructureShape.new(name: 'ListIntegrationsRequest')
     ListIntegrationsResponse = Shapes::StructureShape.new(name: 'ListIntegrationsResponse')
+    ListLimit = Shapes::IntegerShape.new(name: 'ListLimit')
     ListLogAnomalyDetectorsLimit = Shapes::IntegerShape.new(name: 'ListLogAnomalyDetectorsLimit')
     ListLogAnomalyDetectorsRequest = Shapes::StructureShape.new(name: 'ListLogAnomalyDetectorsRequest')
     ListLogAnomalyDetectorsResponse = Shapes::StructureShape.new(name: 'ListLogAnomalyDetectorsResponse')
     ListLogGroupsForQueryMaxResults = Shapes::IntegerShape.new(name: 'ListLogGroupsForQueryMaxResults')
     ListLogGroupsForQueryRequest = Shapes::StructureShape.new(name: 'ListLogGroupsForQueryRequest')
     ListLogGroupsForQueryResponse = Shapes::StructureShape.new(name: 'ListLogGroupsForQueryResponse')
+    ListLogGroupsRequest = Shapes::StructureShape.new(name: 'ListLogGroupsRequest')
+    ListLogGroupsResponse = Shapes::StructureShape.new(name: 'ListLogGroupsResponse')
     ListTagsForResourceRequest = Shapes::StructureShape.new(name: 'ListTagsForResourceRequest')
     ListTagsForResourceResponse = Shapes::StructureShape.new(name: 'ListTagsForResourceResponse')
     ListTagsLogGroupRequest = Shapes::StructureShape.new(name: 'ListTagsLogGroupRequest')
@@ -295,7 +299,10 @@ module Aws::CloudWatchLogs
     LogGroupIdentifiers = Shapes::ListShape.new(name: 'LogGroupIdentifiers')
     LogGroupName = Shapes::StringShape.new(name: 'LogGroupName')
     LogGroupNamePattern = Shapes::StringShape.new(name: 'LogGroupNamePattern')
+    LogGroupNameRegexPattern = Shapes::StringShape.new(name: 'LogGroupNameRegexPattern')
     LogGroupNames = Shapes::ListShape.new(name: 'LogGroupNames')
+    LogGroupSummaries = Shapes::ListShape.new(name: 'LogGroupSummaries')
+    LogGroupSummary = Shapes::StructureShape.new(name: 'LogGroupSummary')
     LogGroups = Shapes::ListShape.new(name: 'LogGroups')
     LogRecord = Shapes::MapShape.new(name: 'LogRecord')
     LogRecordPointer = Shapes::StringShape.new(name: 'LogRecordPointer')
@@ -452,6 +459,7 @@ module Aws::CloudWatchLogs
     Source = Shapes::StringShape.new(name: 'Source')
     SourceTimezone = Shapes::StringShape.new(name: 'SourceTimezone')
     SplitString = Shapes::StructureShape.new(name: 'SplitString')
+    SplitStringDelimiter = Shapes::StringShape.new(name: 'SplitStringDelimiter')
     SplitStringEntries = Shapes::ListShape.new(name: 'SplitStringEntries')
     SplitStringEntry = Shapes::StructureShape.new(name: 'SplitStringEntry')
     StandardUnit = Shapes::StringShape.new(name: 'StandardUnit')
@@ -891,6 +899,8 @@ module Aws::CloudWatchLogs
     DescribeIndexPoliciesResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
     DescribeIndexPoliciesResponse.struct_class = Types::DescribeIndexPoliciesResponse
 
+    DescribeLogGroupsLogGroupIdentifiers.member = Shapes::ShapeRef.new(shape: LogGroupIdentifier)
+
     DescribeLogGroupsRequest.add_member(:account_identifiers, Shapes::ShapeRef.new(shape: AccountIds, location_name: "accountIdentifiers"))
     DescribeLogGroupsRequest.add_member(:log_group_name_prefix, Shapes::ShapeRef.new(shape: LogGroupName, location_name: "logGroupNamePrefix"))
     DescribeLogGroupsRequest.add_member(:log_group_name_pattern, Shapes::ShapeRef.new(shape: LogGroupNamePattern, location_name: "logGroupNamePattern"))
@@ -898,6 +908,7 @@ module Aws::CloudWatchLogs
     DescribeLogGroupsRequest.add_member(:limit, Shapes::ShapeRef.new(shape: DescribeLimit, location_name: "limit"))
     DescribeLogGroupsRequest.add_member(:include_linked_accounts, Shapes::ShapeRef.new(shape: IncludeLinkedAccounts, location_name: "includeLinkedAccounts"))
     DescribeLogGroupsRequest.add_member(:log_group_class, Shapes::ShapeRef.new(shape: LogGroupClass, location_name: "logGroupClass"))
+    DescribeLogGroupsRequest.add_member(:log_group_identifiers, Shapes::ShapeRef.new(shape: DescribeLogGroupsLogGroupIdentifiers, location_name: "logGroupIdentifiers"))
     DescribeLogGroupsRequest.struct_class = Types::DescribeLogGroupsRequest
 
     DescribeLogGroupsResponse.add_member(:log_groups, Shapes::ShapeRef.new(shape: LogGroups, location_name: "logGroups"))
@@ -1247,6 +1258,18 @@ module Aws::CloudWatchLogs
     ListLogGroupsForQueryResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
     ListLogGroupsForQueryResponse.struct_class = Types::ListLogGroupsForQueryResponse
 
+    ListLogGroupsRequest.add_member(:log_group_name_pattern, Shapes::ShapeRef.new(shape: LogGroupNameRegexPattern, location_name: "logGroupNamePattern"))
+    ListLogGroupsRequest.add_member(:log_group_class, Shapes::ShapeRef.new(shape: LogGroupClass, location_name: "logGroupClass"))
+    ListLogGroupsRequest.add_member(:include_linked_accounts, Shapes::ShapeRef.new(shape: IncludeLinkedAccounts, location_name: "includeLinkedAccounts"))
+    ListLogGroupsRequest.add_member(:account_identifiers, Shapes::ShapeRef.new(shape: AccountIds, location_name: "accountIdentifiers"))
+    ListLogGroupsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
+    ListLogGroupsRequest.add_member(:limit, Shapes::ShapeRef.new(shape: ListLimit, location_name: "limit"))
+    ListLogGroupsRequest.struct_class = Types::ListLogGroupsRequest
+
+    ListLogGroupsResponse.add_member(:log_groups, Shapes::ShapeRef.new(shape: LogGroupSummaries, location_name: "logGroups"))
+    ListLogGroupsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
+    ListLogGroupsResponse.struct_class = Types::ListLogGroupsResponse
+
     ListTagsForResourceRequest.add_member(:resource_arn, Shapes::ShapeRef.new(shape: AmazonResourceName, required: true, location_name: "resourceArn"))
     ListTagsForResourceRequest.struct_class = Types::ListTagsForResourceRequest
 
@@ -1320,6 +1343,13 @@ module Aws::CloudWatchLogs
 
     LogGroupNames.member = Shapes::ShapeRef.new(shape: LogGroupName)
 
+    LogGroupSummaries.member = Shapes::ShapeRef.new(shape: LogGroupSummary)
+
+    LogGroupSummary.add_member(:log_group_name, Shapes::ShapeRef.new(shape: LogGroupName, location_name: "logGroupName"))
+    LogGroupSummary.add_member(:log_group_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "logGroupArn"))
+    LogGroupSummary.add_member(:log_group_class, Shapes::ShapeRef.new(shape: LogGroupClass, location_name: "logGroupClass"))
+    LogGroupSummary.struct_class = Types::LogGroupSummary
+
     LogGroups.member = Shapes::ShapeRef.new(shape: LogGroup)
 
     LogRecord.key = Shapes::ShapeRef.new(shape: Field)
@@ -1764,7 +1794,7 @@ module Aws::CloudWatchLogs
     SplitStringEntries.member = Shapes::ShapeRef.new(shape: SplitStringEntry)
 
     SplitStringEntry.add_member(:source, Shapes::ShapeRef.new(shape: Source, required: true, location_name: "source"))
-    SplitStringEntry.add_member(:delimiter, Shapes::ShapeRef.new(shape: Delimiter, required: true, location_name: "delimiter"))
+    SplitStringEntry.add_member(:delimiter, Shapes::ShapeRef.new(shape: SplitStringDelimiter, required: true, location_name: "delimiter"))
     SplitStringEntry.struct_class = Types::SplitStringEntry
 
     StartLiveTailLogGroupIdentifiers.member = Shapes::ShapeRef.new(shape: LogGroupIdentifier)
@@ -2718,6 +2748,16 @@ module Aws::CloudWatchLogs
         )
       end)
 
+      api.add_operation(:list_log_groups, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListLogGroups"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListLogGroupsRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListLogGroupsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
+      end)
+
       api.add_operation(:list_log_groups_for_query, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListLogGroupsForQuery"
         o.http_method = "POST"

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

@@ -2008,7 +2008,7 @@ module Aws::CloudWatchLogs
     end
 
     # @!attribute [rw] account_identifiers
-    #   When `includeLinkedAccounts` is set to `True`, use this parameter to
+    #   When `includeLinkedAccounts` is set to `true`, use this parameter to
     #   specify the list of accounts to search. You can specify as many as
     #   20 account IDs in the array.
     #   @return [Array<String>]
@@ -2050,7 +2050,7 @@ module Aws::CloudWatchLogs
     #   @return [Integer]
     #
     # @!attribute [rw] include_linked_accounts
-    #   If you are using a monitoring account, set this to `True` to have
+    #   If you are using a monitoring account, set this to `true` to have
     #   the operation return log groups in the accounts listed in
     #   `accountIdentifiers`.
     #
@@ -2058,9 +2058,15 @@ module Aws::CloudWatchLogs
     #   a null value, the operation returns all log groups in the monitoring
     #   account and all log groups in all source accounts that are linked to
     #   the monitoring account.
+    #
+    #   The default for this parameter is `false`.
     #   @return [Boolean]
     #
     # @!attribute [rw] log_group_class
+    #   Use this parameter to limit the results to only those log groups in
+    #   the specified log group class. If you omit this parameter, log
+    #   groups of all classes can be returned.
+    #
     #   Specifies the log group class for this log group. There are three
     #   classes:
     #
@@ -2083,6 +2089,18 @@ module Aws::CloudWatchLogs
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch_Logs_Log_Classes.html
     #   @return [String]
     #
+    # @!attribute [rw] log_group_identifiers
+    #   Use this array to filter the list of log groups returned. If you
+    #   specify this parameter, the only other filter that you can choose to
+    #   specify is `includeLinkedAccounts`.
+    #
+    #   If you are using this operation in a monitoring account, you can
+    #   specify the ARNs of log groups in source accounts and in the
+    #   monitoring account itself. If you are using this operation in an
+    #   account that is not a cross-account monitoring account, you can
+    #   specify only log group names in the same account as the operation.
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/DescribeLogGroupsRequest AWS API Documentation
     #
     class DescribeLogGroupsRequest < Struct.new(
@@ -2092,16 +2110,15 @@ module Aws::CloudWatchLogs
       :next_token,
       :limit,
       :include_linked_accounts,
-      :log_group_class)
+      :log_group_class,
+      :log_group_identifiers)
       SENSITIVE = []
       include Aws::Structure
     end
 
     # @!attribute [rw] log_groups
-    #   The log groups.
-    #
-    #   If the `retentionInDays` value is not included for a log group, then
-    #   that log group's events do not expire.
+    #   An array of structures, where each structure contains the
+    #   information about one log group.
     #   @return [Array<Types::LogGroup>]
     #
     # @!attribute [rw] next_token
@@ -3513,7 +3530,7 @@ module Aws::CloudWatchLogs
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation.html#Grok-Patterns
+    #   [1]: https://docs.aws.amazon.com/mazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation-Processors.html#Grok-Patterns
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/Grok AWS API Documentation
@@ -3863,6 +3880,94 @@ module Aws::CloudWatchLogs
       include Aws::Structure
     end
 
+    # @!attribute [rw] log_group_name_pattern
+    #   Use this parameter to limit the returned log groups to only those
+    #   with names that match the pattern that you specify. This parameter
+    #   is a regular expression that can match prefixes and substrings, and
+    #   supports wildcard matching and matching multiple patterns, as in the
+    #   following examples.
+    #
+    #   * Use `^` to match log group names by prefix.
+    #
+    #   * For a substring match, specify the string to match. All matches
+    #     are case sensitive
+    #
+    #   * To match multiple patterns, separate them with a `|` as in the
+    #     example `^/aws/lambda|discovery`
+    #
+    #   You can specify as many as five different regular expression
+    #   patterns in this field, each of which must be between 3 and 24
+    #   characters. You can include the `^` symbol as many as five times,
+    #   and include the `|` symbol as many as four times.
+    #   @return [String]
+    #
+    # @!attribute [rw] log_group_class
+    #   Use this parameter to limit the results to only those log groups in
+    #   the specified log group class. If you omit this parameter, log
+    #   groups of all classes can be returned.
+    #   @return [String]
+    #
+    # @!attribute [rw] include_linked_accounts
+    #   If you are using a monitoring account, set this to `true` to have
+    #   the operation return log groups in the accounts listed in
+    #   `accountIdentifiers`.
+    #
+    #   If this parameter is set to `true` and `accountIdentifiers` contains
+    #   a null value, the operation returns all log groups in the monitoring
+    #   account and all log groups in all source accounts that are linked to
+    #   the monitoring account.
+    #
+    #   The default for this parameter is `false`.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] account_identifiers
+    #   When `includeLinkedAccounts` is set to `true`, use this parameter to
+    #   specify the list of accounts to search. You can specify as many as
+    #   20 account IDs in the array.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] next_token
+    #   The token for the next set of items to return. The token expires
+    #   after 24 hours.
+    #   @return [String]
+    #
+    # @!attribute [rw] limit
+    #   The maximum number of log groups to return. If you omit this
+    #   parameter, the default is up to 50 log groups.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/ListLogGroupsRequest AWS API Documentation
+    #
+    class ListLogGroupsRequest < Struct.new(
+      :log_group_name_pattern,
+      :log_group_class,
+      :include_linked_accounts,
+      :account_identifiers,
+      :next_token,
+      :limit)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] log_groups
+    #   An array of structures, where each structure contains the
+    #   information about one log group.
+    #   @return [Array<Types::LogGroupSummary>]
+    #
+    # @!attribute [rw] next_token
+    #   The token for the next set of items to return. The token expires
+    #   after 24 hours.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/ListLogGroupsResponse AWS API Documentation
+    #
+    class ListLogGroupsResponse < Struct.new(
+      :log_groups,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] resource_arn
     #   The ARN of the resource that you want to view tags for.
     #
@@ -3932,7 +4037,7 @@ module Aws::CloudWatchLogs
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation.html#CloudWatch-Logs-Transformation-listToMap
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation-Processors.html#CloudWatch-Logs-Transformation-listToMap
     #
     # @!attribute [rw] source
     #   The key in the log event that has a list of objects that will be
@@ -4299,6 +4404,36 @@ module Aws::CloudWatchLogs
       include Aws::Structure
     end
 
+    # This structure contains information about one log group in your
+    # account.
+    #
+    # @!attribute [rw] log_group_name
+    #   The name of the log group.
+    #   @return [String]
+    #
+    # @!attribute [rw] log_group_arn
+    #   The Amazon Resource Name (ARN) of the log group.
+    #   @return [String]
+    #
+    # @!attribute [rw] log_group_class
+    #   The log group class for this log group. For details about the
+    #   features supported by each log group class, see [Log classes][1]
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch_Logs_Log_Classes.html
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/LogGroupSummary AWS API Documentation
+    #
+    class LogGroupSummary < Struct.new(
+      :log_group_name,
+      :log_group_arn,
+      :log_group_class)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Represents a log stream, which is a sequence of log events from a
     # single emitter of logs.
     #

data/lib/aws-sdk-cloudwatchlogs.rb

@@ -55,7 +55,7 @@ module Aws::CloudWatchLogs
   autoload :Endpoints, 'aws-sdk-cloudwatchlogs/endpoints'
   autoload :EventStreams, 'aws-sdk-cloudwatchlogs/event_streams'
 
-  GEM_VERSION = '1.113.0'
+  GEM_VERSION = '1.116.0'
 
 end
 

data/sig/client.rbs

@@ -414,7 +414,8 @@ module Aws
                                  ?next_token: ::String,
                                  ?limit: ::Integer,
                                  ?include_linked_accounts: bool,
-                                 ?log_group_class: ("STANDARD" | "INFREQUENT_ACCESS" | "DELIVERY")
+                                 ?log_group_class: ("STANDARD" | "INFREQUENT_ACCESS" | "DELIVERY"),
+                                 ?log_group_identifiers: Array[::String]
                                ) -> _DescribeLogGroupsResponseSuccess
                              | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DescribeLogGroupsResponseSuccess
 
@@ -727,6 +728,22 @@ module Aws
                                       ) -> _ListLogAnomalyDetectorsResponseSuccess
                                     | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListLogAnomalyDetectorsResponseSuccess
 
+      interface _ListLogGroupsResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::ListLogGroupsResponse]
+        def log_groups: () -> ::Array[Types::LogGroupSummary]
+        def next_token: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CloudWatchLogs/Client.html#list_log_groups-instance_method
+      def list_log_groups: (
+                             ?log_group_name_pattern: ::String,
+                             ?log_group_class: ("STANDARD" | "INFREQUENT_ACCESS" | "DELIVERY"),
+                             ?include_linked_accounts: bool,
+                             ?account_identifiers: Array[::String],
+                             ?next_token: ::String,
+                             ?limit: ::Integer
+                           ) -> _ListLogGroupsResponseSuccess
+                         | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListLogGroupsResponseSuccess
+
       interface _ListLogGroupsForQueryResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::ListLogGroupsForQueryResponse]
         def log_group_identifiers: () -> ::Array[::String]

data/sig/types.rbs

@@ -478,6 +478,7 @@ module Aws::CloudWatchLogs
       attr_accessor limit: ::Integer
       attr_accessor include_linked_accounts: bool
       attr_accessor log_group_class: ("STANDARD" | "INFREQUENT_ACCESS" | "DELIVERY")
+      attr_accessor log_group_identifiers: ::Array[::String]
       SENSITIVE: []
     end
 
@@ -920,6 +921,22 @@ module Aws::CloudWatchLogs
       SENSITIVE: []
     end
 
+    class ListLogGroupsRequest
+      attr_accessor log_group_name_pattern: ::String
+      attr_accessor log_group_class: ("STANDARD" | "INFREQUENT_ACCESS" | "DELIVERY")
+      attr_accessor include_linked_accounts: bool
+      attr_accessor account_identifiers: ::Array[::String]
+      attr_accessor next_token: ::String
+      attr_accessor limit: ::Integer
+      SENSITIVE: []
+    end
+
+    class ListLogGroupsResponse
+      attr_accessor log_groups: ::Array[Types::LogGroupSummary]
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
     class ListTagsForResourceRequest
       attr_accessor resource_arn: ::String
       SENSITIVE: []
@@ -1009,6 +1026,13 @@ module Aws::CloudWatchLogs
       SENSITIVE: []
     end
 
+    class LogGroupSummary
+      attr_accessor log_group_name: ::String
+      attr_accessor log_group_arn: ::String
+      attr_accessor log_group_class: ("STANDARD" | "INFREQUENT_ACCESS" | "DELIVERY")
+      SENSITIVE: []
+    end
+
     class LogStream
       attr_accessor log_stream_name: ::String
       attr_accessor creation_time: ::Integer

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudwatchlogs
 version: !ruby/object:Gem::Version
-  version: 1.113.0
+  version: 1.116.0
 platform: ruby
 authors:
 - Amazon Web Services