aws-sdk-cloudwatch 1.0.0.rc8 → 1.0.0.rc10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1a366472e910093a69bcbe7b9bd947d9caf89eb3
-  data.tar.gz: dd0aa91bcee04d7811bc71785b6ef10350e246c2
+  metadata.gz: 9ea259d174e65439aa6e4c56dbc39872d9f1f026
+  data.tar.gz: eacb3652d9204ee1bdaa7f82a5034287e7519422
 SHA512:
-  metadata.gz: a8031af32e372858c2d0dc7bca6be1b03272a38833f2efc0df420508e03cb50a61a30fa839dcba74707b1be2497cf5893b456833dd7b018b97e5e07d52529a0b
-  data.tar.gz: 3a3cadee0a5d59cfa8a1631f58d44981a760c10f6d3117d3da4c679d8e81acbe4689acab3876a6512162171184d57b73263ce5b9de9b7f81f389860094803f1c
+  metadata.gz: 54d4c323daeb60950b787192e0eef9c0e07f7ead8a3b6242696af5f59061f9ad74b23db3f437253b0bee78bfd176a00bdbbde0b30dc104d3b793c9e45462c240
+  data.tar.gz: 8315100a174b41470439fa970195f26cbad8ee7da1d38ec92efc3787359b560268aac6ff4ef338af5835345eae8a75f410c04e9424b32d1aae28d374b14daa43

data/lib/aws-sdk-cloudwatch.rb

@@ -45,6 +45,6 @@ require_relative 'aws-sdk-cloudwatch/customizations'
 # @service
 module Aws::CloudWatch
 
-  GEM_VERSION = '1.0.0.rc8'
+  GEM_VERSION = '1.0.0.rc10'
 
 end

data/lib/aws-sdk-cloudwatch/alarm.rb

@@ -179,7 +179,7 @@ module Aws::CloudWatch
     # Used only for alarms based on percentiles. If `ignore`, the alarm
     # state does not change during periods with too few data points to be
     # statistically significant. If `evaluate` or this parameter is not
-    # used, the alarm will always be evaluated and possibly change state no
+    # used, the alarm is always evaluated and possibly changes state no
     # matter how many data points are available.
     # @return [String]
     def evaluate_low_sample_count_percentile

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

@@ -511,27 +511,12 @@ module Aws::CloudWatch
 
     # Gets statistics for the specified metric.
     #
-    # Amazon CloudWatch retains metric data as follows:
-    #
-    # * Data points with a period of 60 seconds (1-minute) are available for
-    #   15 days
-    #
-    # * Data points with a period of 300 seconds (5-minute) are available
-    #   for 63 days
-    #
-    # * Data points with a period of 3600 seconds (1 hour) are available for
-    #   455 days (15 months)
-    #
-    # CloudWatch started retaining 5-minute and 1-hour metric data as of
-    # July 9, 2016.
-    #
     # The maximum number of data points returned from a single call is
     # 1,440. If you request more than 1,440 data points, CloudWatch returns
     # an error. To reduce the number of data points, you can narrow the
     # specified time range and make multiple requests across adjacent time
-    # ranges, or you can increase the specified period. A period can be as
-    # short as one minute (60 seconds). Data points are not returned in
-    # chronological order.
+    # ranges, or you can increase the specified period. Data points are not
+    # returned in chronological order.
     #
     # CloudWatch aggregates data points based on the length of the period
     # that you specify. For example, if you request statistics with a
@@ -549,9 +534,36 @@ module Aws::CloudWatch
     #
     # * The Min and the Max values of the statistic set are equal.
     #
-    # For a list of metrics and dimensions supported by AWS services, see
-    # the [Amazon CloudWatch Metrics and Dimensions Reference][1] in the
-    # *Amazon CloudWatch User Guide*.
+    # Amazon CloudWatch retains metric data as follows:
+    #
+    # * Data points with a period of less than 60 seconds are available for
+    #   3 hours. These data points are high-resolution metrics and are
+    #   available only for custom metrics that have been defined with a
+    #   `StorageResolution` of 1.
+    #
+    # * Data points with a period of 60 seconds (1-minute) are available for
+    #   15 days.
+    #
+    # * Data points with a period of 300 seconds (5-minute) are available
+    #   for 63 days.
+    #
+    # * Data points with a period of 3600 seconds (1 hour) are available for
+    #   455 days (15 months).
+    #
+    # Data points that are initially published with a shorter period are
+    # aggregated together for long-term storage. For example, if you collect
+    # data using a period of 1 minute, the data remains available for 15
+    # days with 1-minute resolution. After 15 days, this data is still
+    # available, but is aggregated and retrievable only with a resolution of
+    # 5 minutes. After 63 days, the data is further aggregated and is
+    # available with a resolution of 1 hour.
+    #
+    # CloudWatch started retaining 5-minute and 1-hour metric data as of
+    # July 9, 2016.
+    #
+    # For information about metrics and dimensions supported by AWS
+    # services, see the [Amazon CloudWatch Metrics and Dimensions
+    # Reference][1] in the *Amazon CloudWatch User Guide*.
     #
     #
     #
