aws-sdk-cloudwatchlogs 1.32.1 → 1.38.0

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing for info on making contributions:

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -37,6 +39,7 @@ module Aws::CloudWatchLogs
     class AssociateKmsKeyRequest < Struct.new(
       :log_group_name,
       :kms_key_id)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -55,6 +58,7 @@ module Aws::CloudWatchLogs
     #
     class CancelExportTaskRequest < Struct.new(
       :task_id)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -116,6 +120,7 @@ module Aws::CloudWatchLogs
       :to,
       :destination,
       :destination_prefix)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -127,6 +132,7 @@ module Aws::CloudWatchLogs
     #
     class CreateExportTaskResponse < Struct.new(
       :task_id)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -165,6 +171,7 @@ module Aws::CloudWatchLogs
       :log_group_name,
       :kms_key_id,
       :tags)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -189,6 +196,7 @@ module Aws::CloudWatchLogs
     class CreateLogStreamRequest < Struct.new(
       :log_group_name,
       :log_stream_name)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -201,6 +209,7 @@ module Aws::CloudWatchLogs
     #
     class DataAlreadyAcceptedException < Struct.new(
       :expected_sequence_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -219,6 +228,7 @@ module Aws::CloudWatchLogs
     #
     class DeleteDestinationRequest < Struct.new(
       :destination_name)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -237,6 +247,7 @@ module Aws::CloudWatchLogs
     #
     class DeleteLogGroupRequest < Struct.new(
       :log_group_name)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -261,6 +272,7 @@ module Aws::CloudWatchLogs
     class DeleteLogStreamRequest < Struct.new(
       :log_group_name,
       :log_stream_name)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -285,6 +297,7 @@ module Aws::CloudWatchLogs
     class DeleteMetricFilterRequest < Struct.new(
       :log_group_name,
       :filter_name)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -296,22 +309,33 @@ module Aws::CloudWatchLogs
     #       }
     #
     # @!attribute [rw] query_definition_id
+    #   The ID of the query definition that you want to delete. You can use
+    #   [DescribeQueryDefinitions][1] to retrieve the IDs of your saved
+    #   query definitions.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeQueryDefinitions.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/DeleteQueryDefinitionRequest AWS API Documentation
     #
     class DeleteQueryDefinitionRequest < Struct.new(
       :query_definition_id)
+      SENSITIVE = []
       include Aws::Structure
     end
 
     # @!attribute [rw] success
+    #   A value of TRUE indicates that the operation succeeded. FALSE
+    #   indicates that the operation failed.
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/DeleteQueryDefinitionResponse AWS API Documentation
     #
     class DeleteQueryDefinitionResponse < Struct.new(
       :success)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -330,6 +354,7 @@ module Aws::CloudWatchLogs
     #
     class DeleteResourcePolicyRequest < Struct.new(
       :policy_name)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -348,6 +373,7 @@ module Aws::CloudWatchLogs
     #
     class DeleteRetentionPolicyRequest < Struct.new(
       :log_group_name)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -372,6 +398,7 @@ module Aws::CloudWatchLogs
     class DeleteSubscriptionFilterRequest < Struct.new(
       :log_group_name,
       :filter_name)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -405,6 +432,7 @@ module Aws::CloudWatchLogs
       :destination_name_prefix,
       :next_token,
       :limit)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -422,6 +450,7 @@ module Aws::CloudWatchLogs
     class DescribeDestinationsResponse < Struct.new(
       :destinations,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -462,6 +491,7 @@ module Aws::CloudWatchLogs
       :status_code,
       :next_token,
       :limit)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -479,6 +509,7 @@ module Aws::CloudWatchLogs
     class DescribeExportTasksResponse < Struct.new(
       :export_tasks,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -511,11 +542,15 @@ module Aws::CloudWatchLogs
       :log_group_name_prefix,
       :next_token,
       :limit)
+      SENSITIVE = []
       include Aws::Structure
     end
 
     # @!attribute [rw] log_groups
     #   The log groups.
+    #
+    #   If the `retentionInDays` value if not included for a log group, then
+    #   that log group is set to have its events never expire.
     #   @return [Array<Types::LogGroup>]
     #
     # @!attribute [rw] next_token
