aws-sdk-cloudwatchlogs 1.29.0 → 1.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 761b5b6b3c18b8da8e3bddebd07887b80bf71e6e
-  data.tar.gz: afed7ad404ca06a4cd5fbfbf4201acee566de156
+SHA256:
+  metadata.gz: 7728d5e9c973506c4111bae98f65dc2c5a8c1150e6c7e5a40e401d21292dfdfa
+  data.tar.gz: 5317ff2c0f6136f8db3706a75bb4744f16ee2abd022373c2d6d19cd9bbc540b1
 SHA512:
-  metadata.gz: 69525de787a9959bcc6ebb3bb814db5c11a1ddbdb086dcdb004bc38ab0c936fe051e9589da3eefb9f308a227c4af175ea87c2c04c7686f0c791dc1ab1841dcc1
-  data.tar.gz: 860afa8c3c883f4bf05cfd8fc89870d9d9a93d5392e89f16facc54e723587c201bc667551ff8b887149377d569c73c9937229143fddf8404b6943c69b06c758e
+  metadata.gz: 16c7ccdfa2831bb17219ae5f74a176856d23ab1ef83eda99562a12e5506c9197dd08eca5a5fad96d5542cd06253dcd8ba0aeb6225c4813345d1083ece53a3afa
+  data.tar.gz: 28ceee4fc7d41b1382923f7c0e7a85a569737c593bb7dfe209e3d8c39f472774725280fe2775afcac21a5d133219f29a8c872b577db336d7be9df01ff207abfb

data/lib/aws-sdk-cloudwatchlogs.rb

@@ -45,6 +45,6 @@ require_relative 'aws-sdk-cloudwatchlogs/customizations'
 # @service
 module Aws::CloudWatchLogs
 
-  GEM_VERSION = '1.29.0'
+  GEM_VERSION = '1.30.0'
 
 end

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

@@ -32,11 +32,11 @@ Aws::Plugins::GlobalConfiguration.add_identifier(:cloudwatchlogs)
 module Aws::CloudWatchLogs
   # An API client for CloudWatchLogs.  To construct a client, you need to configure a `:region` and `:credentials`.
   #
-  #   client = Aws::CloudWatchLogs::Client.new(
-  #     region: region_name,
-  #     credentials: credentials,
-  #     # ...
-  #   )
+  #     client = Aws::CloudWatchLogs::Client.new(
+  #       region: region_name,
+  #       credentials: credentials,
+  #       # ...
+  #     )
   #
   # For details on configuring region and credentials see
   # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
@@ -105,7 +105,7 @@ module Aws::CloudWatchLogs
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
     #     used to determine the service `:endpoint`. When not passed,
-    #     a default `:region` is search for in the following locations:
+    #     a default `:region` is searched for in the following locations:
     #
     #     * `Aws.config[:region]`
     #     * `ENV['AWS_REGION']`
@@ -161,7 +161,7 @@ module Aws::CloudWatchLogs
     #   @option options [String] :endpoint
     #     The client endpoint is normally constructed from the `:region`
     #     option. You should only configure an `:endpoint` when connecting
-    #     to test endpoints. This should be avalid HTTP(S) URI.
+    #     to test endpoints. This should be a valid HTTP(S) URI.
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -229,15 +229,19 @@ module Aws::CloudWatchLogs
     #
     #   @option options [String] :retry_mode ("legacy")
     #     Specifies which retry algorithm to use. Values are:
-    #       * `legacy` - The pre-existing retry behavior.  This is default value if
-    #         no retry mode is provided.
-    #       * `standard` - A standardized set of retry rules across the AWS SDKs.
-    #         This includes support for retry quotas, which limit the number of
-    #         unsuccessful retries a client can make.
-    #       * `adaptive` - An experimental retry mode that includes all the
-    #         functionality of `standard` mode along with automatic client side
-    #         throttling.  This is a provisional mode that may change behavior
-    #         in the future.
+    #
+    #     * `legacy` - The pre-existing retry behavior.  This is default value if
+    #       no retry mode is provided.
+    #
+    #     * `standard` - A standardized set of retry rules across the AWS SDKs.
+    #       This includes support for retry quotas, which limit the number of
+    #       unsuccessful retries a client can make.
+    #
+    #     * `adaptive` - An experimental retry mode that includes all the
+    #       functionality of `standard` mode along with automatic client side
+    #       throttling.  This is a provisional mode that may change behavior
+    #       in the future.
+    #
     #
     #   @option options [String] :secret_access_key
     #