@@ -601,6 +613,15 @@ module Aws::CloudWatch
     #     1-hour clock interval. For example, 12:32:34 is rounded down to
     #     12:00:00.
     #
+    #   If you set `Period` to 5, 10, or 30, the start time of your request is
+    #   rounded down to the nearest time that corresponds to even 5-, 10-, or
+    #   30-second divisions of a minute. For example, if you make a query at
+    #   (HH:mm:ss) 01:05:23 for the previous 10-second period, the start time
+    #   of your request is rounded down and you receive data from 01:05:10 to
+    #   01:05:20. If you make a query at 15:07:17 for the previous 5 minutes
+    #   of data, using a period of 5 seconds, you receive data timestamped
+    #   between 15:02:15 and 15:07:15.
+    #
     # @option params [required, Time,DateTime,Date,Integer,String] :end_time
     #   The time stamp that determines the last data point to return.
     #
@@ -609,13 +630,21 @@ module Aws::CloudWatch
     #   format (for example, 2016-10-10T23:00:00Z).
     #
     # @option params [required, Integer] :period
-    #   The granularity, in seconds, of the returned data points. A period can
-    #   be as short as one minute (60 seconds) and must be a multiple of 60.
+    #   The granularity, in seconds, of the returned data points. For metrics
+    #   with regular resolution, a period can be as short as one minute (60
+    #   seconds) and must be a multiple of 60. For high-resolution metrics
+    #   that are collected at intervals of less than one minute, the period
+    #   can be 1, 5, 10, 30, 60, or any multiple of 60. High-resolution
+    #   metrics are those metrics stored by a `PutMetricData` call that
+    #   includes a `StorageResolution` of 1 second.
     #
     #   If the `StartTime` parameter specifies a time stamp that is greater
-    #   than 15 days ago, you must specify the period as follows or no data
+    #   than 3 hours ago, you must specify the period as follows or no data
     #   points in that time range is returned:
     #
+    #   * Start time between 3 hours and 15 days ago - Use a multiple of 60
+    #     seconds (1 minute).
+    #
     #   * Start time between 15 and 63 days ago - Use a multiple of 300
     #     seconds (5 minutes).
     #
@@ -798,15 +827,26 @@ module Aws::CloudWatch
     # You can have up to 500 dashboards per account. All dashboards in your
     # account are global, not region-specific.
     #
-    # To copy an existing dashboard, use `GetDashboard`, and then use the
-    # data returned within `DashboardBody` as the template for the new
-    # dashboard when you call `PutDashboard` to create the copy.
+    # A simple way to create a dashboard using `PutDashboard` is to copy an
+    # existing dashboard. To copy an existing dashboard using the console,
+    # you can load the dashboard and then use the View/edit source command
+    # in the Actions menu to display the JSON block for that dashboard.
+    # Another way to copy a dashboard is to use `GetDashboard`, and then use
+    # the data returned within `DashboardBody` as the template for the new
+    # dashboard when you call `PutDashboard`.
+    #
+    # When you create a dashboard with `PutDashboard`, a good practice is to
+    # add a text widget at the top of the dashboard with a message that the
+    # dashboard was created by script and should not be changed in the
+    # console. This message could also point console users to the location
+    # of the `DashboardBody` script or the CloudFormation template used to
+    # create the dashboard.
     #
     # @option params [String] :dashboard_name
     #   The name of the dashboard. If a dashboard with this name already
     #   exists, this call modifies that dashboard, replacing its current
     #   contents. Otherwise, a new dashboard is created. The maximum length is