@@ -528,6 +563,7 @@ module Aws::CloudWatchLogs
     class DescribeLogGroupsResponse < Struct.new(
       :log_groups,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -550,7 +586,7 @@ module Aws::CloudWatchLogs
     # @!attribute [rw] log_stream_name_prefix
     #   The prefix to match.
     #
-    #   If `orderBy` is `LastEventTime`,you cannot specify this parameter.
+    #   If `orderBy` is `LastEventTime`, you cannot specify this parameter.
     #   @return [String]
     #
     # @!attribute [rw] order_by
@@ -561,12 +597,12 @@ module Aws::CloudWatchLogs
     #   If you order the results by event time, you cannot specify the
     #   `logStreamNamePrefix` parameter.
     #
-    #   lastEventTimestamp represents the time of the most recent log event
-    #   in the log stream in CloudWatch Logs. This number is expressed as
-    #   the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
-    #   lastEventTimeStamp updates on an eventual consistency basis. It
-    #   typically updates in less than an hour from ingestion, but may take
-    #   longer in some rare situations.
+    #   `lastEventTimeStamp` represents the time of the most recent log
+    #   event in the log stream in CloudWatch Logs. This number is expressed
+    #   as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
+    #   `lastEventTimeStamp` updates on an eventual consistency basis. It
+    #   typically updates in less than an hour from ingestion, but in rare
+    #   situations might take longer.
     #   @return [String]
     #
     # @!attribute [rw] descending
@@ -594,6 +630,7 @@ module Aws::CloudWatchLogs
       :descending,
       :next_token,
       :limit)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -611,6 +648,7 @@ module Aws::CloudWatchLogs
     class DescribeLogStreamsResponse < Struct.new(
       :log_streams,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -631,7 +669,9 @@ module Aws::CloudWatchLogs
     #   @return [String]
     #
     # @!attribute [rw] filter_name_prefix
-    #   The prefix to match.
+    #   The prefix to match. CloudWatch Logs uses the value you set here
+    #   only if you also include the `logGroupName` parameter in your
+    #   request.
     #   @return [String]
     #
     # @!attribute [rw] next_token
@@ -665,6 +705,7 @@ module Aws::CloudWatchLogs
       :limit,
       :metric_name,
       :metric_namespace)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -682,6 +723,7 @@ module Aws::CloudWatchLogs
     class DescribeMetricFiltersResponse < Struct.new(
       :metric_filters,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -722,6 +764,7 @@ module Aws::CloudWatchLogs
       :status,
       :max_results,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -739,6 +782,7 @@ module Aws::CloudWatchLogs
     class DescribeQueriesResponse < Struct.new(
       :queries,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -752,9 +796,13 @@ module Aws::CloudWatchLogs
     #       }
     #
     # @!attribute [rw] query_definition_name_prefix
+    #   Use this parameter to filter your results to only the query
+    #   definitions that have names that start with the prefix you specify.
     #   @return [String]
     #
     # @!attribute [rw] max_results
+    #   Limits the number of returned query definitions to the specified
+    #   number.
     #   @return [Integer]
     #
     # @!attribute [rw] next_token
@@ -768,10 +816,12 @@ module Aws::CloudWatchLogs
       :query_definition_name_prefix,
       :max_results,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
     # @!attribute [rw] query_definitions
+    #   The list of query definitions that match your request.
     #   @return [Array<Types::QueryDefinition>]
     #
     # @!attribute [rw] next_token
@@ -784,6 +834,7 @@ module Aws::CloudWatchLogs
     class DescribeQueryDefinitionsResponse < Struct.new(
       :query_definitions,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -810,6 +861,7 @@ module Aws::CloudWatchLogs
     class DescribeResourcePoliciesRequest < Struct.new(
       :next_token,
       :limit)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -827,6 +879,7 @@ module Aws::CloudWatchLogs
     class DescribeResourcePoliciesResponse < Struct.new(
       :resource_policies,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -866,6 +919,7 @@ module Aws::CloudWatchLogs
       :filter_name_prefix,
       :next_token,
       :limit)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -883,6 +937,7 @@ module Aws::CloudWatchLogs
     class DescribeSubscriptionFiltersResponse < Struct.new(
       :subscription_filters,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -894,8 +949,8 @@ module Aws::CloudWatchLogs
     #   @return [String]
     #
     # @!attribute [rw] target_arn
-    #   The Amazon Resource Name (ARN) of the physical target to where the
-    #   log events are delivered (for example, a Kinesis stream).
+    #   The Amazon Resource Name (ARN) of the physical target where the log
+    #   events are delivered (for example, a Kinesis stream).
     #   @return [String]
     #
     # @!attribute [rw] role_arn
@@ -926,6 +981,7 @@ module Aws::CloudWatchLogs
       :access_policy,
       :arn,
       :creation_time)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -944,6 +1000,7 @@ module Aws::CloudWatchLogs
     #
     class DisassociateKmsKeyRequest < Struct.new(
       :log_group_name)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -974,7 +1031,7 @@ module Aws::CloudWatchLogs
     #   @return [Integer]
     #
     # @!attribute [rw] destination
-    #   The name of Amazon S3 bucket to which the log data was exported.
+    #   The name of the S3 bucket to which the log data was exported.
     #   @return [String]
     #
     # @!attribute [rw] destination_prefix
@@ -987,7 +1044,7 @@ module Aws::CloudWatchLogs
     #   @return [Types::ExportTaskStatus]
     #
     # @!attribute [rw] execution_info
-    #   Execution info about the export task.
+    #   Execution information about the export task.
     #   @return [Types::ExportTaskExecutionInfo]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/ExportTask AWS API Documentation
@@ -1002,6 +1059,7 @@ module Aws::CloudWatchLogs
       :destination_prefix,
       :status,
       :execution_info)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1022,6 +1080,7 @@ module Aws::CloudWatchLogs
     class ExportTaskExecutionInfo < Struct.new(
       :creation_time,
       :completion_time)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1040,6 +1099,7 @@ module Aws::CloudWatchLogs
     class ExportTaskStatus < Struct.new(
       :code,
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1084,6 +1144,9 @@ module Aws::CloudWatchLogs
     #   The start of the time range, expressed as the number of milliseconds
     #   after Jan 1, 1970 00:00:00 UTC. Events with a timestamp before this
     #   time are not returned.
+    #
+    #   If you omit `startTime` and `endTime` the most recent log events are
+    #   retrieved, to up 1 MB or 10,000 log events.
     #   @return [Integer]
     #
     # @!attribute [rw] end_time
@@ -1121,10 +1184,10 @@ module Aws::CloudWatchLogs
     #   first, then those in the next log stream, and so on. The default is
     #   false.
     #
-    #   **IMPORTANT:** 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.
+    #   **Important:** Starting on June 17, 2019, this parameter is ignored
+    #   and the value is assumed to be true. The response from this
+    #   operation always interleaves events from multiple log streams within
+    #   a log group.
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/FilterLogEventsRequest AWS API Documentation
@@ -1139,6 +1202,7 @@ module Aws::CloudWatchLogs
       :next_token,
       :limit,
       :interleaved)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1147,6 +1211,10 @@ module Aws::CloudWatchLogs
     #   @return [Array<Types::FilteredLogEvent>]
     #
     # @!attribute [rw] searched_log_streams
+    #   **IMPORTANT** Starting on May 15, 2020, this parameter will be
+    #   deprecated. This parameter will be an empty list after the
+    #   deprecation occurs.
+    #
     #   Indicates which log streams have been searched and whether each has
     #   been searched completely.
     #   @return [Array<Types::SearchedLogStream>]
@@ -1162,6 +1230,7 @@ module Aws::CloudWatchLogs
       :events,
       :searched_log_streams,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1197,6 +1266,7 @@ module Aws::CloudWatchLogs
       :message,
       :ingestion_time,
       :event_id)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1267,6 +1337,7 @@ module Aws::CloudWatchLogs
       :next_token,
       :limit,
       :start_from_head)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1277,14 +1348,14 @@ module Aws::CloudWatchLogs
     # @!attribute [rw] next_forward_token
     #   The token for the next set of items in the forward direction. The
     #   token expires after 24 hours. If you have reached the end of the
