aws-sdk-cloudwatchlogs 1.147.0 → 1.148.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4d8887efc6a9f880d973a21b4e63fe48dbbd7c98898f0017f30cb105d4be852b
-  data.tar.gz: e3eb1cce37bc8fdf8e0313fa4b66eb350ba503e75bc175d273e352703a6fdc54
+  metadata.gz: 4c3df144eaefe138ae1e298537c0c495044d96da140fb8cc7148eb189e189d26
+  data.tar.gz: 4fbfbdf42a703c3accd3756b5f27c74aa8bb9788a096f4327b38be0dcc223abc
 SHA512:
-  metadata.gz: a963a4a6a87f3bd4e2912e9fb204b4a08e048118246bced618749ebcd36df9eb20e407577d82a2c141f39a14ff3d719f2fb607dedad58485aa98c5250799a944
-  data.tar.gz: cddd9e1435b9adc8a67022fe1798004d3a23c82310e026802cb50f42d7a7ce3e89fb14e151a383bfe9555742cf80e576caf84a12de4c02fe876aef698d48fb92
+  metadata.gz: d06dedc3dc82d2c0d35cfcad018a6e5b6e6d1bf606b4ea16b473f910f9bfb9b6d68c7bec1daa9e2e0066e22d3e02789122b6e02a1ad27b92014187b4d3bc1e0f
+  data.tar.gz: c9c3894e26229d656928eabeeeccec181412bf2132e2b7d796f5dadaadbb325966efba14a9c40970bbd6b752e3dc108cf57aec526ca6c819823d0eb6c3c41a95

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.148.0 (2026-05-01)
+------------------
+
+* Feature - Adds support for filtering log groups by tags in the ListLogGroups API via the new logGroupTags parameter.
+
 1.147.0 (2026-04-27)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.147.0
+1.148.0

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

@@ -5258,12 +5258,10 @@ module Aws::CloudWatchLogs
     # 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, by using
-    # regular expressions in your request to match strings in the log group
-    # names, by using the fieldIndexes parameter to filter log groups based
-    # on which field indexes are configured, by using the dataSources
-    # parameter to filter log groups by data source types, and by using the
-    # fieldIndexNames parameter to filter by specific field index names.
+    # You can optionally filter the results by log group class, log group
+    # name pattern, field indexes, data sources, field index names, or log
+    # group tags. If you specify more than one filter type, the results
+    # include log groups that satisfy all filters.
     #
     # This operation is paginated. By default, your first use of this
     # operation returns 50 results, and includes a token to use in a
@@ -5336,6 +5334,10 @@ module Aws::CloudWatchLogs
     #   are returned. You can specify 1 to 20 field index names, each with 1
     #   to 512 characters.
     #
+    # @option params [Array<Types::TagFilter>] :log_group_tags
+    #   An array of tag filters to return only log groups that have specific
+    #   tags. Multiple filters are combined with AND logic.
+    #
     # @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;
@@ -5357,6 +5359,12 @@ module Aws::CloudWatchLogs
     #       },
     #     ],
     #     field_index_names: ["FieldIndexName"],
+    #     log_group_tags: [
+    #       {
+    #         key: "TagFilterKey", # required
+    #         values: ["TagFilterValue"],
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -8291,7 +8299,9 @@ module Aws::CloudWatchLogs
     # * Or the `queryString` must include a `SOURCE` command to select log
     #   groups for the query. The `SOURCE` command can select log groups
     #   based on log group name prefix, account ID, and log class, or select
-    #   data sources using dataSource syntax in LogsQL, PPL, and SQL.
+    #   data sources using dataSource syntax in LogsQL, PPL, and SQL. In
+    #   LogsQL, the `SOURCE` command also supports filtering by log group
+    #   tags.
     #
     #   For more information about the `SOURCE` command, see [SOURCE][3].
     #
@@ -9250,7 +9260,7 @@ module Aws::CloudWatchLogs
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-cloudwatchlogs'
-      context[:gem_version] = '1.147.0'
+      context[:gem_version] = '1.148.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -618,6 +618,11 @@ module Aws::CloudWatchLogs
     SystemField = Shapes::StringShape.new(name: 'SystemField')
     TableBody = Shapes::StringShape.new(name: 'TableBody')
     TableFields = Shapes::ListShape.new(name: 'TableFields')
+    TagFilter = Shapes::StructureShape.new(name: 'TagFilter')
+    TagFilterKey = Shapes::StringShape.new(name: 'TagFilterKey')
+    TagFilterValue = Shapes::StringShape.new(name: 'TagFilterValue')
+    TagFilterValues = Shapes::ListShape.new(name: 'TagFilterValues')
+    TagFilters = Shapes::ListShape.new(name: 'TagFilters')
     TagKey = Shapes::StringShape.new(name: 'TagKey')
     TagKeyList = Shapes::ListShape.new(name: 'TagKeyList')
     TagList = Shapes::ListShape.new(name: 'TagList')