-    #   255, and valid characters are A-Z, a-z, 0-9, ".", "-", and "\_".
+    #   255, and valid characters are A-Z, a-z, 0-9, "-", and "\_".
     #
     # @option params [String] :dashboard_body
     #   The detailed information about the dashboard in JSON format, including
@@ -965,9 +1005,26 @@ module Aws::CloudWatch
     #
     # @option params [required, Integer] :period
     #   The period, in seconds, over which the specified statistic is applied.
+    #   Valid values are 10, 30, and any multiple of 60.
+    #
+    #   Be sure to specify 10 or 30 only for metrics that are stored by a
+    #   `PutMetricData` call with a `StorageResolution` of 1. If you specify a
+    #   Period of 10 or 30 for a metric that does not have sub-minute
+    #   resolution, the alarm still attempts to gather data at the period rate
+    #   that you specify. In this case, it does not receive data for the
+    #   attempts that do not correspond to a one-minute data resolution, and
+    #   the alarm may often lapse into INSUFFICENT\_DATA status. Specifying 10
+    #   or 30 also sets this alarm as a high-resolution alarm, which has a
+    #   higher charge than other alarms. For more information about pricing,
+    #   see [Amazon CloudWatch Pricing][1].
+    #
     #   An alarm's total current evaluation period can be no longer than one
-    #   day, so this number multiplied by `EvaluationPeriods` must be 86,400
-    #   or less.
+    #   day, so `Period` multiplied by `EvaluationPeriods` cannot be more than
+    #   86,400 seconds.
+    #
+    #
+    #
+    #   [1]: https://aws.amazon.com/cloudwatch/pricing/
     #
     # @option params [String] :unit
     #   The unit of measure for the statistic. For example, the units for the
@@ -984,8 +1041,8 @@ module Aws::CloudWatch
     # @option params [required, Integer] :evaluation_periods
     #   The number of periods over which data is compared to the specified
     #   threshold. An alarm's total current evaluation period can be no
-    #   longer than one day, so this number multiplied by `Period` must be
-    #   86,400 or less.
+    #   longer than one day, so this number multiplied by `Period` cannot be
+    #   more than 86,400 seconds.
     #
     # @option params [required, Float] :threshold
     #   The value against which the specified statistic is compared.
@@ -1204,7 +1261,7 @@ module Aws::CloudWatch
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatch'
-      context[:gem_version] = '1.0.0.rc8'
+      context[:gem_version] = '1.0.0.rc10'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-cloudwatch/metric.rb

@@ -138,6 +138,15 @@ module Aws::CloudWatch
     #   * Start time greater than 63 days ago - Round down to the nearest
     #     1-hour clock interval. For example, 12:32:34 is rounded down to
     #     12:00:00.
+    #
+    #   If you set `Period` to 5, 10, or 30, the start time of your request is
+    #   rounded down to the nearest time that corresponds to even 5-, 10-, or
+    #   30-second divisions of a minute. For example, if you make a query at
+    #   (HH:mm:ss) 01:05:23 for the previous 10-second period, the start time
+    #   of your request is rounded down and you receive data from 01:05:10 to
+    #   01:05:20. If you make a query at 15:07:17 for the previous 5 minutes
+    #   of data, using a period of 5 seconds, you receive data timestamped
+    #   between 15:02:15 and 15:07:15.
     # @option options [required, Time,DateTime,Date,Integer,String] :end_time
     #   The time stamp that determines the last data point to return.
     #
@@ -145,13 +154,21 @@ module Aws::CloudWatch
     #   the specified time stamp. The time stamp must be in ISO 8601 UTC
     #   format (for example, 2016-10-10T23:00:00Z).
     # @option options [required, Integer] :period
-    #   The granularity, in seconds, of the returned data points. A period can
-    #   be as short as one minute (60 seconds) and must be a multiple of 60.
+    #   The granularity, in seconds, of the returned data points. For metrics
+    #   with regular resolution, a period can be as short as one minute (60
+    #   seconds) and must be a multiple of 60. For high-resolution metrics
+    #   that are collected at intervals of less than one minute, the period
+    #   can be 1, 5, 10, 30, 60, or any multiple of 60. High-resolution
+    #   metrics are those metrics stored by a `PutMetricData` call that
+    #   includes a `StorageResolution` of 1 second.
     #
     #   If the `StartTime` parameter specifies a time stamp that is greater
-    #   than 15 days ago, you must specify the period as follows or no data
+    #   than 3 hours ago, you must specify the period as follows or no data
     #   points in that time range is returned:
     #