-    #   stream, it will return the same token you passed in.
+    #   stream, it returns the same token you passed in.
     #   @return [String]
     #
     # @!attribute [rw] next_backward_token
     #   The token for the next set of items in the backward direction. The
-    #   token expires after 24 hours. This token will never be null. If you
-    #   have reached the end of the stream, it will return the same token
-    #   you passed in.
+    #   token expires after 24 hours. This token is never null. If you have
+    #   reached the end of the stream, it returns the same token you passed
+    #   in.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/GetLogEventsResponse AWS API Documentation
@@ -1293,6 +1364,7 @@ module Aws::CloudWatchLogs
       :events,
       :next_forward_token,
       :next_backward_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1322,6 +1394,7 @@ module Aws::CloudWatchLogs
     class GetLogGroupFieldsRequest < Struct.new(
       :log_group_name,
       :time)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1335,6 +1408,7 @@ module Aws::CloudWatchLogs
     #
     class GetLogGroupFieldsResponse < Struct.new(
       :log_group_fields)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1357,6 +1431,7 @@ module Aws::CloudWatchLogs
     #
     class GetLogRecordRequest < Struct.new(
       :log_record_pointer)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1368,6 +1443,7 @@ module Aws::CloudWatchLogs
     #
     class GetLogRecordResponse < Struct.new(
       :log_record)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1386,6 +1462,7 @@ module Aws::CloudWatchLogs
     #
     class GetQueryResultsRequest < Struct.new(
       :query_id)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1401,7 +1478,8 @@ module Aws::CloudWatchLogs
     # @!attribute [rw] statistics
     #   Includes 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.
