aws-sdk-cloudwatchlogs 1.38.0 → 1.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e06f884ae9f11c031be6f4d3887730189c98434fd175d73c1613cbf2b2e6846
-  data.tar.gz: 5924cbf59c1283a7c740a8a68f92c38fa57989dd6a5653ca14fdc7ef76d23887
+  metadata.gz: b766b6615fe50ab3889dcff3bfab702a76f82c9f0ccedaa002c58a450d8706e7
+  data.tar.gz: 770063e4d7c4c99d90f259dae6a0db8a7b70fe67a8a72b5ee80d52a1f823c6fd
 SHA512:
-  metadata.gz: 632e7a8a10f3be89cd484abeb384d29f43a16f01817fa8369fb32de563f74b673dcd46061a50ab735814b1d12ba0b88e92ff1fa5434cf4ac59fd001c4e8382e5
-  data.tar.gz: 8f846c1cb88f9aedb97b157e98b0f8d4c4bc61bd76cff731696ecd364b151de47befe2face0dcbf5ebff66d2c5e790995eb3b6b4811c51116c50d49a1700e1d6
+  metadata.gz: 690a4ec2cb27187e788d856a8007cb432dc3a0e8d9913901241531ab7b71be946aa7a6b1ec0b269d2868f49ea6e82c7e1c494576e0d0ee2cae86339c520a6bf8
+  data.tar.gz: 46d21362f0e49dc572c962741c35d95e27364b677fbae87c6b542406b44f74028fdc20787cf9c1224514a6f1b6ef7fdc57620e6b19d78a08a2b2291d1d25e3b4

data/CHANGELOG.md