+    #   * Start time between 3 hours and 15 days ago - Use a multiple of 60
+    #     seconds (1 minute).
+    #
     #   * Start time between 15 and 63 days ago - Use a multiple of 300
     #     seconds (5 minutes).
     #
@@ -270,9 +287,26 @@ module Aws::CloudWatch
     #   The dimensions for the metric associated with the alarm.
     # @option options [required, Integer] :period
     #   The period, in seconds, over which the specified statistic is applied.
+    #   Valid values are 10, 30, and any multiple of 60.
+    #
+    #   Be sure to specify 10 or 30 only for metrics that are stored by a
+    #   `PutMetricData` call with a `StorageResolution` of 1. If you specify a
+    #   Period of 10 or 30 for a metric that does not have sub-minute
+    #   resolution, the alarm still attempts to gather data at the period rate
+    #   that you specify. In this case, it does not receive data for the
+    #   attempts that do not correspond to a one-minute data resolution, and
+    #   the alarm may often lapse into INSUFFICENT\_DATA status. Specifying 10
+    #   or 30 also sets this alarm as a high-resolution alarm, which has a
+    #   higher charge than other alarms. For more information about pricing,
+    #   see [Amazon CloudWatch Pricing][1].
+    #
     #   An alarm's total current evaluation period can be no longer than one
-    #   day, so this number multiplied by `EvaluationPeriods` must be 86,400
-    #   or less.
+    #   day, so `Period` multiplied by `EvaluationPeriods` cannot be more than
+    #   86,400 seconds.
+    #
+    #
+    #
+    #   [1]: https://aws.amazon.com/cloudwatch/pricing/
     # @option options [String] :unit
     #   The unit of measure for the statistic. For example, the units for the
     #   Amazon EC2 NetworkIn metric are Bytes because NetworkIn tracks the
@@ -287,8 +321,8 @@ module Aws::CloudWatch
     # @option options [required, Integer] :evaluation_periods
     #   The number of periods over which data is compared to the specified
     #   threshold. An alarm's total current evaluation period can be no
-    #   longer than one day, so this number multiplied by `Period` must be
-    #   86,400 or less.
+    #   longer than one day, so this number multiplied by `Period` cannot be
+    #   more than 86,400 seconds.
     # @option options [required, Float] :threshold
     #   The value against which the specified statistic is compared.
     # @option options [required, String] :comparison_operator

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

@@ -582,6 +582,15 @@ module Aws::CloudWatch
     #   * Start time greater than 63 days ago - Round down to the nearest
     #     1-hour clock interval. For example, 12:32:34 is rounded down to
     #     12:00:00.
+    #
+    #   If you set `Period` to 5, 10, or 30, the start time of your request
+    #   is rounded down to the nearest time that corresponds to even 5-,
+    #   10-, or 30-second divisions of a minute. For example, if you make a
+    #   query at (HH:mm:ss) 01:05:23 for the previous 10-second period, the
+    #   start time of your request is rounded down and you receive data from
+    #   01:05:10 to 01:05:20. If you make a query at 15:07:17 for the
+    #   previous 5 minutes of data, using a period of 5 seconds, you receive
+    #   data timestamped between 15:02:15 and 15:07:15.
     #   @return [Time]
     #
     # @!attribute [rw] end_time
@@ -593,14 +602,22 @@ module Aws::CloudWatch
     #   @return [Time]
     #
     # @!attribute [rw] period
-    #   The granularity, in seconds, of the returned data points. A period
-    #   can be as short as one minute (60 seconds) and must be a multiple of
-    #   60.
+    #   The granularity, in seconds, of the returned data points. For
+    #   metrics with regular resolution, a period can be as short as one
+    #   minute (60 seconds) and must be a multiple of 60. For
+    #   high-resolution metrics that are collected at intervals of less than
+    #   one minute, the period can be 1, 5, 10, 30, 60, or any multiple of
+    #   60. High-resolution metrics are those metrics stored by a
+    #   `PutMetricData` call that includes a `StorageResolution` of 1
+    #   second.
     #
     #   If the `StartTime` parameter specifies a time stamp that is greater
-    #   than 15 days ago, you must specify the period as follows or no data
+    #   than 3 hours ago, you must specify the period as follows or no data
     #   points in that time range is returned:
     #