+    #   of bytes in the log events that were scanned. These values reflect
+    #   the full raw results of the query.
     #   @return [Types::QueryStatistics]
     #
     # @!attribute [rw] status
@@ -1410,7 +1488,7 @@ module Aws::CloudWatchLogs
     #   `Timeout`, and `Unknown`.
     #
     #   Queries time out after 15 minutes of execution. To avoid having your
-    #   queries time out, reduce the time range being searched, or partition
+    #   queries time out, reduce the time range being searched or partition
     #   your query into a number of queries.
     #   @return [String]
     #
@@ -1420,6 +1498,7 @@ module Aws::CloudWatchLogs
       :results,
       :statistics,
       :status)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1448,6 +1527,7 @@ module Aws::CloudWatchLogs
     class InputLogEvent < Struct.new(
       :timestamp,
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1474,6 +1554,7 @@ module Aws::CloudWatchLogs
     #
     class InvalidSequenceTokenException < Struct.new(
       :expected_sequence_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1498,6 +1579,7 @@ module Aws::CloudWatchLogs
     #
     class ListTagsLogGroupRequest < Struct.new(
       :log_group_name)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1509,6 +1591,7 @@ module Aws::CloudWatchLogs
     #
     class ListTagsLogGroupResponse < Struct.new(
       :tags)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1527,6 +1610,9 @@ module Aws::CloudWatchLogs
     #   The number of days to retain the log events in the specified log
     #   group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150,
     #   180, 365, 400, 545, 731, 1827, and 3653.
+    #
+    #   If you omit `retentionInDays` in a `PutRetentionPolicy` operation,
+    #   the events in the log group are always retained and never expire.
     #   @return [Integer]
     #
     # @!attribute [rw] metric_filter_count
@@ -1556,6 +1642,7 @@ module Aws::CloudWatchLogs
       :arn,
       :stored_bytes,
       :kms_key_id)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1576,6 +1663,7 @@ module Aws::CloudWatchLogs
     class LogGroupField < Struct.new(
       :name,
       :percent)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1601,8 +1689,8 @@ module Aws::CloudWatchLogs
     #   CloudWatch Logs. This number is expressed as the number of
     #   milliseconds after Jan 1, 1970 00:00:00 UTC. The `lastEventTime`
     #   value updates on an eventual consistency basis. It typically updates
-    #   in less than an hour from ingestion, but may take longer in some
-    #   rare situations.
+    #   in less than an hour from ingestion, but in rare situations might
+    #   take longer.
     #   @return [Integer]
     #
     # @!attribute [rw] last_ingestion_time
@@ -1621,7 +1709,7 @@ module Aws::CloudWatchLogs
     # @!attribute [rw] stored_bytes
     #   The number of bytes stored.
     #
-    #   **IMPORTANT:**On June 17, 2019, this parameter was deprecated for
+    #   **Important:** On June 17, 2019, this parameter was deprecated for
     #   log streams, and is always reported as zero. This change applies
     #   only to log streams. The `storedBytes` parameter for log groups is
     #   not affected.
@@ -1638,12 +1726,13 @@ module Aws::CloudWatchLogs
       :upload_sequence_token,
       :arn,
       :stored_bytes)