@@ -275,8 +279,7 @@ module Aws::CloudWatchLogs
     #
     #   @option options [Integer] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
-    #     safely be set
-    #     per-request on the session yielded by {#session_for}.
+    #     safely be set per-request on the session.
     #
     #   @option options [Float] :http_idle_timeout (5) The number of
     #     seconds a connection is allowed to sit idle before it is
@@ -288,7 +291,7 @@ module Aws::CloudWatchLogs
     #     request body.  This option has no effect unless the request has
     #     "Expect" header set to "100-continue".  Defaults to `nil` which
     #     disables this behaviour.  This value can safely be set per
-    #     request on the session yielded by {#session_for}.
+    #     request on the session.
     #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
@@ -405,9 +408,9 @@ module Aws::CloudWatchLogs
     # This is an asynchronous call. If all the required information is
     # provided, this operation initiates an export task and responds with
     # the ID of the task. After the task has started, you can use
-    # DescribeExportTasks to get the status of the export task. Each account
-    # can only have one active (`RUNNING` or `PENDING`) export task at a
-    # time. To cancel an export task, use CancelExportTask.
+    # [DescribeExportTasks][1] to get the status of the export task. Each
+    # account can only have one active (`RUNNING` or `PENDING`) export task
+    # at a time. To cancel an export task, use [CancelExportTask][2].
     #
     # You can export logs from multiple log groups or multiple time ranges
     # to the same S3 bucket. To separate out log data for each export task,
@@ -417,6 +420,11 @@ module Aws::CloudWatchLogs
     # Exporting to S3 buckets that are encrypted with AES-256 is supported.
     # Exporting to S3 buckets encrypted with SSE-KMS is not supported.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeExportTasks.html
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CancelExportTask.html
+    #
     # @option params [String] :task_name
     #   The name of the export task.
     #
@@ -682,6 +690,31 @@ module Aws::CloudWatchLogs
       req.send_request(options)
     end
 