+    #   * Start time between 3 hours and 15 days ago - Use a multiple of 60
+    #     seconds (1 minute).
+    #
     #   * Start time between 15 and 63 days ago - Use a multiple of 300
     #     seconds (5 minutes).
     #
@@ -897,8 +914,8 @@ module Aws::CloudWatch
     #   Used only for alarms based on percentiles. If `ignore`, the alarm
     #   state does not change during periods with too few data points to be
     #   statistically significant. If `evaluate` or this parameter is not
-    #   used, the alarm will always be evaluated and possibly change state
-    #   no matter how many data points are available.
+    #   used, the alarm is always evaluated and possibly changes state no
+    #   matter how many data points are available.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/MetricAlarm AWS API Documentation
@@ -989,6 +1006,21 @@ module Aws::CloudWatch
     #   @return [String]
     #
     # @!attribute [rw] storage_resolution
+    #   Valid values are 1 and 60. Setting this to 1 specifies this metric
+    #   as a high-resolution metric, so that CloudWatch stores the metric
+    #   with sub-minute resolution down to one second. Setting this to 60
+    #   specifies this metric as a regular-resolution metric, which
+    #   CloudWatch stores at 1-minute resolution. Currently, high resolution
+    #   is available only for custom metrics. For more information about
+    #   high-resolution metrics, see [High-Resolution Metrics][1] in the
+    #   *Amazon CloudWatch User Guide*.
+    #
+    #   This field is optional, if you do not specify it the default of 60
+    #   is used.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/publishingMetrics.html#high-resolution-metrics
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/MetricDatum AWS API Documentation
@@ -1016,8 +1048,7 @@ module Aws::CloudWatch
     #   The name of the dashboard. If a dashboard with this name already
     #   exists, this call modifies that dashboard, replacing its current
     #   contents. Otherwise, a new dashboard is created. The maximum length
-    #   is 255, and valid characters are A-Z, a-z, 0-9, ".", "-", and
-    #   "\_".
+    #   is 255, and valid characters are A-Z, a-z, 0-9, "-", and "\_".
     #   @return [String]
     #
     # @!attribute [rw] dashboard_body
@@ -1174,9 +1205,26 @@ module Aws::CloudWatch
     #
     # @!attribute [rw] period
     #   The period, in seconds, over which the specified statistic is
-    #   applied. An alarm's total current evaluation period can be no
-    #   longer than one day, so this number multiplied by
-    #   `EvaluationPeriods` must be 86,400 or less.
+    #   applied. Valid values are 10, 30, and any multiple of 60.
+    #
+    #   Be sure to specify 10 or 30 only for metrics that are stored by a
+    #   `PutMetricData` call with a `StorageResolution` of 1. If you specify
+    #   a Period of 10 or 30 for a metric that does not have sub-minute
+    #   resolution, the alarm still attempts to gather data at the period
+    #   rate that you specify. In this case, it does not receive data for
+    #   the attempts that do not correspond to a one-minute data resolution,
+    #   and the alarm may often lapse into INSUFFICENT\_DATA status.
+    #   Specifying 10 or 30 also sets this alarm as a high-resolution alarm,
+    #   which has a higher charge than other alarms. For more information
+    #   about pricing, see [Amazon CloudWatch Pricing][1].
+    #
+    #   An alarm's total current evaluation period can be no longer than
+    #   one day, so `Period` multiplied by `EvaluationPeriods` cannot be
+    #   more than 86,400 seconds.
+    #
+    #
+    #
+    #   [1]: https://aws.amazon.com/cloudwatch/pricing/
     #   @return [Integer]
     #
     # @!attribute [rw] unit
@@ -1196,8 +1244,8 @@ module Aws::CloudWatch
     # @!attribute [rw] evaluation_periods
     #   The number of periods over which data is compared to the specified
     #   threshold. An alarm's total current evaluation period can be no
-    #   longer than one day, so this number multiplied by `Period` must be
-    #   86,400 or less.
+    #   longer than one day, so this number multiplied by `Period` cannot be
+    #   more than 86,400 seconds.
     #   @return [Integer]
     #
     # @!attribute [rw] threshold

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudwatch
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc8
+  version: 1.0.0.rc10
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-07-12 00:00:00.000000000 Z
+date: 2017-07-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0.rc17
+        version: 3.0.0.rc18
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0.rc17
+        version: 3.0.0.rc18
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement