aws-sdk-cloudwatchlogs 1.140.0 → 1.141.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3306c9d983ea00949bbaad681146f7901d48356af151180f680ab985363efee
-  data.tar.gz: b6773b4d0dfd3a37e7804be2d55f4f2006501ab26535417b48d5335e94141224
+  metadata.gz: 7e8a10a5c4d8f895f5f19f8f593dc6bbee2a37ca4ca53ba0772e8ea2edff0d17
+  data.tar.gz: 9ae34f8edf5d58641ce1a1c1cc65507312651891e4ab8258237c07fe1b044111
 SHA512:
-  metadata.gz: aade56da28a42eb3d635f9c036f73a109cbd7bd712dbf459577966839775af6b78470a3de2cdba823051ae3a5c3307c3b1644a10858666febe99dad425319d12
-  data.tar.gz: 2988dc65238a88925ed83bf780037b0e76577e2b95301b0df7337f38c1fb18fe725bc248d6b02d3552a46fa010a427d8a9e8abefae372c32997fe75cc5b61123
+  metadata.gz: 847fa5d00d0ffa8ba5ccb9e03cf5da5de91a86ac6eb4f747d76786d651254191b50862d94f9ca7cb6844e6c856adca7793531340b41b2a059f1b0185fa495c23
+  data.tar.gz: 69f539032626e620974e406ba14f6d39922341729d02753d61bd0838ad9a611ace8ea871644d242be58cd7fdbb9483b66210cc6a601e8434f78b8eb2548af0d0

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.141.0 (2026-03-26)
+------------------
+
+* Feature - This release adds parameter support to saved queries in CloudWatch Logs Insights. Define reusable query templates with named placeholders, invoke them using start query. Available in Console, CLI and SDK
+
 1.140.0 (2026-03-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.140.0
+1.141.0

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

@@ -1364,7 +1364,7 @@ module Aws::CloudWatchLogs
     #
     # @option params [required, String] :query_language
     #   The query language to use for the scheduled query. Valid values are
-    #   `LogsQL`, `PPL`, and `SQL`.
+    #   `CWLI`, `PPL`, and `SQL`.
     #
     # @option params [required, String] :query_string
     #   The query string to execute. This is the same query syntax used in
@@ -1434,6 +1434,8 @@ module Aws::CloudWatchLogs
     #       s3_configuration: { # required
     #         destination_identifier: "S3Uri", # required
     #         role_arn: "RoleArn", # required
+    #         owner_account_id: "AccountId",
+    #         kms_key_id: "KmsKeyId",
     #       },
     #     },
     #     schedule_start_time: 1,
@@ -3187,6 +3189,10 @@ module Aws::CloudWatchLogs
     #   resp.query_definitions[0].last_modified #=> Integer
     #   resp.query_definitions[0].log_group_names #=> Array
     #   resp.query_definitions[0].log_group_names[0] #=> String
+    #   resp.query_definitions[0].parameters #=> Array
+    #   resp.query_definitions[0].parameters[0].name #=> String
+    #   resp.query_definitions[0].parameters[0].default_value #=> String
+    #   resp.query_definitions[0].parameters[0].description #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/DescribeQueryDefinitions AWS API Documentation
@@ -4541,6 +4547,8 @@ module Aws::CloudWatchLogs
     #   resp.start_time_offset #=> Integer
     #   resp.destination_configuration.s3_configuration.destination_identifier #=> String
     #   resp.destination_configuration.s3_configuration.role_arn #=> String
+    #   resp.destination_configuration.s3_configuration.owner_account_id #=> String
+    #   resp.destination_configuration.s3_configuration.kms_key_id #=> String
     #   resp.state #=> String, one of "ENABLED", "DISABLED"
     #   resp.last_triggered_time #=> Integer
     #   resp.last_execution_status #=> String, one of "Running", "InvalidQuery", "Complete", "Failed", "Timeout"
@@ -5269,6 +5277,8 @@ module Aws::CloudWatchLogs
     #   resp.scheduled_queries[0].timezone #=> String
     #   resp.scheduled_queries[0].destination_configuration.s3_configuration.destination_identifier #=> String
     #   resp.scheduled_queries[0].destination_configuration.s3_configuration.role_arn #=> String
+    #   resp.scheduled_queries[0].destination_configuration.s3_configuration.owner_account_id #=> String
+    #   resp.scheduled_queries[0].destination_configuration.s3_configuration.kms_key_id #=> String
     #   resp.scheduled_queries[0].creation_time #=> Integer
     #   resp.scheduled_queries[0].last_updated_time #=> Integer
     #
@@ -6401,6 +6411,9 @@ module Aws::CloudWatchLogs
     #   * For Amazon Bedrock AgentCore Identity, the valid values are
     #     `APPLICATION_LOGS` and `TRACES`.
     #
+    #   * For Amazon Bedrock AgentCore Memory, the valid values are
+    #     `APPLICATION_LOGS` and `TRACES`.
+    #
     #   * For Amazon Bedrock AgentCore Gateway, the valid values are
     #     `APPLICATION_LOGS` and `TRACES`.
     #
@@ -6415,6 +6428,10 @@ module Aws::CloudWatchLogs
     #     `AD_DECISION_SERVER_LOGS`, `MANIFEST_SERVICE_LOGS`, and
     #     `TRANSCODE_LOGS`.
     #
+    #   * For Amazon EKS Auto Mode, the valid values are
+    #     `AUTO_MODE_BLOCK_STORAGE_LOGS`, `AUTO_MODE_COMPUTE_LOGS`,
+    #     `AUTO_MODE_IPAM_LOGS`, and `AUTO_MODE_LOAD_BALANCING_LOGS`.
+    #
     #   * For Entity Resolution, the valid value is `WORKFLOW_LOGS`.
     #
     #   * For IAM Identity Center, the valid value is `ERROR_LOGS`.
@@ -6427,8 +6444,7 @@ module Aws::CloudWatchLogs
     #   * For PCS, the valid values are `PCS_SCHEDULER_LOGS` and
     #     `PCS_JOBCOMP_LOGS`.
     #
-    #   * For Quick Suite, the valid values are `CHAT_LOGS` and
-    #     `FEEDBACK_LOGS`.
+    #   * For Quick, the valid values are `CHAT_LOGS` and `FEEDBACK_LOGS`.
     #
     #   * For Amazon Web Services RTB Fabric, the valid values is
     #     `APPLICATION_LOGS`.
@@ -7170,6 +7186,14 @@ module Aws::CloudWatchLogs
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [Array<Types::QueryParameter>] :parameters
+    #   Use this parameter to include specific query parameters as part of
+    #   your query definition. Query parameters are supported only for Logs
+    #   Insights QL queries. Query parameters allow you to use placeholder
+    #   variables in your query string that are substituted with values at
+    #   execution time. Use the `{{parameterName}}` syntax in your query
+    #   string to reference a parameter.
+    #
     # @return [Types::PutQueryDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::PutQueryDefinitionResponse#query_definition_id #query_definition_id} => String
@@ -7183,6 +7207,13 @@ module Aws::CloudWatchLogs
     #     log_group_names: ["LogGroupName"],
     #     query_string: "QueryDefinitionString", # required
     #     client_token: "ClientToken",
+    #     parameters: [
+    #       {
+    #         name: "QueryParameterName", # required
+    #         default_value: "QueryParameterDefaultValue",
+    #         description: "QueryParameterDescription",
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -8067,7 +8098,7 @@ module Aws::CloudWatchLogs
     # observability][5]. For a cross-account `StartQuery` operation, the
     # query definition must be defined in the monitoring account.
     #
-    # You can have up to 30 concurrent CloudWatch Logs insights queries,
+    # You can have up to 100 concurrent CloudWatch Logs insights queries,
     # including queries that have been added to dashboards.
     #
     #
@@ -8889,6 +8920,8 @@ module Aws::CloudWatchLogs
     #       s3_configuration: { # required
     #         destination_identifier: "S3Uri", # required
     #         role_arn: "RoleArn", # required
+    #         owner_account_id: "AccountId",
+    #         kms_key_id: "KmsKeyId",
     #       },
     #     },
     #     schedule_start_time: 1,
@@ -8911,6 +8944,8 @@ module Aws::CloudWatchLogs
     #   resp.start_time_offset #=> Integer
     #   resp.destination_configuration.s3_configuration.destination_identifier #=> String
     #   resp.destination_configuration.s3_configuration.role_arn #=> String
+    #   resp.destination_configuration.s3_configuration.owner_account_id #=> String
+    #   resp.destination_configuration.s3_configuration.kms_key_id #=> String
     #   resp.state #=> String, one of "ENABLED", "DISABLED"
     #   resp.last_triggered_time #=> Integer
     #   resp.last_execution_status #=> String, one of "Running", "InvalidQuery", "Complete", "Failed", "Timeout"
@@ -8947,7 +8982,7 @@ module Aws::CloudWatchLogs
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-cloudwatchlogs'
-      context[:gem_version] = '1.140.0'
+      context[:gem_version] = '1.141.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -505,6 +505,11 @@ module Aws::CloudWatchLogs
     QueryInfoList = Shapes::ListShape.new(name: 'QueryInfoList')
     QueryLanguage = Shapes::StringShape.new(name: 'QueryLanguage')
     QueryListMaxResults = Shapes::IntegerShape.new(name: 'QueryListMaxResults')
+    QueryParameter = Shapes::StructureShape.new(name: 'QueryParameter')
+    QueryParameterDefaultValue = Shapes::StringShape.new(name: 'QueryParameterDefaultValue')
+    QueryParameterDescription = Shapes::StringShape.new(name: 'QueryParameterDescription')
+    QueryParameterList = Shapes::ListShape.new(name: 'QueryParameterList')
+    QueryParameterName = Shapes::StringShape.new(name: 'QueryParameterName')
     QueryResults = Shapes::ListShape.new(name: 'QueryResults')
     QueryStatistics = Shapes::StructureShape.new(name: 'QueryStatistics')
     QueryStatus = Shapes::StringShape.new(name: 'QueryStatus')
@@ -2040,6 +2045,7 @@ module Aws::CloudWatchLogs
     PutQueryDefinitionRequest.add_member(:log_group_names, Shapes::ShapeRef.new(shape: LogGroupNames, location_name: "logGroupNames"))
     PutQueryDefinitionRequest.add_member(:query_string, Shapes::ShapeRef.new(shape: QueryDefinitionString, required: true, location_name: "queryString"))
     PutQueryDefinitionRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, location_name: "clientToken", metadata: {"idempotencyToken" => true}))