+      SENSITIVE = []
       include Aws::Structure
     end
 
     # The query string is not valid. Details about this error are displayed
     # in a `QueryCompileError` object. For more information, see
-    # [QueryCompileError][1]"/&gt;.
+    # [QueryCompileError][1].
     #
     # For more information about valid query syntax, see [CloudWatch Logs
     # Insights Query Syntax][2].
@@ -1661,6 +1750,7 @@ module Aws::CloudWatchLogs
     #
     class MalformedQueryException < Struct.new(
       :query_compile_error)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1674,7 +1764,7 @@ module Aws::CloudWatchLogs
     #
     # @!attribute [rw] filter_pattern
     #   A symbolic description of how CloudWatch Logs should interpret the
-    #   data in each log event. For example, a log event may contain
+    #   data in each log event. For example, a log event can contain
     #   timestamps, IP addresses, strings, and so on. You use the filter
     #   pattern to specify what to look for in the log event message.
     #   @return [String]
@@ -1700,6 +1790,7 @@ module Aws::CloudWatchLogs
       :metric_transformations,
       :creation_time,
       :log_group_name)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1723,6 +1814,7 @@ module Aws::CloudWatchLogs
       :event_number,
       :event_message,
       :extracted_values)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1770,6 +1862,7 @@ module Aws::CloudWatchLogs
       :metric_namespace,
       :metric_value,
       :default_value)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1801,6 +1894,7 @@ module Aws::CloudWatchLogs
       :timestamp,
       :message,
       :ingestion_time)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1818,7 +1912,8 @@ module Aws::CloudWatchLogs
     #
     # @!attribute [rw] access_policy
     #   An IAM policy document that authorizes cross-account users to
-    #   deliver their log events to the associated destination.
+    #   deliver their log events to the associated destination. This can be
+    #   up to 5120 bytes.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/PutDestinationPolicyRequest AWS API Documentation
@@ -1826,6 +1921,7 @@ module Aws::CloudWatchLogs
     class PutDestinationPolicyRequest < Struct.new(
       :destination_name,
       :access_policy)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1849,7 +1945,7 @@ module Aws::CloudWatchLogs
     #
     # @!attribute [rw] role_arn
     #   The ARN of an IAM role that grants CloudWatch Logs permissions to
-    #   call the Amazon Kinesis PutRecord operation on the destination
+    #   call the Amazon Kinesis `PutRecord` operation on the destination
     #   stream.
     #   @return [String]
     #
@@ -1859,6 +1955,7 @@ module Aws::CloudWatchLogs
       :destination_name,
       :target_arn,
       :role_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1870,6 +1967,7 @@ module Aws::CloudWatchLogs
     #
     class PutDestinationResponse < Struct.new(
       :destination)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1906,7 +2004,7 @@ module Aws::CloudWatchLogs
     #   not require a sequence token. You can also get the sequence token
     #   using [DescribeLogStreams][1]. If you call `PutLogEvents` twice
     #   within a narrow time period using the same value for
-    #   `sequenceToken`, both calls may be successful, or one may be
+    #   `sequenceToken`, both calls might be successful or one might be
     #   rejected.
     #
     #
@@ -1921,6 +2019,7 @@ module Aws::CloudWatchLogs
       :log_stream_name,
       :log_events,
       :sequence_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1937,6 +2036,7 @@ module Aws::CloudWatchLogs
     class PutLogEventsResponse < Struct.new(
       :next_sequence_token,
       :rejected_log_events_info)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1982,6 +2082,7 @@ module Aws::CloudWatchLogs
       :filter_name,
       :filter_pattern,
       :metric_transformations)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1996,15 +2097,47 @@ module Aws::CloudWatchLogs
     #       }
     #
     # @!attribute [rw] name
+    #   A name for the query definition. If you are saving a lot of query
+    #   definitions, we recommend that you name them so that you can easily
+    #   find the ones you want by using the first part of the name as a
+    #   filter in the `queryDefinitionNamePrefix` parameter of
+    #   [DescribeQueryDefinitions][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeQueryDefinitions.html
     #   @return [String]
     #
     # @!attribute [rw] query_definition_id
+    #   If you are updating a query definition, use this parameter to
+    #   specify the ID of the query definition that you want to update. You
+    #   can use [DescribeQueryDefinitions][1] to retrieve the IDs of your
+    #   saved query definitions.
+    #
+    #   If you are creating a query definition, do not specify this
+    #   parameter. CloudWatch generates a unique ID for the new query
+    #   definition and include it in the response to this operation.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeQueryDefinitions.html
     #   @return [String]
     #
     # @!attribute [rw] log_group_names
+    #   Use this parameter to include specific log groups as part of your
+    #   query definition.
+    #
+    #   If you are updating a query definition and you omit this parameter,
+    #   then the updated definition will contain no log groups.
     #   @return [Array<String>]
     #
     # @!attribute [rw] query_string
+    #   The query string to use for this definition. For more information,
+    #   see [CloudWatch Logs Insights Query Syntax][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/PutQueryDefinitionRequest AWS API Documentation
@@ -2014,16 +2147,19 @@ module Aws::CloudWatchLogs
       :query_definition_id,
       :log_group_names,
       :query_string)
+      SENSITIVE = []
       include Aws::Structure
     end
 
     # @!attribute [rw] query_definition_id
+    #   The ID of the query definition.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/PutQueryDefinitionResponse AWS API Documentation
     #
     class PutQueryDefinitionResponse < Struct.new(
       :query_definition_id)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2046,7 +2182,7 @@ module Aws::CloudWatchLogs
     #
     #   The following example creates a resource policy enabling the Route
     #   53 service to put DNS query logs in to the specified log group.
-    #   Replace "logArn" with the ARN of your CloudWatch Logs resource,
+    #   Replace `"logArn"` with the ARN of your CloudWatch Logs resource,
     #   such as a log group or log stream.
     #
     #   `\{ "Version": "2012-10-17", "Statement": [ \{ "Sid":
@@ -2060,6 +2196,7 @@ module Aws::CloudWatchLogs
     class PutResourcePolicyRequest < Struct.new(
       :policy_name,
       :policy_document)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2071,6 +2208,7 @@ module Aws::CloudWatchLogs
     #
     class PutResourcePolicyResponse < Struct.new(
       :resource_policy)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2090,6 +2228,9 @@ module Aws::CloudWatchLogs
     #   The number of days to retain the log events in the specified log
     #   group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150,
     #   180, 365, 400, 545, 731, 1827, and 3653.
+    #
+    #   If you omit `retentionInDays` in a `PutRetentionPolicy` operation,
+    #   the events in the log group are always retained and never expire.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/PutRetentionPolicyRequest AWS API Documentation
@@ -2097,6 +2238,7 @@ module Aws::CloudWatchLogs
     class PutRetentionPolicyRequest < Struct.new(
       :log_group_name,
       :retention_in_days)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2158,7 +2300,7 @@ module Aws::CloudWatchLogs
     #
     # @!attribute [rw] distribution
     #   The method used to distribute log data to the destination. By
-    #   default log data is grouped by log stream, but the grouping can be
+    #   default, log data is grouped by log stream, but the grouping can be
     #   set to random for a more even distribution. This property is only
     #   applicable when the destination is an Amazon Kinesis stream.
     #   @return [String]