@@ -1669,6 +1674,7 @@ module Aws::CloudWatchLogs
     ListLogGroupsRequest.add_member(:limit, Shapes::ShapeRef.new(shape: ListLimit, location_name: "limit"))
     ListLogGroupsRequest.add_member(:data_sources, Shapes::ShapeRef.new(shape: DataSourceFilters, location_name: "dataSources"))
     ListLogGroupsRequest.add_member(:field_index_names, Shapes::ShapeRef.new(shape: FieldIndexNames, location_name: "fieldIndexNames"))
+    ListLogGroupsRequest.add_member(:log_group_tags, Shapes::ShapeRef.new(shape: TagFilters, location_name: "logGroupTags"))
     ListLogGroupsRequest.struct_class = Types::ListLogGroupsRequest
 
     ListLogGroupsResponse.add_member(:log_groups, Shapes::ShapeRef.new(shape: LogGroupSummaries, location_name: "logGroups"))
@@ -2392,6 +2398,14 @@ module Aws::CloudWatchLogs
 
     TableFields.member = Shapes::ShapeRef.new(shape: String)
 
+    TagFilter.add_member(:key, Shapes::ShapeRef.new(shape: TagFilterKey, required: true, location_name: "key"))
+    TagFilter.add_member(:values, Shapes::ShapeRef.new(shape: TagFilterValues, location_name: "values"))
+    TagFilter.struct_class = Types::TagFilter
+
+    TagFilterValues.member = Shapes::ShapeRef.new(shape: TagFilterValue)
+
+    TagFilters.member = Shapes::ShapeRef.new(shape: TagFilter)
+
     TagKeyList.member = Shapes::ShapeRef.new(shape: TagKey)
 
     TagList.member = Shapes::ShapeRef.new(shape: TagKey)

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

@@ -5199,6 +5199,11 @@ module Aws::CloudWatchLogs
     #   names, each with 1 to 512 characters.
     #   @return [Array<String>]
     #
+    # @!attribute [rw] log_group_tags
+    #   An array of tag filters to return only log groups that have specific
+    #   tags. Multiple filters are combined with AND logic.
+    #   @return [Array<Types::TagFilter>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/ListLogGroupsRequest AWS API Documentation
     #
     class ListLogGroupsRequest < Struct.new(
@@ -5209,7 +5214,8 @@ module Aws::CloudWatchLogs
       :next_token,
       :limit,
       :data_sources,
-      :field_index_names)
+      :field_index_names,
+      :log_group_tags)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -9717,6 +9723,42 @@ module Aws::CloudWatchLogs
       include Aws::Structure
     end
 
+    # A tag filter that specifies a tag key and optional tag values for
+    # filtering log groups by tags.
+    #
+    # @!attribute [rw] key
+    #   The tag key to filter on.
+    #   @return [String]
+    #
+    # @!attribute [rw] values
+    #   An optional list of tag values to filter on.
+    #
+    #   * If you specify a filter that contains more than one value for a
+    #     key, the response returns log groups that match any of the
+    #     specified values for that key.
+    #
+    #   * If you don't specify values, the response returns all log groups
+    #     that are tagged with that key, with any or no value.
+    #
+    #   * Use `*` for wildcard matching. For example, `prod*` matches values
+    #     that start with `prod`.
+    #
+    #   * Use `!` as a prefix for negation. For example, `!prod` matches
+    #     values that are not `prod`.
+    #
+    #   * Exact matching and negation are case-sensitive. Wildcard matching
+    #     is case-insensitive.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/TagFilter AWS API Documentation
+    #
+    class TagFilter < Struct.new(
+      :key,
+      :values)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] log_group_name
     #   The name of the log group.
     #   @return [String]

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.147.0'
+  GEM_VERSION = '1.148.0'
 
 end
 

data/sig/client.rbs

@@ -1022,7 +1022,13 @@ module Aws
                                  type: ::String?
                                },
                              ],
-                             ?field_index_names: Array[::String]
+                             ?field_index_names: Array[::String],
+                             ?log_group_tags: Array[
+                               {
+                                 key: ::String,
+                                 values: Array[::String]?
+                               },
+                             ]
                            ) -> _ListLogGroupsResponseSuccess
                          | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListLogGroupsResponseSuccess
 

data/sig/types.rbs

@@ -1261,6 +1261,7 @@ module Aws::CloudWatchLogs
       attr_accessor limit: ::Integer
       attr_accessor data_sources: ::Array[Types::DataSourceFilter]
       attr_accessor field_index_names: ::Array[::String]
+      attr_accessor log_group_tags: ::Array[Types::TagFilter]
       SENSITIVE: []
     end
 
@@ -2134,6 +2135,12 @@ module Aws::CloudWatchLogs
       SENSITIVE: []
     end
 
+    class TagFilter
+      attr_accessor key: ::String
+      attr_accessor values: ::Array[::String]
+      SENSITIVE: []
+    end
+
     class TagLogGroupRequest
       attr_accessor log_group_name: ::String
       attr_accessor tags: ::Hash[::String, ::String]

metadata

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