+    PutQueryDefinitionRequest.add_member(:parameters, Shapes::ShapeRef.new(shape: QueryParameterList, location_name: "parameters"))
     PutQueryDefinitionRequest.struct_class = Types::PutQueryDefinitionRequest
 
     PutQueryDefinitionResponse.add_member(:query_definition_id, Shapes::ShapeRef.new(shape: QueryId, location_name: "queryDefinitionId"))
@@ -2088,6 +2094,7 @@ module Aws::CloudWatchLogs
     QueryDefinition.add_member(:query_string, Shapes::ShapeRef.new(shape: QueryDefinitionString, location_name: "queryString"))
     QueryDefinition.add_member(:last_modified, Shapes::ShapeRef.new(shape: Timestamp, location_name: "lastModified"))
     QueryDefinition.add_member(:log_group_names, Shapes::ShapeRef.new(shape: LogGroupNames, location_name: "logGroupNames"))
+    QueryDefinition.add_member(:parameters, Shapes::ShapeRef.new(shape: QueryParameterList, location_name: "parameters"))
     QueryDefinition.struct_class = Types::QueryDefinition
 
     QueryDefinitionList.member = Shapes::ShapeRef.new(shape: QueryDefinition)
@@ -2102,6 +2109,13 @@ module Aws::CloudWatchLogs
 
     QueryInfoList.member = Shapes::ShapeRef.new(shape: QueryInfo)
 