@@ -2172,6 +2314,7 @@ module Aws::CloudWatchLogs
       :destination_arn,
       :role_arn,
       :distribution)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2190,6 +2333,7 @@ module Aws::CloudWatchLogs
     class QueryCompileError < Struct.new(
       :location,
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2208,22 +2352,37 @@ module Aws::CloudWatchLogs
     class QueryCompileErrorLocation < Struct.new(
       :start_char_offset,
       :end_char_offset)
+      SENSITIVE = []
       include Aws::Structure
     end
 
+    # This structure contains details about a saved CloudWatch Logs Insights
+    # query definition.
+    #
     # @!attribute [rw] query_definition_id
+    #   The unique ID of the query definition.
     #   @return [String]
     #
     # @!attribute [rw] name
+    #   The name of the query definition.
     #   @return [String]
     #
     # @!attribute [rw] query_string
+    #   The query string to use for this definition. For more information,
+    #   see [CloudWatch Logs Insights Query Syntax][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html
     #   @return [String]
     #
     # @!attribute [rw] last_modified
+    #   The date that the query definition was most recently modified.
     #   @return [Integer]
     #
     # @!attribute [rw] log_group_names
+    #   If this query definition contains a list of log groups that it is
+    #   limited to, that list appears here.
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/QueryDefinition AWS API Documentation
@@ -2234,6 +2393,7 @@ module Aws::CloudWatchLogs
       :query_string,
       :last_modified,
       :log_group_names)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2269,6 +2429,7 @@ module Aws::CloudWatchLogs
       :status,
       :create_time,
       :log_group_name)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2295,6 +2456,7 @@ module Aws::CloudWatchLogs
       :records_matched,
       :records_scanned,
       :bytes_scanned)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2318,6 +2480,7 @@ module Aws::CloudWatchLogs
       :too_new_log_event_start_index,
       :too_old_log_event_end_index,
       :expired_log_event_end_index)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2355,6 +2518,7 @@ module Aws::CloudWatchLogs
       :policy_name,
       :policy_document,
       :last_updated_time)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2381,6 +2545,7 @@ module Aws::CloudWatchLogs
     class ResultField < Struct.new(
       :field,
       :value)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2399,6 +2564,7 @@ module Aws::CloudWatchLogs
     class SearchedLogStream < Struct.new(
       :log_stream_name,
       :searched_completely)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2472,6 +2638,7 @@ module Aws::CloudWatchLogs
       :end_time,
       :query_string,
       :limit)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2483,6 +2650,7 @@ module Aws::CloudWatchLogs
     #
     class StartQueryResponse < Struct.new(
       :query_id)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2494,14 +2662,15 @@ module Aws::CloudWatchLogs
     #       }
     #
     # @!attribute [rw] query_id
-    #   The ID number of the query to stop. If necessary, you can use
-    #   `DescribeQueries` to find this ID number.
+    #   The ID number of the query to stop. To find this ID number, use
+    #   `DescribeQueries`.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/StopQueryRequest AWS API Documentation
     #
     class StopQueryRequest < Struct.new(
       :query_id)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2513,6 +2682,7 @@ module Aws::CloudWatchLogs
     #
     class StopQueryResponse < Struct.new(
       :success)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2528,7 +2698,7 @@ module Aws::CloudWatchLogs
     #
     # @!attribute [rw] filter_pattern
     #   A symbolic description of how CloudWatch Logs should interpret the
-    #   data in each log event. For example, a log event may contain
+    #   data in each log event. For example, a log event can contain
     #   timestamps, IP addresses, strings, and so on. You use the filter
     #   pattern to specify what to look for in the log event message.
     #   @return [String]
@@ -2560,6 +2730,7 @@ module Aws::CloudWatchLogs
       :role_arn,
       :distribution,
       :creation_time)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2586,6 +2757,7 @@ module Aws::CloudWatchLogs
     class TagLogGroupRequest < Struct.new(
       :log_group_name,
       :tags)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2599,7 +2771,7 @@ module Aws::CloudWatchLogs
     #
     # @!attribute [rw] filter_pattern
     #   A symbolic description of how CloudWatch Logs should interpret the
-    #   data in each log event. For example, a log event may contain
+    #   data in each log event. For example, a log event can contain
     #   timestamps, IP addresses, strings, and so on. You use the filter
     #   pattern to specify what to look for in the log event message.
     #   @return [String]
@@ -2613,6 +2785,7 @@ module Aws::CloudWatchLogs
     class TestMetricFilterRequest < Struct.new(
       :filter_pattern,
       :log_event_messages)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2624,6 +2797,7 @@ module Aws::CloudWatchLogs
     #
     class TestMetricFilterResponse < Struct.new(
       :matches)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2654,6 +2828,7 @@ module Aws::CloudWatchLogs
     class UntagLogGroupRequest < Struct.new(
       :log_group_name,
       :tags)
+      SENSITIVE = []
       include Aws::Structure
     end