@@ -0,0 +1,283 @@
+Unreleased Changes
+------------------
+
+1.42.0 (2021-07-28)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.41.0 (2021-05-24)
+------------------
+
+* Feature - This release provides dimensions and unit support for metric filters.
+
+1.40.0 (2021-03-10)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.39.0 (2021-02-02)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.38.0 (2020-09-30)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.37.0 (2020-09-15)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.36.0 (2020-08-25)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.35.0 (2020-08-24)
+------------------
+
+* Feature - Documentation updates for CloudWatch Logs
+
+1.34.0 (2020-07-02)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.33.0 (2020-06-23)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.32.1 (2020-06-11)
+------------------
+
+* Issue - Republish previous version with correct dependency on `aws-sdk-core`.
+
+1.32.0 (2020-06-10)
+------------------
+
+* Issue - This version has been yanked. (#2327).
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.31.0 (2020-05-28)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.30.0 (2020-05-07)
+------------------
+
+* Feature - Amazon CloudWatch Logs now offers the ability to interact with Logs Insights queries via the new PutQueryDefinition, DescribeQueryDefinitions, and DeleteQueryDefinition APIs.
+
+1.29.0 (2020-03-09)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.28.0 (2020-01-09)
+------------------
+
+* Feature - Documentation updates for logs
+
+1.27.0 (2019-11-15)
+------------------
+
+* Feature - Documentation updates for logs
+
+1.26.0 (2019-10-23)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.25.0 (2019-07-26)
+------------------
+
+* Feature - Allow for specifying multiple log groups in an Insights query, and deprecate storedByte field for LogStreams and interleaved field for FilterLogEventsRequest.
+
+1.24.0 (2019-07-25)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.23.0 (2019-07-01)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.22.0 (2019-06-17)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.21.0 (2019-06-06)
+------------------
+
+* Feature - Documentation updates for logs
+
+1.20.0 (2019-05-21)
+------------------
+
+* Feature - API update.
+
+1.19.0 (2019-05-15)
+------------------
+
+* Feature - API update.
+
+1.18.0 (2019-05-14)
+------------------
+
+* Feature - API update.
+
+1.17.0 (2019-03-21)
+------------------
+
+* Feature - API update.
+
+1.16.0 (2019-03-18)
+------------------
+
+* Feature - API update.
+
+1.15.0 (2019-03-14)
+------------------
+
+* Feature - API update.
+
+1.14.0 (2019-03-13)
+------------------
+
+* Feature - API update.
+
+1.13.0 (2019-01-24)
+------------------
+
+* Feature - API update.
+
+1.12.0 (2018-11-28)
+------------------
+
+* Feature - API update.
+
+1.11.0 (2018-11-20)
+------------------
+
+* Feature - API update.
+
+1.10.0 (2018-10-24)
+------------------
+
+* Feature - API update.
+
+1.9.0 (2018-10-23)
+------------------
+
+* Feature - API update.
+
+1.8.0 (2018-09-07)
+------------------
+
+* Feature - API update.
+
+1.7.0 (2018-09-06)
+------------------
+
+* Feature - Adds code paths and plugins for future SDK instrumentation and telemetry.
+
+1.6.0 (2018-09-05)
+------------------
+
+* Feature - API update.
+
+1.5.0 (2018-08-07)
+------------------
+
+* Feature - API update.
+
+1.4.0 (2018-06-26)
+------------------
+
+* Feature - API update.
+
+1.3.0 (2018-04-19)
+------------------
+
+* Feature - API update.
+
+1.2.0 (2017-09-21)
+------------------
+
+* Feature - API update.
+
+1.1.0 (2017-09-08)
+------------------
+
+* Feature - API update.
+
+* Issue - Update `aws-sdk-cloudwatchlogs` gemspec metadata.
+
+1.0.0 (2017-08-29)
+------------------
+
+1.0.0.rc12 (2017-08-15)
+------------------
+
+* Feature - API update.
+
+1.0.0.rc11 (2017-08-01)
+------------------
+
+* Feature - API update.
+
+1.0.0.rc10 (2017-07-25)
+------------------
+
+* Feature - API update.
+
+1.0.0.rc9 (2017-07-13)
+------------------
+
+* Feature - API update.
+
+1.0.0.rc8 (2017-07-06)
+------------------
+
+* Feature - API update.
+
+1.0.0.rc7 (2017-06-29)
+------------------
+
+* Feature - API update.
+
+1.0.0.rc6 (2017-05-23)
+------------------
+
+* Feature - API update.
+
+1.0.0.rc5 (2017-05-09)
+------------------
+
+* Feature - API update.
+
+1.0.0.rc4 (2017-05-09)
+------------------
+
+* Feature - API update.
+
+1.0.0.rc3 (2017-04-21)
+------------------
+
+* Feature - API update.
+
+1.0.0.rc2 (2017-01-24)
+------------------
+
+* Feature - API update.
+
+1.0.0.rc1 (2016-12-05)
+------------------
+
+* Feature - Initial preview release of the `aws-sdk-cloudwatchlogs` gem.

data/LICENSE.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/VERSION

@@ -0,0 +1 @@
+1.42.0

data/lib/aws-sdk-cloudwatchlogs.rb

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-cloudwatchlogs/customizations'
 # @!group service
 module Aws::CloudWatchLogs
 
-  GEM_VERSION = '1.38.0'
+  GEM_VERSION = '1.42.0'
 
 end

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

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -460,9 +460,9 @@ module Aws::CloudWatchLogs
     #   timestamp earlier than this time are not exported.
     #
     # @option params [required, Integer] :to
-    #   The end time of the range for the request, expressed as the number of
-    #   milliseconds after Jan 1, 1970 00:00:00 UTC. Events with a timestamp
-    #   later than this time are not exported.
+    #   The end time of the range for the request, expreswatchlogsdocused as
+    #   the number of milliseconds after Jan 1, 1970 00:00:00 UTC. Events with
+    #   a timestamp later than this time are not exported.
     #
     # @option params [required, String] :destination
     #   The name of S3 bucket for the exported log data. The bucket must be in
@@ -1011,10 +1011,10 @@ 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
+    #   `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
+    #   `lastEventTimestamp` updates on an eventual consistency basis. It
     #   typically updates in less than an hour from ingestion, but in rare
     #   situations might take longer.
     #
@@ -1128,6 +1128,9 @@ module Aws::CloudWatchLogs
     #   resp.metric_filters[0].metric_transformations[0].metric_namespace #=> String
     #   resp.metric_filters[0].metric_transformations[0].metric_value #=> String
     #   resp.metric_filters[0].metric_transformations[0].default_value #=> Float
+    #   resp.metric_filters[0].metric_transformations[0].dimensions #=> Hash
+    #   resp.metric_filters[0].metric_transformations[0].dimensions["DimensionsKey"] #=> String
+    #   resp.metric_filters[0].metric_transformations[0].unit #=> String, one of "Seconds", "Microseconds", "Milliseconds", "Bytes", "Kilobytes", "Megabytes", "Gigabytes", "Terabytes", "Bits", "Kilobits", "Megabits", "Gigabits", "Terabits", "Percent", "Count", "Bytes/Second", "Kilobytes/Second", "Megabytes/Second", "Gigabytes/Second", "Terabytes/Second", "Bits/Second", "Kilobits/Second", "Megabits/Second", "Gigabits/Second", "Terabits/Second", "Count/Second", "None"
     #   resp.metric_filters[0].creation_time #=> Integer
     #   resp.metric_filters[0].log_group_name #=> String
     #   resp.next_token #=> String
@@ -1170,7 +1173,7 @@ module Aws::CloudWatchLogs
     #
     #   resp = client.describe_queries({
     #     log_group_name: "LogGroupName",
-    #     status: "Scheduled", # accepts Scheduled, Running, Complete, Failed, Cancelled
+    #     status: "Scheduled", # accepts Scheduled, Running, Complete, Failed, Cancelled, Timeout, Unknown
     #     max_results: 1,
     #     next_token: "NextToken",
     #   })
@@ -1180,7 +1183,7 @@ module Aws::CloudWatchLogs
     #   resp.queries #=> Array
     #   resp.queries[0].query_id #=> String
     #   resp.queries[0].query_string #=> String
-    #   resp.queries[0].status #=> String, one of "Scheduled", "Running", "Complete", "Failed", "Cancelled"
+    #   resp.queries[0].status #=> String, one of "Scheduled", "Running", "Complete", "Failed", "Cancelled", "Timeout", "Unknown"
     #   resp.queries[0].create_time #=> Integer
     #   resp.queries[0].log_group_name #=> String
     #   resp.next_token #=> String
@@ -1413,9 +1416,6 @@ module Aws::CloudWatchLogs
     #   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.
-    #
     # @option params [Integer] :end_time
     #   The end of the time range, expressed as the number of milliseconds
     #   after Jan 1, 1970 00:00:00 UTC. Events with a timestamp later than
@@ -1600,8 +1600,8 @@ module Aws::CloudWatchLogs
     #
     # @option params [Integer] :time
     #   The time to set as the center of the query. If you specify `time`, the
-    #   8 minutes before and 8 minutes after this time are searched. If you
-    #   omit `time`, the past 15 minutes are queried.
+    #   15 minutes before this time are queries. If you omit `time` the 8
+    #   minutes before and 8 minutes after this time are searched.
     #
     #   The `time` value is specified as epoch time, the number of seconds
     #   since January 1, 1970, 00:00:00 UTC.
@@ -1714,7 +1714,7 @@ module Aws::CloudWatchLogs
     #   resp.statistics.records_matched #=> Float
     #   resp.statistics.records_scanned #=> Float
     #   resp.statistics.bytes_scanned #=> Float
-    #   resp.status #=> String, one of "Scheduled", "Running", "Complete", "Failed", "Cancelled"
+    #   resp.status #=> String, one of "Scheduled", "Running", "Complete", "Failed", "Cancelled", "Timeout", "Unknown"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/GetQueryResults AWS API Documentation
     #
@@ -1823,6 +1823,11 @@ module Aws::CloudWatchLogs
     # used to authorize claims to register a subscription filter against a
     # given destination.
     #
+    # If multiple AWS accounts are sending logs to this destination, each
+    # sender account must be listed separately in the policy. The policy
+    # does not support specifying `*` as the Principal or the use of the
+    # `aws:PrincipalOrgId` global key.
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/policies_overview.html
@@ -1957,9 +1962,27 @@ module Aws::CloudWatchLogs
     # The maximum number of metric filters that can be associated with a log
     # group is 100.
     #
+    # When you create a metric filter, you can also optionally assign a unit
+    # and dimensions to the metric that is created.
+    #
+    # Metrics extracted from log events are charged as custom metrics. To
+    # prevent unexpected high charges, do not specify high-cardinality
+    # fields such as `IPAddress` or `requestID` as dimensions. Each
+    # different value found for a dimension is treated as a separate metric
+    # and accrues charges as a separate custom metric.
+    #
+    #  To help prevent accidental high charges, Amazon disables a metric
+    # filter if it generates 1000 different name/value pairs for the
+    # dimensions that you have specified within a certain amount of time.
+    #
+    #  You can also set up a billing alarm to alert you if your charges are
+    # higher than expected. For more information, see [ Creating a Billing
+    # Alarm to Monitor Your Estimated AWS Charges][2].
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html
     #
     # @option params [required, String] :log_group_name
     #   The name of the log group.
@@ -1988,6 +2011,10 @@ module Aws::CloudWatchLogs
     #         metric_namespace: "MetricNamespace", # required
     #         metric_value: "MetricValue", # required
     #         default_value: 1.0,
+    #         dimensions: {
+    #           "DimensionsKey" => "DimensionsValue",
+    #         },
+    #         unit: "Seconds", # accepts Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None
     #       },
     #     ],
     #   })
@@ -2189,10 +2216,9 @@ module Aws::CloudWatchLogs
     # * An AWS Lambda function that belongs to the same account as the
     #   subscription filter, for same-account delivery.
     #
-    # There can only be one subscription filter associated with a log group.
-    # If you are updating an existing filter, you must specify the correct
-    # name in `filterName`. Otherwise, the call fails because you cannot
-    # associate a second filter with a log group.
+    # Each log group can have up to two subscription filters associated with
+    # it. If you are updating an existing filter, you must specify the
+    # correct name in `filterName`.
     #
     # To perform a `PutSubscriptionFilter` operation, you must also have the
     # `iam:PassRole` permission.
@@ -2206,10 +2232,9 @@ module Aws::CloudWatchLogs
     #
     # @option params [required, String] :filter_name
     #   A name for the subscription filter. If you are updating an existing
-    #   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][1].
+    #   filter, you must specify the correct name in `filterName`. To find the
+    #   name of the filter currently associated with a log group, use
+    #   [DescribeSubscriptionFilters][1].
     #
     #
     #
@@ -2228,12 +2253,21 @@ module Aws::CloudWatchLogs
     #   * A logical destination (specified using an ARN) belonging to a
     #     different account, for cross-account delivery.
     #
+    #     If you are setting up a cross-account subscription, the destination
+    #     must have an IAM policy associated with it that allows the sender to
+    #     send logs to the destination. For more information, see
+    #     [PutDestinationPolicy][1].
+    #
     #   * An Amazon Kinesis Firehose delivery stream belonging to the same
     #     account as the subscription filter, for same-account delivery.
     #
     #   * An AWS Lambda function belonging to the same account as the
     #     subscription filter, for same-account delivery.
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDestinationPolicy.html
+    #
     # @option params [String] :role_arn
     #   The ARN of an IAM role that grants CloudWatch Logs permissions to
     #   deliver ingested log events to the destination stream. You don't need
@@ -2505,7 +2539,7 @@ module Aws::CloudWatchLogs
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatchlogs'
-      context[:gem_version] = '1.38.0'
+      context[:gem_version] = '1.42.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -58,6 +58,9 @@ module Aws::CloudWatchLogs
     DestinationArn = Shapes::StringShape.new(name: 'DestinationArn')
     DestinationName = Shapes::StringShape.new(name: 'DestinationName')
     Destinations = Shapes::ListShape.new(name: 'Destinations')
+    Dimensions = Shapes::MapShape.new(name: 'Dimensions')
+    DimensionsKey = Shapes::StringShape.new(name: 'DimensionsKey')
+    DimensionsValue = Shapes::StringShape.new(name: 'DimensionsValue')
     DisassociateKmsKeyRequest = Shapes::StructureShape.new(name: 'DisassociateKmsKeyRequest')
     Distribution = Shapes::StringShape.new(name: 'Distribution')
     EventId = Shapes::StringShape.new(name: 'EventId')
@@ -173,6 +176,7 @@ module Aws::CloudWatchLogs
     SearchedLogStreams = Shapes::ListShape.new(name: 'SearchedLogStreams')
     SequenceToken = Shapes::StringShape.new(name: 'SequenceToken')
     ServiceUnavailableException = Shapes::StructureShape.new(name: 'ServiceUnavailableException')
+    StandardUnit = Shapes::StringShape.new(name: 'StandardUnit')
     StartFromHead = Shapes::BooleanShape.new(name: 'StartFromHead')
     StartQueryRequest = Shapes::StructureShape.new(name: 'StartQueryRequest')
     StartQueryResponse = Shapes::StructureShape.new(name: 'StartQueryResponse')
@@ -358,6 +362,9 @@ module Aws::CloudWatchLogs
 
     Destinations.member = Shapes::ShapeRef.new(shape: Destination)
 
+    Dimensions.key = Shapes::ShapeRef.new(shape: DimensionsKey)
+    Dimensions.value = Shapes::ShapeRef.new(shape: DimensionsValue)
+
     DisassociateKmsKeyRequest.add_member(:log_group_name, Shapes::ShapeRef.new(shape: LogGroupName, required: true, location_name: "logGroupName"))
     DisassociateKmsKeyRequest.struct_class = Types::DisassociateKmsKeyRequest
 
@@ -525,6 +532,8 @@ module Aws::CloudWatchLogs
     MetricTransformation.add_member(:metric_namespace, Shapes::ShapeRef.new(shape: MetricNamespace, required: true, location_name: "metricNamespace"))
     MetricTransformation.add_member(:metric_value, Shapes::ShapeRef.new(shape: MetricValue, required: true, location_name: "metricValue"))
     MetricTransformation.add_member(:default_value, Shapes::ShapeRef.new(shape: DefaultValue, location_name: "defaultValue"))
+    MetricTransformation.add_member(:dimensions, Shapes::ShapeRef.new(shape: Dimensions, location_name: "dimensions"))
+    MetricTransformation.add_member(:unit, Shapes::ShapeRef.new(shape: StandardUnit, location_name: "unit"))
     MetricTransformation.struct_class = Types::MetricTransformation
 
     MetricTransformations.member = Shapes::ShapeRef.new(shape: MetricTransformation)

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

@@ -2,7 +2,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing for info on making contributions:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 

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

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 

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

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 

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

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -95,9 +95,9 @@ module Aws::CloudWatchLogs
     #   @return [Integer]
     #
     # @!attribute [rw] to
-    #   The end time of the range for the request, expressed as the number
-    #   of milliseconds after Jan 1, 1970 00:00:00 UTC. Events with a
-    #   timestamp later than this time are not exported.
+    #   The end time of the range for the request, expreswatchlogsdocused as
+    #   the number of milliseconds after Jan 1, 1970 00:00:00 UTC. Events
+    #   with a timestamp later than this time are not exported.
     #   @return [Integer]
     #
     # @!attribute [rw] destination
@@ -597,10 +597,10 @@ 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
+    #   `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
+    #   `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]
@@ -732,7 +732,7 @@ module Aws::CloudWatchLogs
     #
     #       {
     #         log_group_name: "LogGroupName",
-    #         status: "Scheduled", # accepts Scheduled, Running, Complete, Failed, Cancelled
+    #         status: "Scheduled", # accepts Scheduled, Running, Complete, Failed, Cancelled, Timeout, Unknown
     #         max_results: 1,
     #         next_token: "NextToken",
     #       }
@@ -1144,9 +1144,6 @@ 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
@@ -1382,8 +1379,8 @@ module Aws::CloudWatchLogs
     #
     # @!attribute [rw] time
     #   The time to set as the center of the query. If you specify `time`,
-    #   the 8 minutes before and 8 minutes after this time are searched. If
-    #   you omit `time`, the past 15 minutes are queried.
+    #   the 15 minutes before this time are queries. If you omit `time` the
+    #   8 minutes before and 8 minutes after this time are searched.
     #
     #   The `time` value is specified as epoch time, the number of seconds
     #   since January 1, 1970, 00:00:00 UTC.
@@ -1829,6 +1826,10 @@ module Aws::CloudWatchLogs
     #         metric_namespace: "MetricNamespace", # required
     #         metric_value: "MetricValue", # required
     #         default_value: 1.0,
+    #         dimensions: {
+    #           "DimensionsKey" => "DimensionsValue",
+    #         },
+    #         unit: "Seconds", # accepts Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None
     #       }
     #
     # @!attribute [rw] metric_name
@@ -1855,13 +1856,44 @@ module Aws::CloudWatchLogs
     #   log event. This value can be null.
     #   @return [Float]
     #
+    # @!attribute [rw] dimensions
+    #   The fields to use as dimensions for the metric. One metric filter
+    #   can include as many as three dimensions.
+    #
+    #   Metrics extracted from log events are charged as custom metrics. To
+    #   prevent unexpected high charges, do not specify high-cardinality
+    #   fields such as `IPAddress` or `requestID` as dimensions. Each
+    #   different value found for a dimension is treated as a separate
+    #   metric and accrues charges as a separate custom metric.
+    #
+    #    To help prevent accidental high charges, Amazon disables a metric
+    #   filter if it generates 1000 different name/value pairs for the
+    #   dimensions that you have specified within a certain amount of time.
+    #
+    #    You can also set up a billing alarm to alert you if your charges
+    #   are
+    #   higher than expected. For more information, see [ Creating a Billing
+    #   Alarm to Monitor Your Estimated AWS Charges][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html
+    #   @return [Hash<String,String>]
+    #
+    # @!attribute [rw] unit
+    #   The unit to assign to the metric. If you omit this, the unit is set
+    #   as `None`.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/MetricTransformation AWS API Documentation
     #
     class MetricTransformation < Struct.new(
       :metric_name,
       :metric_namespace,
       :metric_value,
-      :default_value)
+      :default_value,
+      :dimensions,
+      :unit)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2053,6 +2085,10 @@ module Aws::CloudWatchLogs
     #             metric_namespace: "MetricNamespace", # required
     #             metric_value: "MetricValue", # required
     #             default_value: 1.0,
+    #             dimensions: {
+    #               "DimensionsKey" => "DimensionsValue",
+    #             },
+    #             unit: "Seconds", # accepts Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None
     #           },
     #         ],
     #       }
@@ -2260,10 +2296,9 @@ module Aws::CloudWatchLogs
     #
     # @!attribute [rw] filter_name
     #   A name for the subscription filter. If you are updating an existing
-    #   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][1].
+    #   filter, you must specify the correct name in `filterName`. To find
+    #   the name of the filter currently associated with a log group, use
+    #   [DescribeSubscriptionFilters][1].
     #
     #
     #
@@ -2284,11 +2319,20 @@ module Aws::CloudWatchLogs
     #   * A logical destination (specified using an ARN) belonging to a
     #     different account, for cross-account delivery.
     #
+    #     If you are setting up a cross-account subscription, the
+    #     destination must have an IAM policy associated with it that allows
+    #     the sender to send logs to the destination. For more information,
+    #     see [PutDestinationPolicy][1].
+    #
     #   * An Amazon Kinesis Firehose delivery stream belonging to the same
     #     account as the subscription filter, for same-account delivery.
     #
     #   * An AWS Lambda function belonging to the same account as the
     #     subscription filter, for same-account delivery.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDestinationPolicy.html
     #   @return [String]
     #
     # @!attribute [rw] role_arn

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudwatchlogs
 version: !ruby/object:Gem::Version