+    QueryParameter.add_member(:name, Shapes::ShapeRef.new(shape: QueryParameterName, required: true, location_name: "name"))
+    QueryParameter.add_member(:default_value, Shapes::ShapeRef.new(shape: QueryParameterDefaultValue, location_name: "defaultValue"))
+    QueryParameter.add_member(:description, Shapes::ShapeRef.new(shape: QueryParameterDescription, location_name: "description"))
+    QueryParameter.struct_class = Types::QueryParameter
+
+    QueryParameterList.member = Shapes::ShapeRef.new(shape: QueryParameter)
+
     QueryResults.member = Shapes::ShapeRef.new(shape: ResultRows)
 
     QueryStatistics.add_member(:records_matched, Shapes::ShapeRef.new(shape: StatsValue, location_name: "recordsMatched"))
@@ -2168,6 +2182,8 @@ module Aws::CloudWatchLogs
 
     S3Configuration.add_member(:destination_identifier, Shapes::ShapeRef.new(shape: S3Uri, required: true, location_name: "destinationIdentifier"))
     S3Configuration.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, required: true, location_name: "roleArn"))
+    S3Configuration.add_member(:owner_account_id, Shapes::ShapeRef.new(shape: AccountId, location_name: "ownerAccountId"))
+    S3Configuration.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: KmsKeyId, location_name: "kmsKeyId"))
     S3Configuration.struct_class = Types::S3Configuration
 
     S3DeliveryConfiguration.add_member(:suffix_path, Shapes::ShapeRef.new(shape: DeliverySuffixPath, location_name: "suffixPath"))

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