+    # @option params [required, String] :query_definition_id
+    #
+    # @return [Types::DeleteQueryDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DeleteQueryDefinitionResponse#success #success} => Boolean
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_query_definition({
+    #     query_definition_id: "QueryId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.success #=> Boolean
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/DeleteQueryDefinition AWS API Documentation
+    #
+    # @overload delete_query_definition(params = {})
+    # @param [Hash] params ({})
+    def delete_query_definition(params = {}, options = {})
+      req = build_request(:delete_query_definition, params)
+      req.send_request(options)
+    end
+
     # Deletes a resource policy from this account. This revokes the access
     # of the identities in that policy to put log events to this account.
     #
@@ -776,6 +809,8 @@ module Aws::CloudWatchLogs
     #   * {Types::DescribeDestinationsResponse#destinations #destinations} => Array<Types::Destination>
     #   * {Types::DescribeDestinationsResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_destinations({
@@ -882,6 +917,8 @@ module Aws::CloudWatchLogs
     #   * {Types::DescribeLogGroupsResponse#log_groups #log_groups} => Array<Types::LogGroup>
     #   * {Types::DescribeLogGroupsResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_log_groups({
@@ -959,6 +996,8 @@ module Aws::CloudWatchLogs
     #   * {Types::DescribeLogStreamsResponse#log_streams #log_streams} => Array<Types::LogStream>
     #   * {Types::DescribeLogStreamsResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_log_streams({
@@ -1025,6 +1064,8 @@ module Aws::CloudWatchLogs
     #   * {Types::DescribeMetricFiltersResponse#metric_filters #metric_filters} => Array<Types::MetricFilter>
     #   * {Types::DescribeMetricFiltersResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_metric_filters({
@@ -1112,6 +1153,47 @@ module Aws::CloudWatchLogs
       req.send_request(options)
     end
 
+    # @option params [String] :query_definition_name_prefix
+    #
+    # @option params [Integer] :max_results
+    #
+    # @option params [String] :next_token
+    #   The token for the next set of items to return. The token expires after
+    #   24 hours.
+    #
+    # @return [Types::DescribeQueryDefinitionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeQueryDefinitionsResponse#query_definitions #query_definitions} => Array<Types::QueryDefinition>
+    #   * {Types::DescribeQueryDefinitionsResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_query_definitions({
+    #     query_definition_name_prefix: "QueryDefinitionName",
+    #     max_results: 1,
+    #     next_token: "NextToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.query_definitions #=> Array
+    #   resp.query_definitions[0].query_definition_id #=> String
+    #   resp.query_definitions[0].name #=> String
+    #   resp.query_definitions[0].query_string #=> String
+    #   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.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/DescribeQueryDefinitions AWS API Documentation
+    #
+    # @overload describe_query_definitions(params = {})
+    # @param [Hash] params ({})
+    def describe_query_definitions(params = {}, options = {})
+      req = build_request(:describe_query_definitions, params)
+      req.send_request(options)
+    end
+
     # Lists the resource policies in this account.
     #
     # @option params [String] :next_token
@@ -1175,6 +1257,8 @@ module Aws::CloudWatchLogs
     #   * {Types::DescribeSubscriptionFiltersResponse#subscription_filters #subscription_filters} => Array<Types::SubscriptionFilter>
     #   * {Types::DescribeSubscriptionFiltersResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_subscription_filters({
@@ -1311,6 +1395,8 @@ module Aws::CloudWatchLogs
     #   * {Types::FilterLogEventsResponse#searched_log_streams #searched_log_streams} => Array<Types::SearchedLogStream>
     #   * {Types::FilterLogEventsResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.filter_log_events({
@@ -1397,6 +1483,8 @@ module Aws::CloudWatchLogs
     #   * {Types::GetLogEventsResponse#next_forward_token #next_forward_token} => String
     #   * {Types::GetLogEventsResponse#next_backward_token #next_backward_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_log_events({
@@ -1434,11 +1522,16 @@ module Aws::CloudWatchLogs
     #
     # In the results, fields that start with @ are fields generated by
     # CloudWatch Logs. For example, `@timestamp` is the timestamp of each
-    # log event.
+    # log event. For more information about the fields that are generated by
+    # CloudWatch logs, see [Supported Logs and Discovered Fields][1].
     #
     # The response results are sorted by the frequency percentage, starting
     # with the highest percentage.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_AnalyzeLogData-discoverable-fields.html
+    #
     # @option params [required, String] :log_group_name
     #   The name of the log group to search.
     #
@@ -1519,16 +1612,22 @@ module Aws::CloudWatchLogs
     #
     # Only the fields requested in the query are returned, along with a
     # `@ptr` field which is the identifier for the log record. You can use
-    # the value of `@ptr` in a operation to get the full log record.
+    # the value of `@ptr` in a [GetLogRecord][1] operation to get the full
+    # log record.
     #
     # `GetQueryResults` does not start a query execution. To run a query,
-    # use .
+    # use [StartQuery][2].
     #
     # If the value of the `Status` field in the output is `Running`, this
     # operation returns only partial results. If you see a value of
     # `Scheduled` or `Running` for the status, you can retry the operation
     # later to see the final results.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogRecord.html
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartQuery.html
+    #
     # @option params [required, String] :query_id
     #   The ID number of the query.
     #
@@ -1598,15 +1697,21 @@ module Aws::CloudWatchLogs
     #
     # A destination encapsulates a physical resource (such as an Amazon
     # Kinesis stream) and enables you to subscribe to a real-time stream of
-    # log events for a different account, ingested using PutLogEvents.
+    # log events for a different account, ingested using [PutLogEvents][1].
     #
     # Through an access policy, a destination controls what is written to
     # it. By default, `PutDestination` does not set any access policy with
     # the destination, which means a cross-account user cannot call
-    # PutSubscriptionFilter against this destination. To enable this, the
-    # destination owner must call PutDestinationPolicy after
+    # [PutSubscriptionFilter][2] against this destination. To enable this,
+    # the destination owner must call [PutDestinationPolicy][3] after
     # `PutDestination`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutSubscriptionFilter.html
+    # [3]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDestinationPolicy.html
+    #
     # @option params [required, String] :destination_name
     #   A name for the destination.
     #
@@ -1735,9 +1840,13 @@ module Aws::CloudWatchLogs
     #   The sequence token obtained from the response of the previous
     #   `PutLogEvents` call. An upload in a newly created log stream does not
     #   require a sequence token. You can also get the sequence token using
-    #   DescribeLogStreams. 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 rejected.
+    #   [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 rejected.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeLogStreams.html
     #
     # @return [Types::PutLogEventsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1776,11 +1885,16 @@ module Aws::CloudWatchLogs
 
     # Creates or updates a metric filter and associates it with the
     # specified log group. Metric filters allow you to configure rules to
-    # extract metric data from log events ingested through PutLogEvents.
+    # extract metric data from log events ingested through
+    # [PutLogEvents][1].
     #
     # The maximum number of metric filters that can be associated with a log
     # group is 100.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html
+    #
     # @option params [required, String] :log_group_name
     #   The name of the log group.
     #
@@ -1821,6 +1935,40 @@ module Aws::CloudWatchLogs
       req.send_request(options)
     end
 
+    # @option params [required, String] :name
+    #
+    # @option params [String] :query_definition_id
+    #
+    # @option params [Array<String>] :log_group_names
+    #
+    # @option params [required, String] :query_string
+    #
+    # @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
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.put_query_definition({
+    #     name: "QueryDefinitionName", # required
+    #     query_definition_id: "QueryId",
+    #     log_group_names: ["LogGroupName"],
+    #     query_string: "QueryDefinitionString", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.query_definition_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/PutQueryDefinition AWS API Documentation
+    #
+    # @overload put_query_definition(params = {})
+    # @param [Hash] params ({})
+    def put_query_definition(params = {}, options = {})
+      req = build_request(:put_query_definition, params)
+      req.send_request(options)
+    end
+
     # Creates or updates a resource policy allowing other AWS services to
     # put log events to this account, such as Amazon Route 53. An account
     # can have up to 10 resource policies per region.
@@ -1901,9 +2049,9 @@ module Aws::CloudWatchLogs
 
     # Creates or updates a subscription filter and associates it with the
     # specified log group. Subscription filters allow you to subscribe to a
-    # real-time stream of log events ingested through PutLogEvents and have
-    # them delivered to a specific destination. Currently, the supported
-    # destinations are:
+    # real-time stream of log events ingested through [PutLogEvents][1] and
+    # have them delivered to a specific destination. Currently, the
+    # supported destinations are:
     #
     # * An Amazon Kinesis stream belonging to the same account as the
     #   subscription filter, for same-account delivery.
@@ -1922,6 +2070,10 @@ module Aws::CloudWatchLogs
     # name in `filterName`. Otherwise, the call fails because you cannot
     # associate a second filter with a log group.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html
+    #
     # @option params [required, String] :log_group_name
     #   The name of the log group.
     #
@@ -1930,7 +2082,11 @@ module Aws::CloudWatchLogs
     #   filter, you must specify the correct name in `filterName`. Otherwise,
     #   the call fails because you cannot associate a second filter with a log
     #   group. To find the name of the filter currently associated with a log
-    #   group, use DescribeSubscriptionFilters.
+    #   group, use [DescribeSubscriptionFilters][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeSubscriptionFilters.html
     #
     # @option params [required, String] :filter_pattern
     #   A filter pattern for subscribing to a filtered stream of log events.
@@ -2096,15 +2252,17 @@ module Aws::CloudWatchLogs
 
     # Adds or updates the specified tags for the specified log group.
     #
-    # To list the tags for a log group, use ListTagsLogGroup. To remove
-    # tags, use UntagLogGroup.
+    # To list the tags for a log group, use [ListTagsLogGroup][1]. To remove
+    # tags, use [UntagLogGroup][2].
     #
     # For more information about tags, see [Tag Log Groups in Amazon
-    # CloudWatch Logs][1] in the *Amazon CloudWatch Logs User Guide*.
+    # CloudWatch Logs][3] in the *Amazon CloudWatch Logs User Guide*.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/log-group-tagging.html
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListTagsLogGroup.html
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_UntagLogGroup.html
+    # [3]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#log-group-tagging
     #
     # @option params [required, String] :log_group_name
     #   The name of the log group.
@@ -2175,8 +2333,13 @@ module Aws::CloudWatchLogs
 
     # Removes the specified tags from the specified log group.
     #
-    # To list the tags for a log group, use ListTagsLogGroup. To add tags,
-    # use UntagLogGroup.
+    # To list the tags for a log group, use [ListTagsLogGroup][1]. To add
+    # tags, use [TagLogGroup][2].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListTagsLogGroup.html
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_TagLogGroup.html
     #
     # @option params [required, String] :log_group_name
     #   The name of the log group.
@@ -2215,7 +2378,7 @@ module Aws::CloudWatchLogs
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatchlogs'
-      context[:gem_version] = '1.29.0'
+      context[:gem_version] = '1.30.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -26,6 +26,8 @@ module Aws::CloudWatchLogs
     DeleteLogGroupRequest = Shapes::StructureShape.new(name: 'DeleteLogGroupRequest')
     DeleteLogStreamRequest = Shapes::StructureShape.new(name: 'DeleteLogStreamRequest')
     DeleteMetricFilterRequest = Shapes::StructureShape.new(name: 'DeleteMetricFilterRequest')
+    DeleteQueryDefinitionRequest = Shapes::StructureShape.new(name: 'DeleteQueryDefinitionRequest')
+    DeleteQueryDefinitionResponse = Shapes::StructureShape.new(name: 'DeleteQueryDefinitionResponse')
     DeleteResourcePolicyRequest = Shapes::StructureShape.new(name: 'DeleteResourcePolicyRequest')
     DeleteRetentionPolicyRequest = Shapes::StructureShape.new(name: 'DeleteRetentionPolicyRequest')
     DeleteSubscriptionFilterRequest = Shapes::StructureShape.new(name: 'DeleteSubscriptionFilterRequest')
@@ -44,6 +46,8 @@ module Aws::CloudWatchLogs
     DescribeQueriesMaxResults = Shapes::IntegerShape.new(name: 'DescribeQueriesMaxResults')
     DescribeQueriesRequest = Shapes::StructureShape.new(name: 'DescribeQueriesRequest')
     DescribeQueriesResponse = Shapes::StructureShape.new(name: 'DescribeQueriesResponse')
+    DescribeQueryDefinitionsRequest = Shapes::StructureShape.new(name: 'DescribeQueryDefinitionsRequest')
+    DescribeQueryDefinitionsResponse = Shapes::StructureShape.new(name: 'DescribeQueryDefinitionsResponse')
     DescribeResourcePoliciesRequest = Shapes::StructureShape.new(name: 'DescribeResourcePoliciesRequest')
     DescribeResourcePoliciesResponse = Shapes::StructureShape.new(name: 'DescribeResourcePoliciesResponse')
     DescribeSubscriptionFiltersRequest = Shapes::StructureShape.new(name: 'DescribeSubscriptionFiltersRequest')
@@ -134,6 +138,8 @@ module Aws::CloudWatchLogs
     PutLogEventsRequest = Shapes::StructureShape.new(name: 'PutLogEventsRequest')
     PutLogEventsResponse = Shapes::StructureShape.new(name: 'PutLogEventsResponse')
     PutMetricFilterRequest = Shapes::StructureShape.new(name: 'PutMetricFilterRequest')
+    PutQueryDefinitionRequest = Shapes::StructureShape.new(name: 'PutQueryDefinitionRequest')
+    PutQueryDefinitionResponse = Shapes::StructureShape.new(name: 'PutQueryDefinitionResponse')
     PutResourcePolicyRequest = Shapes::StructureShape.new(name: 'PutResourcePolicyRequest')
     PutResourcePolicyResponse = Shapes::StructureShape.new(name: 'PutResourcePolicyResponse')
     PutRetentionPolicyRequest = Shapes::StructureShape.new(name: 'PutRetentionPolicyRequest')
@@ -141,9 +147,14 @@ module Aws::CloudWatchLogs
     QueryCharOffset = Shapes::IntegerShape.new(name: 'QueryCharOffset')
     QueryCompileError = Shapes::StructureShape.new(name: 'QueryCompileError')
     QueryCompileErrorLocation = Shapes::StructureShape.new(name: 'QueryCompileErrorLocation')
+    QueryDefinition = Shapes::StructureShape.new(name: 'QueryDefinition')
+    QueryDefinitionList = Shapes::ListShape.new(name: 'QueryDefinitionList')
+    QueryDefinitionName = Shapes::StringShape.new(name: 'QueryDefinitionName')
+    QueryDefinitionString = Shapes::StringShape.new(name: 'QueryDefinitionString')
     QueryId = Shapes::StringShape.new(name: 'QueryId')
     QueryInfo = Shapes::StructureShape.new(name: 'QueryInfo')
     QueryInfoList = Shapes::ListShape.new(name: 'QueryInfoList')
+    QueryListMaxResults = Shapes::IntegerShape.new(name: 'QueryListMaxResults')
     QueryResults = Shapes::ListShape.new(name: 'QueryResults')
     QueryStatistics = Shapes::StructureShape.new(name: 'QueryStatistics')
     QueryStatus = Shapes::StringShape.new(name: 'QueryStatus')
@@ -230,6 +241,12 @@ module Aws::CloudWatchLogs
     DeleteMetricFilterRequest.add_member(:filter_name, Shapes::ShapeRef.new(shape: FilterName, required: true, location_name: "filterName"))
     DeleteMetricFilterRequest.struct_class = Types::DeleteMetricFilterRequest
 
+    DeleteQueryDefinitionRequest.add_member(:query_definition_id, Shapes::ShapeRef.new(shape: QueryId, required: true, location_name: "queryDefinitionId"))
+    DeleteQueryDefinitionRequest.struct_class = Types::DeleteQueryDefinitionRequest
+
+    DeleteQueryDefinitionResponse.add_member(:success, Shapes::ShapeRef.new(shape: Success, location_name: "success"))
+    DeleteQueryDefinitionResponse.struct_class = Types::DeleteQueryDefinitionResponse
+
     DeleteResourcePolicyRequest.add_member(:policy_name, Shapes::ShapeRef.new(shape: PolicyName, location_name: "policyName"))
     DeleteResourcePolicyRequest.struct_class = Types::DeleteResourcePolicyRequest
 
@@ -302,6 +319,15 @@ module Aws::CloudWatchLogs
     DescribeQueriesResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
     DescribeQueriesResponse.struct_class = Types::DescribeQueriesResponse
 
+    DescribeQueryDefinitionsRequest.add_member(:query_definition_name_prefix, Shapes::ShapeRef.new(shape: QueryDefinitionName, location_name: "queryDefinitionNamePrefix"))
+    DescribeQueryDefinitionsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: QueryListMaxResults, location_name: "maxResults"))
+    DescribeQueryDefinitionsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
+    DescribeQueryDefinitionsRequest.struct_class = Types::DescribeQueryDefinitionsRequest
+
+    DescribeQueryDefinitionsResponse.add_member(:query_definitions, Shapes::ShapeRef.new(shape: QueryDefinitionList, location_name: "queryDefinitions"))
+    DescribeQueryDefinitionsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
+    DescribeQueryDefinitionsResponse.struct_class = Types::DescribeQueryDefinitionsResponse
+
     DescribeResourcePoliciesRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
     DescribeResourcePoliciesRequest.add_member(:limit, Shapes::ShapeRef.new(shape: DescribeLimit, location_name: "limit"))
     DescribeResourcePoliciesRequest.struct_class = Types::DescribeResourcePoliciesRequest
@@ -538,6 +564,15 @@ module Aws::CloudWatchLogs
     PutMetricFilterRequest.add_member(:metric_transformations, Shapes::ShapeRef.new(shape: MetricTransformations, required: true, location_name: "metricTransformations"))
     PutMetricFilterRequest.struct_class = Types::PutMetricFilterRequest
 
+    PutQueryDefinitionRequest.add_member(:name, Shapes::ShapeRef.new(shape: QueryDefinitionName, required: true, location_name: "name"))
+    PutQueryDefinitionRequest.add_member(:query_definition_id, Shapes::ShapeRef.new(shape: QueryId, location_name: "queryDefinitionId"))
+    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.struct_class = Types::PutQueryDefinitionRequest
+
+    PutQueryDefinitionResponse.add_member(:query_definition_id, Shapes::ShapeRef.new(shape: QueryId, location_name: "queryDefinitionId"))
+    PutQueryDefinitionResponse.struct_class = Types::PutQueryDefinitionResponse
+
     PutResourcePolicyRequest.add_member(:policy_name, Shapes::ShapeRef.new(shape: PolicyName, location_name: "policyName"))
     PutResourcePolicyRequest.add_member(:policy_document, Shapes::ShapeRef.new(shape: PolicyDocument, location_name: "policyDocument"))
     PutResourcePolicyRequest.struct_class = Types::PutResourcePolicyRequest
@@ -565,6 +600,15 @@ module Aws::CloudWatchLogs
     QueryCompileErrorLocation.add_member(:end_char_offset, Shapes::ShapeRef.new(shape: QueryCharOffset, location_name: "endCharOffset"))
     QueryCompileErrorLocation.struct_class = Types::QueryCompileErrorLocation
 
+    QueryDefinition.add_member(:query_definition_id, Shapes::ShapeRef.new(shape: QueryId, location_name: "queryDefinitionId"))
+    QueryDefinition.add_member(:name, Shapes::ShapeRef.new(shape: QueryDefinitionName, location_name: "name"))
+    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.struct_class = Types::QueryDefinition
+
+    QueryDefinitionList.member = Shapes::ShapeRef.new(shape: QueryDefinition)
+
     QueryInfo.add_member(:query_id, Shapes::ShapeRef.new(shape: QueryId, location_name: "queryId"))
     QueryInfo.add_member(:query_string, Shapes::ShapeRef.new(shape: QueryString, location_name: "queryString"))
     QueryInfo.add_member(:status, Shapes::ShapeRef.new(shape: QueryStatus, location_name: "status"))
@@ -792,6 +836,17 @@ module Aws::CloudWatchLogs
         o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
       end)
 
+      api.add_operation(:delete_query_definition, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DeleteQueryDefinition"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DeleteQueryDefinitionRequest)
+        o.output = Shapes::ShapeRef.new(shape: DeleteQueryDefinitionResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
+      end)
+
       api.add_operation(:delete_resource_policy, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DeleteResourcePolicy"
         o.http_method = "POST"
@@ -914,6 +969,16 @@ module Aws::CloudWatchLogs
         o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
       end)
 
+      api.add_operation(:describe_query_definitions, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DescribeQueryDefinitions"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DescribeQueryDefinitionsRequest)
+        o.output = Shapes::ShapeRef.new(shape: DescribeQueryDefinitionsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
+      end)
+
       api.add_operation(:describe_resource_policies, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribeResourcePolicies"
         o.http_method = "POST"
@@ -1081,6 +1146,17 @@ module Aws::CloudWatchLogs
         o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
       end)
 
+      api.add_operation(:put_query_definition, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "PutQueryDefinition"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: PutQueryDefinitionRequest)
+        o.output = Shapes::ShapeRef.new(shape: PutQueryDefinitionResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
+      end)
+
       api.add_operation(:put_resource_policy, Seahorse::Model::Operation.new.tap do |o|
         o.name = "PutResourcePolicy"
         o.http_method = "POST"

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

@@ -6,13 +6,7 @@
 # WARNING ABOUT GENERATED CODE
 
 module Aws::CloudWatchLogs
-  # This class provides a resource oriented interface for CloudWatchLogs.
-  # To create a resource object:
-  #     resource = Aws::CloudWatchLogs::Resource.new(region: 'us-west-2')
-  # You can supply a client object with custom configuration that will be used for all resource operations.
-  # If you do not pass +:client+, a default client will be constructed.
-  #     client = Aws::CloudWatchLogs::Client.new(region: 'us-west-2')
-  #     resource = Aws::CloudWatchLogs::Resource.new(client: client)
+
   class Resource
 
     # @param options ({})

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

@@ -288,6 +288,33 @@ module Aws::CloudWatchLogs
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DeleteQueryDefinitionRequest
+    #   data as a hash:
+    #
+    #       {
+    #         query_definition_id: "QueryId", # required
+    #       }
+    #
+    # @!attribute [rw] query_definition_id
+    #   @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)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] success
+    #   @return [Boolean]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/DeleteQueryDefinitionResponse AWS API Documentation
+    #
+    class DeleteQueryDefinitionResponse < Struct.new(
+      :success)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DeleteResourcePolicyRequest
     #   data as a hash:
     #
@@ -715,6 +742,51 @@ module Aws::CloudWatchLogs
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DescribeQueryDefinitionsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         query_definition_name_prefix: "QueryDefinitionName",
+    #         max_results: 1,
+    #         next_token: "NextToken",
+    #       }
+    #
+    # @!attribute [rw] query_definition_name_prefix
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   @return [Integer]
+    #
+    # @!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/DescribeQueryDefinitionsRequest AWS API Documentation
+    #
+    class DescribeQueryDefinitionsRequest < Struct.new(
+      :query_definition_name_prefix,
+      :max_results,
+      :next_token)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] query_definitions
+    #   @return [Array<Types::QueryDefinition>]
+    #
+    # @!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/DescribeQueryDefinitionsResponse AWS API Documentation
+    #
+    class DescribeQueryDefinitionsResponse < Struct.new(
+      :query_definitions,
+      :next_token)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DescribeResourcePoliciesRequest
     #   data as a hash:
     #
@@ -1570,14 +1642,16 @@ module Aws::CloudWatchLogs
     end
 
     # The query string is not valid. Details about this error are displayed
-    # in a `QueryCompileError` object. For more information, see .
+    # in a `QueryCompileError` object. For more information, see
+    # [QueryCompileError][1]"/&gt;.
     #
     # For more information about valid query syntax, see [CloudWatch Logs
-    # Insights Query Syntax][1].
+    # Insights Query Syntax][2].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_QueryCompileError.html
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html
     #
     # @!attribute [rw] query_compile_error
     #   Reserved.
@@ -1670,7 +1744,13 @@ module Aws::CloudWatchLogs
     #   @return [String]
     #
     # @!attribute [rw] metric_namespace
-    #   The namespace of the CloudWatch metric.
+    #   A custom namespace to contain your metric in CloudWatch. Use
+    #   namespaces to group together metrics that are similar. For more
+    #   information, see [Namespaces][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Namespace
     #   @return [String]
     #
     # @!attribute [rw] metric_value
@@ -1824,9 +1904,14 @@ module Aws::CloudWatchLogs
     #   The sequence token obtained from the response of the previous
     #   `PutLogEvents` call. An upload in a newly created log stream does
     #   not require a sequence token. You can also get the sequence token
-    #   using DescribeLogStreams. 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 rejected.
+    #   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
+    #   rejected.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeLogStreams.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/PutLogEventsRequest AWS API Documentation
@@ -1900,6 +1985,48 @@ module Aws::CloudWatchLogs
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass PutQueryDefinitionRequest
+    #   data as a hash:
+    #
+    #       {
+    #         name: "QueryDefinitionName", # required
+    #         query_definition_id: "QueryId",
+    #         log_group_names: ["LogGroupName"],
+    #         query_string: "QueryDefinitionString", # required
+    #       }
+    #
+    # @!attribute [rw] name
+    #   @return [String]
+    #
+    # @!attribute [rw] query_definition_id
+    #   @return [String]
+    #
+    # @!attribute [rw] log_group_names
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] query_string
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/PutQueryDefinitionRequest AWS API Documentation
+    #
+    class PutQueryDefinitionRequest < Struct.new(
+      :name,
+      :query_definition_id,
+      :log_group_names,
+      :query_string)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] query_definition_id
+    #   @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)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass PutResourcePolicyRequest
     #   data as a hash:
     #
@@ -1994,7 +2121,11 @@ module Aws::CloudWatchLogs
     #   filter, you must specify the correct name in `filterName`.
     #   Otherwise, the call fails because you cannot associate a second
     #   filter with a log group. To find the name of the filter currently
-    #   associated with a log group, use DescribeSubscriptionFilters.
+    #   associated with a log group, use [DescribeSubscriptionFilters][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeSubscriptionFilters.html
     #   @return [String]
     #
     # @!attribute [rw] filter_pattern
@@ -2080,6 +2211,32 @@ module Aws::CloudWatchLogs
       include Aws::Structure
     end
 
+    # @!attribute [rw] query_definition_id
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   @return [String]
+    #
+    # @!attribute [rw] query_string
+    #   @return [String]
+    #
+    # @!attribute [rw] last_modified
+    #   @return [Integer]
+    #
+    # @!attribute [rw] log_group_names
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/QueryDefinition AWS API Documentation
+    #
+    class QueryDefinition < Struct.new(
+      :query_definition_id,
+      :name,
+      :query_string,
+      :last_modified,
+      :log_group_names)
+      include Aws::Structure
+    end
+
     # Information about one CloudWatch Logs Insights query that matches the
     # request in a `DescribeQueries` operation.
     #
@@ -2204,6 +2361,13 @@ module Aws::CloudWatchLogs
     # Contains one field from one log event returned by a CloudWatch Logs
     # Insights query, along with the value of that field.
     #
+    # For more information about the fields that are generated by CloudWatch
+    # logs, see [Supported Logs and Discovered Fields][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_AnalyzeLogData-discoverable-fields.html
+    #
     # @!attribute [rw] field
     #   The log event field.
     #   @return [String]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudwatchlogs
 version: !ruby/object:Gem::Version
-  version: 1.29.0
+  version: 1.30.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-09 00:00:00.000000000 Z
+date: 2020-05-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -81,7 +81,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.2.3
+rubygems_version: 2.7.6.2
 signing_key: 
 specification_version: 4
 summary: AWS SDK for Ruby - Amazon CloudWatch Logs