-  version: 1.38.0
+  version: 1.42.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-30 00:00:00.000000000 Z
+date: 2021-07-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.109.0
+        version: 3.118.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.109.0
+        version: 3.118.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement
@@ -47,11 +47,14 @@ dependencies:
 description: Official AWS Ruby gem for Amazon CloudWatch Logs. This gem is part of
   the AWS SDK for Ruby.
 email:
-- trevrowe@amazon.com
+- aws-dr-rubygems@amazon.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
+- LICENSE.txt
+- VERSION
 - lib/aws-sdk-cloudwatchlogs.rb
 - lib/aws-sdk-cloudwatchlogs/client.rb
 - lib/aws-sdk-cloudwatchlogs/client_api.rb
@@ -63,8 +66,8 @@ homepage: https://github.com/aws/aws-sdk-ruby
 licenses:
 - Apache-2.0
 metadata:
-  source_code_uri: https://github.com/aws/aws-sdk-ruby/tree/master/gems/aws-sdk-cloudwatchlogs
-  changelog_uri: https://github.com/aws/aws-sdk-ruby/tree/master/gems/aws-sdk-cloudwatchlogs/CHANGELOG.md
+  source_code_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-cloudwatchlogs
+  changelog_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-cloudwatchlogs/CHANGELOG.md
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -80,8 +83,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6.2
+rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
 summary: AWS SDK for Ruby - Amazon CloudWatch Logs