@@ -1133,7 +1133,7 @@ module Aws::CloudWatchLogs
     #
     # @!attribute [rw] query_language
     #   The query language to use for the scheduled query. Valid values are
-    #   `LogsQL`, `PPL`, and `SQL`.
+    #   `CWLI`, `PPL`, and `SQL`.
     #   @return [String]
     #
     # @!attribute [rw] query_string
@@ -7507,6 +7507,9 @@ module Aws::CloudWatchLogs
     #   * For Amazon Bedrock AgentCore Identity, the valid values are
     #     `APPLICATION_LOGS` and `TRACES`.
     #
+    #   * For Amazon Bedrock AgentCore Memory, the valid values are
+    #     `APPLICATION_LOGS` and `TRACES`.
+    #
     #   * For Amazon Bedrock AgentCore Gateway, the valid values are
     #     `APPLICATION_LOGS` and `TRACES`.
     #
@@ -7521,6 +7524,10 @@ module Aws::CloudWatchLogs
     #     `AD_DECISION_SERVER_LOGS`, `MANIFEST_SERVICE_LOGS`, and
     #     `TRANSCODE_LOGS`.
     #
+    #   * For Amazon EKS Auto Mode, the valid values are
+    #     `AUTO_MODE_BLOCK_STORAGE_LOGS`, `AUTO_MODE_COMPUTE_LOGS`,
+    #     `AUTO_MODE_IPAM_LOGS`, and `AUTO_MODE_LOAD_BALANCING_LOGS`.
+    #
     #   * For Entity Resolution, the valid value is `WORKFLOW_LOGS`.
     #
     #   * For IAM Identity Center, the valid value is `ERROR_LOGS`.
@@ -7533,8 +7540,7 @@ module Aws::CloudWatchLogs
     #   * For PCS, the valid values are `PCS_SCHEDULER_LOGS` and
     #     `PCS_JOBCOMP_LOGS`.
     #
-    #   * For Quick Suite, the valid values are `CHAT_LOGS` and
-    #     `FEEDBACK_LOGS`.
+    #   * For Quick, the valid values are `CHAT_LOGS` and `FEEDBACK_LOGS`.
     #
     #   * For Amazon Web Services RTB Fabric, the valid values is
     #     `APPLICATION_LOGS`.
@@ -8003,6 +8009,15 @@ module Aws::CloudWatchLogs
     #   not need to pass this option.
     #   @return [String]
     #
+    # @!attribute [rw] parameters
+    #   Use this parameter to include specific query parameters as part of
+    #   your query definition. Query parameters are supported only for Logs
+    #   Insights QL queries. Query parameters allow you to use placeholder
+    #   variables in your query string that are substituted with values at
+    #   execution time. Use the `{{parameterName}}` syntax in your query
+    #   string to reference a parameter.
+    #   @return [Array<Types::QueryParameter>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/PutQueryDefinitionRequest AWS API Documentation
     #
     class PutQueryDefinitionRequest < Struct.new(
@@ -8011,7 +8026,8 @@ module Aws::CloudWatchLogs
       :query_definition_id,
       :log_group_names,
       :query_string,
-      :client_token)
+      :client_token,
+      :parameters)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -8337,6 +8353,12 @@ module Aws::CloudWatchLogs
     #   limited to, that list appears here.
     #   @return [Array<String>]
     #
+    # @!attribute [rw] parameters
+    #   If this query definition contains a list of query parameters that
+    #   define placeholder variables for the query string, that list appears
+    #   here.
+    #   @return [Array<Types::QueryParameter>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/QueryDefinition AWS API Documentation
     #
     class QueryDefinition < Struct.new(
@@ -8345,7 +8367,8 @@ module Aws::CloudWatchLogs
       :name,
       :query_string,
       :last_modified,
-      :log_group_names)
+      :log_group_names,
+      :parameters)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -8397,6 +8420,38 @@ module Aws::CloudWatchLogs
       include Aws::Structure
     end
 
+    # This structure defines a query parameter for a saved CloudWatch Logs
+    # Insights query definition. Query parameters are supported only for
+    # Logs Insights QL queries. They are placeholder variables that you can
+    # reference in a query string using the `{{parameterName}}` syntax. Each
+    # parameter can include a default value and a description.
+    #
+    # @!attribute [rw] name
+    #   The name of the query parameter. A query parameter name must start
+    #   with a letter or underscore, and contain only letters, digits, and
+    #   underscores.
+    #   @return [String]
+    #
+    # @!attribute [rw] default_value
+    #   The default value to use for this query parameter if no value is
+    #   supplied at execution time.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   A description of the query parameter that explains its purpose or
+    #   expected values.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/QueryParameter AWS API Documentation
+    #
+    class QueryParameter < Struct.new(
+      :name,
+      :default_value,
+      :description)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains the number of log events scanned by the query, the number of
     # log events that matched the query criteria, and the total number of
     # bytes in the log events that were scanned.
@@ -8712,11 +8767,22 @@ module Aws::CloudWatchLogs
     #   results to the specified Amazon S3 destination.
     #   @return [String]
     #
+    # @!attribute [rw] owner_account_id
+    #   The AWS accountId for the bucket owning account.
+    #   @return [String]
+    #
+    # @!attribute [rw] kms_key_id
+    #   The Amazon Resource Name (ARN) of the KMS encryption key. Must
+    #   belong to the same AWS Region as the destination Amazon S3 bucket.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/S3Configuration AWS API Documentation
     #
     class S3Configuration < Struct.new(
       :destination_identifier,
-      :role_arn)
+      :role_arn,
+      :owner_account_id,
+      :kms_key_id)
       SENSITIVE = []
       include Aws::Structure
     end

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.140.0'
+  GEM_VERSION = '1.141.0'
 
 end
 

data/sig/client.rbs

@@ -226,7 +226,9 @@ module Aws
                                     ?destination_configuration: {
                                       s3_configuration: {
                                         destination_identifier: ::String,
-                                        role_arn: ::String
+                                        role_arn: ::String,
+                                        owner_account_id: ::String?,
+                                        kms_key_id: ::String?
                                       }
                                     },
                                     ?schedule_start_time: ::Integer,
@@ -1220,7 +1222,14 @@ module Aws
                                   ?query_definition_id: ::String,
                                   ?log_group_names: Array[::String],
                                   query_string: ::String,
-                                  ?client_token: ::String
+                                  ?client_token: ::String,
+                                  ?parameters: Array[
+                                    {
+                                      name: ::String,
+                                      default_value: ::String?,
+                                      description: ::String?
+                                    },
+                                  ]
                                 ) -> _PutQueryDefinitionResponseSuccess
                               | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _PutQueryDefinitionResponseSuccess
 
@@ -1703,7 +1712,9 @@ module Aws
                                     ?destination_configuration: {
                                       s3_configuration: {
                                         destination_identifier: ::String,
-                                        role_arn: ::String
+                                        role_arn: ::String,
+                                        owner_account_id: ::String?,
+                                        kms_key_id: ::String?
                                       }
                                     },
                                     ?schedule_start_time: ::Integer,

data/sig/types.rbs

@@ -1751,6 +1751,7 @@ module Aws::CloudWatchLogs
       attr_accessor log_group_names: ::Array[::String]
       attr_accessor query_string: ::String
       attr_accessor client_token: ::String
+      attr_accessor parameters: ::Array[Types::QueryParameter]
       SENSITIVE: []
     end
 
@@ -1817,6 +1818,7 @@ module Aws::CloudWatchLogs
       attr_accessor query_string: ::String
       attr_accessor last_modified: ::Integer
       attr_accessor log_group_names: ::Array[::String]
+      attr_accessor parameters: ::Array[Types::QueryParameter]
       SENSITIVE: []
     end
 
@@ -1830,6 +1832,13 @@ module Aws::CloudWatchLogs
       SENSITIVE: []
     end
 
+    class QueryParameter
+      attr_accessor name: ::String
+      attr_accessor default_value: ::String
+      attr_accessor description: ::String
+      SENSITIVE: []
+    end
+
     class QueryStatistics
       attr_accessor records_matched: ::Float
       attr_accessor records_scanned: ::Float
@@ -1906,6 +1915,8 @@ module Aws::CloudWatchLogs
     class S3Configuration
       attr_accessor destination_identifier: ::String
       attr_accessor role_arn: ::String
+      attr_accessor owner_account_id: ::String
+      attr_accessor kms_key_id: ::String
       SENSITIVE: []
     end
 

metadata

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