aws-sdk-cloudwatch 1.8.0 → 1.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 7234a6f6b4421e7c3c1b101976a6a081291a9088
4
- data.tar.gz: 88b8c441642958f51a38eab163eb2207a88137d1
3
+ metadata.gz: 9e80bd151aaa83bbf7f5672165f2c5ff474f935c
4
+ data.tar.gz: e3c4961ff6cb356a55818a885986e3c078aa42ec
5
5
  SHA512:
6
- metadata.gz: 05f0e924d83278f82263794acf1a7c7e4cf3f44a7761ce62ae3b79c711a46efcdcdce6eee60f799accb138143b8979ee3d39d9ca858a3cc7d36e35c9163e8d34
7
- data.tar.gz: fa60f40509d995167d0529742ab2cf1e3b09a829a1bb647e2061f7a049859a4463278d71ab2eb3bcd0ede83785c1b904ba213f1d2017447527f6bde4edeb4db1
6
+ metadata.gz: '0846295c0e8add1a89a19e8059ed6ff428051f4c0df723929fb950d526a55e95d93c4868f904197ad638236202b64cc399cabe8a5572f2af109daddfb7f26d4e'
7
+ data.tar.gz: 8fb4423604ed589a9d2da38cbabf5e805fa4d843443c4f08a8b724bdaa42ad13fe5c4d843c60e9f2074a175f39d89396e8bd0d5cdd6b54171e57e3a92da9620c
@@ -45,6 +45,6 @@ require_relative 'aws-sdk-cloudwatch/customizations'
45
45
  # @service
46
46
  module Aws::CloudWatch
47
47
 
48
- GEM_VERSION = '1.8.0'
48
+ GEM_VERSION = '1.9.0'
49
49
 
50
50
  end
@@ -556,6 +556,30 @@ module Aws::CloudWatch
556
556
  # than calls to `GetMetricStatistics`. For more information about
557
557
  # pricing, see [Amazon CloudWatch Pricing][2].
558
558
  #
559
+ # Amazon CloudWatch retains metric data as follows:
560
+ #
561
+ # * Data points with a period of less than 60 seconds are available for
562
+ # 3 hours. These data points are high-resolution metrics and are
563
+ # available only for custom metrics that have been defined with a
564
+ # `StorageResolution` of 1.
565
+ #
566
+ # * Data points with a period of 60 seconds (1-minute) are available for
567
+ # 15 days.
568
+ #
569
+ # * Data points with a period of 300 seconds (5-minute) are available
570
+ # for 63 days.
571
+ #
572
+ # * Data points with a period of 3600 seconds (1 hour) are available for
573
+ # 455 days (15 months).
574
+ #
575
+ # Data points that are initially published with a shorter period are
576
+ # aggregated together for long-term storage. For example, if you collect
577
+ # data using a period of 1 minute, the data remains available for 15
578
+ # days with 1-minute resolution. After 15 days, this data is still
579
+ # available, but is aggregated and retrievable only with a resolution of
580
+ # 5 minutes. After 63 days, the data is further aggregated and is
581
+ # available with a resolution of 1 hour.
582
+ #
559
583
  #
560
584
  #
561
585
  # [1]: http://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html#metric-math-syntax
@@ -570,9 +594,22 @@ module Aws::CloudWatch
570
594
  # @option params [required, Time,DateTime,Date,Integer,String] :start_time
571
595
  # The time stamp indicating the earliest data to be returned.
572
596
  #
597
+ # For better performance, specify `StartTime` and `EndTime` values that
598
+ # align with the value of the metric's `Period` and sync up with the
599
+ # beginning and end of an hour. For example, if the `Period` of a metric
600
+ # is 5 minutes, specifying 12:05 or 12:30 as `StartTime` can get a
601
+ # faster response from CloudWatch then setting 12:07 or 12:29 as the
602
+ # `StartTime`.
603
+ #
573
604
  # @option params [required, Time,DateTime,Date,Integer,String] :end_time
574
605
  # The time stamp indicating the latest data to be returned.
575
606
  #
607
+ # For better performance, specify `StartTime` and `EndTime` values that
608
+ # align with the value of the metric's `Period` and sync up with the
609
+ # beginning and end of an hour. For example, if the `Period` of a metric
610
+ # is 5 minutes, specifying 12:05 or 12:30 as `EndTime` can get a faster
611
+ # response from CloudWatch then setting 12:07 or 12:29 as the `EndTime`.
612
+ #
576
613
  # @option params [String] :next_token
577
614
  # Include this value, if it was returned by the previous call, to get
578
615
  # the next set of data points.
@@ -675,6 +712,9 @@ module Aws::CloudWatch
675
712
  #
676
713
  # * The Min and the Max values of the statistic set are equal.
677
714
  #
715
+ # Percentile statistics are not available for metrics when any of the
716
+ # metric values are negative numbers.
717
+ #
678
718
  # Amazon CloudWatch retains metric data as follows:
679
719
  #
680
720
  # * Data points with a period of less than 60 seconds are available for
@@ -801,7 +841,9 @@ module Aws::CloudWatch
801
841
  # @option params [Array<String>] :extended_statistics
802
842
  # The percentile statistics. Specify values between p0.0 and p100. When
803
843
  # calling `GetMetricStatistics`, you must specify either `Statistics` or
804
- # `ExtendedStatistics`, but not both.
844
+ # `ExtendedStatistics`, but not both. Percentile statistics are not
845
+ # available for metrics when any of the metric values are negative
846
+ # numbers.
805
847
  #
806
848
  # @option params [String] :unit
807
849
  # The unit for a given metric. Metrics may be reported in multiple
@@ -861,6 +903,11 @@ module Aws::CloudWatch
861
903
  # the prefix are listed. Otherwise, all dashboards in your account are
862
904
  # listed.
863
905
  #
906
+ # `ListDashboards` returns up to 1000 results on one page. If there are
907
+ # more than 1000 dashboards, you can call `ListDashboards` again and
908
+ # include the value you received for `NextToken` in the first call, to
909
+ # receive the next 1000 results.
910
+ #
864
911
  # @option params [String] :dashboard_name_prefix
865
912
  # If you specify this parameter, only the dashboards with names starting
866
913
  # with the specified string are listed. The maximum length is 255, and
@@ -901,14 +948,14 @@ module Aws::CloudWatch
901
948
  end
902
949
 
903
950
  # List the specified metrics. You can use the returned metrics with
904
- # GetMetricStatistics to obtain statistical data.
951
+ # GetMetricData or GetMetricStatistics to obtain statistical data.
905
952
  #
906
953
  # Up to 500 results are returned for any one call. To retrieve
907
954
  # additional results, use the returned token with subsequent calls.
908
955
  #
909
956
  # After you create a metric, allow up to fifteen minutes before the
910
957
  # metric appears. Statistics about the metric, however, are available
911
- # sooner using GetMetricStatistics.
958
+ # sooner using GetMetricData or GetMetricStatistics.
912
959
  #
913
960
  # @option params [String] :namespace
914
961
  # The namespace to filter against.
@@ -965,8 +1012,8 @@ module Aws::CloudWatch
965
1012
  # existing dashboard. If you update a dashboard, the entire contents are
966
1013
  # replaced with what you specify here.
967
1014
  #
968
- # You can have up to 500 dashboards per account. All dashboards in your
969
- # account are global, not region-specific.
1015
+ # There is no limit to the number of dashboards in your account. All
1016
+ # dashboards in your account are global, not region-specific.
970
1017
  #
971
1018
  # A simple way to create a dashboard using `PutDashboard` is to copy an
972
1019
  # existing dashboard. To copy an existing dashboard using the console,
@@ -1066,11 +1113,15 @@ module Aws::CloudWatch
1066
1113
  # If you are using temporary security credentials granted using AWS STS,
1067
1114
  # you cannot stop or terminate an EC2 instance using alarm actions.
1068
1115
  #
1069
- # You must create at least one stop, terminate, or reboot alarm using
1070
- # either the Amazon EC2 or CloudWatch consoles to create the
1071
- # **EC2ActionsAccess** IAM role. After this IAM role is created, you can
1072
- # create stop, terminate, or reboot alarms using a command-line
1073
- # interface or API.
1116
+ # The first time you create an alarm in the AWS Management Console, the
1117
+ # CLI, or by using the PutMetricAlarm API, CloudWatch creates the
1118
+ # necessary service-linked role for you. The service-linked role is
1119
+ # called `AWSServiceRoleForCloudWatchEvents`. For more information about
1120
+ # service-linked roles, see [AWS service-linked role][1].
1121
+ #
1122
+ #
1123
+ #
1124
+ # [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role
1074
1125
  #
1075
1126
  # @option params [required, String] :alarm_name
1076
1127
  # The name for the alarm. This name must be unique within the AWS
@@ -1088,57 +1139,57 @@ module Aws::CloudWatch
1088
1139
  # from any other state. Each action is specified as an Amazon Resource
1089
1140
  # Name (ARN).
1090
1141
  #
1091
- # Valid Values: arn:aws:automate:*region*\:ec2:stop \|
1092
- # arn:aws:automate:*region*\:ec2:terminate \|
1093
- # arn:aws:automate:*region*\:ec2:recover \|
1094
- # arn:aws:sns:*region*\:*account-id*\:*sns-topic-name* \|
1095
- # arn:aws:autoscaling:*region*\:*account-id*\:scalingPolicy:*policy-id*
1096
- # autoScalingGroupName/*group-friendly-name*\:policyName/*policy-friendly-name*
1142
+ # Valid Values: `arn:aws:automate:region:ec2:stop` \|
1143
+ # `arn:aws:automate:region:ec2:terminate` \|
1144
+ # `arn:aws:automate:region:ec2:recover` \|
1145
+ # `arn:aws:sns:region:account-id:sns-topic-name ` \|
1146
+ # `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-idautoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
1147
+ # `
1097
1148
  #
1098
1149
  # Valid Values (for use with IAM roles):
1099
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Stop/1.0
1150
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
1100
1151
  # \|
1101
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Terminate/1.0
1152
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0`
1102
1153
  # \|
1103
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Reboot/1.0
1154
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0`
1104
1155
  #
1105
1156
  # @option params [Array<String>] :alarm_actions
1106
1157
  # The actions to execute when this alarm transitions to the `ALARM`
1107
1158
  # state from any other state. Each action is specified as an Amazon
1108
1159
  # Resource Name (ARN).
1109
1160
  #
1110
- # Valid Values: arn:aws:automate:*region*\:ec2:stop \|
1111
- # arn:aws:automate:*region*\:ec2:terminate \|
1112
- # arn:aws:automate:*region*\:ec2:recover \|
1113
- # arn:aws:sns:*region*\:*account-id*\:*sns-topic-name* \|
1114
- # arn:aws:autoscaling:*region*\:*account-id*\:scalingPolicy:*policy-id*
1115
- # autoScalingGroupName/*group-friendly-name*\:policyName/*policy-friendly-name*
1161
+ # Valid Values: `arn:aws:automate:region:ec2:stop` \|
1162
+ # `arn:aws:automate:region:ec2:terminate` \|
1163
+ # `arn:aws:automate:region:ec2:recover` \|
1164
+ # `arn:aws:sns:region:account-id:sns-topic-name ` \|
1165
+ # `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-idautoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
1166
+ # `
1116
1167
  #
1117
1168
  # Valid Values (for use with IAM roles):
1118
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Stop/1.0
1169
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
1119
1170
  # \|
1120
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Terminate/1.0
1171
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0`
1121
1172
  # \|
1122
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Reboot/1.0
1173
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0`
1123
1174
  #
1124
1175
  # @option params [Array<String>] :insufficient_data_actions
1125
1176
  # The actions to execute when this alarm transitions to the
1126
1177
  # `INSUFFICIENT_DATA` state from any other state. Each action is
1127
1178
  # specified as an Amazon Resource Name (ARN).
1128
1179
  #
1129
- # Valid Values: arn:aws:automate:*region*\:ec2:stop \|
1130
- # arn:aws:automate:*region*\:ec2:terminate \|
1131
- # arn:aws:automate:*region*\:ec2:recover \|
1132
- # arn:aws:sns:*region*\:*account-id*\:*sns-topic-name* \|
1133
- # arn:aws:autoscaling:*region*\:*account-id*\:scalingPolicy:*policy-id*
1134
- # autoScalingGroupName/*group-friendly-name*\:policyName/*policy-friendly-name*
1180
+ # Valid Values: `arn:aws:automate:region:ec2:stop` \|
1181
+ # `arn:aws:automate:region:ec2:terminate` \|
1182
+ # `arn:aws:automate:region:ec2:recover` \|
1183
+ # `arn:aws:sns:region:account-id:sns-topic-name ` \|
1184
+ # `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-idautoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
1185
+ # `
1135
1186
  #
1136
1187
  # Valid Values (for use with IAM roles):
1137
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Stop/1.0
1188
+ # `>arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
1138
1189
  # \|
1139
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Terminate/1.0
1190
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0`
1140
1191
  # \|
1141
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Reboot/1.0
1192
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0`
1142
1193
  #
1143
1194
  # @option params [required, String] :metric_name
1144
1195
  # The name for the metric associated with the alarm.
@@ -1292,14 +1343,23 @@ module Aws::CloudWatch
1292
1343
  req.send_request(options)
1293
1344
  end
1294
1345
 
1295
- # Publishes metric data points to Amazon CloudWatch. CloudWatch
1296
- # associates the data points with the specified metric. If the specified
1297
- # metric does not exist, CloudWatch creates the metric. When CloudWatch
1298
- # creates a metric, it can take up to fifteen minutes for the metric to
1299
- # appear in calls to ListMetrics.
1346
+ # Publishes metric data to Amazon CloudWatch. CloudWatch associates the
1347
+ # data with the specified metric. If the specified metric does not
1348
+ # exist, CloudWatch creates the metric. When CloudWatch creates a
1349
+ # metric, it can take up to fifteen minutes for the metric to appear in
1350
+ # calls to ListMetrics.
1351
+ #
1352
+ # You can publish either individual data points in the `Value` field, or
1353
+ # arrays of values and the number of times each value occurred during
1354
+ # the period by using the `Values` and `Counts` fields in the
1355
+ # `MetricDatum` structure. Using the `Values` and `Counts` method
1356
+ # enables you to publish up to 150 values per metric with one
1357
+ # `PutMetricData` request, and supports retrieving percentile statistics
1358
+ # on this data.
1300
1359
  #
1301
1360
  # Each `PutMetricData` request is limited to 40 KB in size for HTTP POST
1302
- # requests.
1361
+ # requests. You can send a payload compressed by gzip. Each request is
1362
+ # also limited to no more than 20 different metrics.
1303
1363
  #
1304
1364
  # Although the `Value` parameter accepts numbers of type `Double`,
1305
1365
  # CloudWatch rejects values that are either too small or too large.
@@ -1313,17 +1373,21 @@ module Aws::CloudWatch
1313
1373
  # Guide*.
1314
1374
  #
1315
1375
  # Data points with time stamps from 24 hours ago or longer can take at
1316
- # least 48 hours to become available for GetMetricStatistics from the
1317
- # time they are submitted.
1376
+ # least 48 hours to become available for GetMetricData or
1377
+ # GetMetricStatistics from the time they are submitted.
1318
1378
  #
1319
1379
  # CloudWatch needs raw data points to calculate percentile statistics.
1320
- # If you publish data using a statistic set instead, you can only
1321
- # retrieve percentile statistics for this data if one of the following
1322
- # conditions is true:
1380
+ # These raw data points could be published individually or as part of
1381
+ # `Values` and `Counts` arrays. If you publish data using statistic sets
1382
+ # in the `StatisticValues` field instead, you can only retrieve
1383
+ # percentile statistics for this data if one of the following conditions
1384
+ # is true:
1323
1385
  #
1324
- # * The SampleCount value of the statistic set is 1
1386
+ # * The `SampleCount` value of the statistic set is 1 and `Min`, `Max`,
1387
+ # and `Sum` are all equal.
1325
1388
  #
1326
- # * The Min and the Max values of the statistic set are equal
1389
+ # * The `Min` and `Max` are equal, and `Sum` is equal to `Min`
1390
+ # multiplied by `SampleCount`.
1327
1391
  #
1328
1392
  #
1329
1393
  #
@@ -1337,7 +1401,8 @@ module Aws::CloudWatch
1337
1401
  # products.
1338
1402
  #
1339
1403
  # @option params [required, Array<Types::MetricDatum>] :metric_data
1340
- # The data for the metric.
1404
+ # The data for the metric. The array can include no more than 20 metrics
1405
+ # per call.
1341
1406
  #
1342
1407
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1343
1408
  #
@@ -1362,6 +1427,8 @@ module Aws::CloudWatch
1362
1427
  # minimum: 1.0, # required
1363
1428
  # maximum: 1.0, # required
1364
1429
  # },
1430
+ # values: [1.0],
1431
+ # counts: [1.0],
1365
1432
  # 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
1366
1433
  # storage_resolution: 1,
1367
1434
  # },
@@ -1435,7 +1502,7 @@ module Aws::CloudWatch
1435
1502
  params: params,
1436
1503
  config: config)
1437
1504
  context[:gem_name] = 'aws-sdk-cloudwatch'
1438
- context[:gem_version] = '1.8.0'
1505
+ context[:gem_version] = '1.9.0'
1439
1506
  Seahorse::Client::Request.new(handlers, context)
1440
1507
  end
1441
1508
 
@@ -22,6 +22,7 @@ module Aws::CloudWatch
22
22
  AlarmNames = Shapes::ListShape.new(name: 'AlarmNames')
23
23
  AwsQueryErrorMessage = Shapes::StringShape.new(name: 'AwsQueryErrorMessage')
24
24
  ComparisonOperator = Shapes::StringShape.new(name: 'ComparisonOperator')
25
+ Counts = Shapes::ListShape.new(name: 'Counts')
25
26
  DashboardArn = Shapes::StringShape.new(name: 'DashboardArn')
26
27
  DashboardBody = Shapes::StringShape.new(name: 'DashboardBody')
27
28
  DashboardEntries = Shapes::ListShape.new(name: 'DashboardEntries')
@@ -135,6 +136,7 @@ module Aws::CloudWatch
135
136
  Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
136
137
  Timestamps = Shapes::ListShape.new(name: 'Timestamps')
137
138
  TreatMissingData = Shapes::StringShape.new(name: 'TreatMissingData')
139
+ Values = Shapes::ListShape.new(name: 'Values')
138
140
 
139
141
  AlarmHistoryItem.add_member(:alarm_name, Shapes::ShapeRef.new(shape: AlarmName, location_name: "AlarmName"))
140
142
  AlarmHistoryItem.add_member(:timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "Timestamp"))
@@ -147,6 +149,8 @@ module Aws::CloudWatch
147
149
 
148
150
  AlarmNames.member = Shapes::ShapeRef.new(shape: AlarmName)
149
151
 
152
+ Counts.member = Shapes::ShapeRef.new(shape: DatapointValue)
153
+
150
154
  DashboardEntries.member = Shapes::ShapeRef.new(shape: DashboardEntry)
151
155
 
152
156
  DashboardEntry.add_member(:dashboard_name, Shapes::ShapeRef.new(shape: DashboardName, location_name: "DashboardName"))
@@ -363,6 +367,8 @@ module Aws::CloudWatch
363
367
  MetricDatum.add_member(:timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "Timestamp"))
364
368
  MetricDatum.add_member(:value, Shapes::ShapeRef.new(shape: DatapointValue, location_name: "Value"))
365
369
  MetricDatum.add_member(:statistic_values, Shapes::ShapeRef.new(shape: StatisticSet, location_name: "StatisticValues"))
370
+ MetricDatum.add_member(:values, Shapes::ShapeRef.new(shape: Values, location_name: "Values"))
371
+ MetricDatum.add_member(:counts, Shapes::ShapeRef.new(shape: Counts, location_name: "Counts"))
366
372
  MetricDatum.add_member(:unit, Shapes::ShapeRef.new(shape: StandardUnit, location_name: "Unit"))
367
373
  MetricDatum.add_member(:storage_resolution, Shapes::ShapeRef.new(shape: StorageResolution, location_name: "StorageResolution"))
368
374
  MetricDatum.struct_class = Types::MetricDatum
@@ -425,6 +431,8 @@ module Aws::CloudWatch
425
431
 
426
432
  Timestamps.member = Shapes::ShapeRef.new(shape: Timestamp)
427
433
 
434
+ Values.member = Shapes::ShapeRef.new(shape: DatapointValue)
435
+
428
436
 
429
437
  # @api private
430
438
  API = Seahorse::Model::Api.new.tap do |api|
@@ -437,6 +445,7 @@ module Aws::CloudWatch
437
445
  "protocol" => "query",
438
446
  "serviceAbbreviation" => "CloudWatch",
439
447
  "serviceFullName" => "Amazon CloudWatch",
448
+ "serviceId" => "CloudWatch",
440
449
  "signatureVersion" => "v4",
441
450
  "uid" => "monitoring-2010-08-01",
442
451
  "xmlNamespace" => "http://monitoring.amazonaws.com/doc/2010-08-01/",
@@ -277,7 +277,9 @@ module Aws::CloudWatch
277
277
  # @option options [Array<String>] :extended_statistics
278
278
  # The percentile statistics. Specify values between p0.0 and p100. When
279
279
  # calling `GetMetricStatistics`, you must specify either `Statistics` or
280
- # `ExtendedStatistics`, but not both.
280
+ # `ExtendedStatistics`, but not both. Percentile statistics are not
281
+ # available for metrics when any of the metric values are negative
282
+ # numbers.
281
283
  # @option options [String] :unit
282
284
  # The unit for a given metric. Metrics may be reported in multiple
283
285
  # units. Not supplying a unit results in all units being returned. If
@@ -333,55 +335,55 @@ module Aws::CloudWatch
333
335
  # from any other state. Each action is specified as an Amazon Resource
334
336
  # Name (ARN).
335
337
  #
336
- # Valid Values: arn:aws:automate:*region*\:ec2:stop \|
337
- # arn:aws:automate:*region*\:ec2:terminate \|
338
- # arn:aws:automate:*region*\:ec2:recover \|
339
- # arn:aws:sns:*region*\:*account-id*\:*sns-topic-name* \|
340
- # arn:aws:autoscaling:*region*\:*account-id*\:scalingPolicy:*policy-id*
341
- # autoScalingGroupName/*group-friendly-name*\:policyName/*policy-friendly-name*
338
+ # Valid Values: `arn:aws:automate:region:ec2:stop` \|
339
+ # `arn:aws:automate:region:ec2:terminate` \|
340
+ # `arn:aws:automate:region:ec2:recover` \|
341
+ # `arn:aws:sns:region:account-id:sns-topic-name ` \|
342
+ # `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-idautoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
343
+ # `
342
344
  #
343
345
  # Valid Values (for use with IAM roles):
344
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Stop/1.0
346
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
345
347
  # \|
346
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Terminate/1.0
348
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0`
347
349
  # \|
348
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Reboot/1.0
350
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0`
349
351
  # @option options [Array<String>] :alarm_actions
350
352
  # The actions to execute when this alarm transitions to the `ALARM`
351
353
  # state from any other state. Each action is specified as an Amazon
352
354
  # Resource Name (ARN).
353
355
  #
354
- # Valid Values: arn:aws:automate:*region*\:ec2:stop \|
355
- # arn:aws:automate:*region*\:ec2:terminate \|
356
- # arn:aws:automate:*region*\:ec2:recover \|
357
- # arn:aws:sns:*region*\:*account-id*\:*sns-topic-name* \|
358
- # arn:aws:autoscaling:*region*\:*account-id*\:scalingPolicy:*policy-id*
359
- # autoScalingGroupName/*group-friendly-name*\:policyName/*policy-friendly-name*
356
+ # Valid Values: `arn:aws:automate:region:ec2:stop` \|
357
+ # `arn:aws:automate:region:ec2:terminate` \|
358
+ # `arn:aws:automate:region:ec2:recover` \|
359
+ # `arn:aws:sns:region:account-id:sns-topic-name ` \|
360
+ # `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-idautoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
361
+ # `
360
362
  #
361
363
  # Valid Values (for use with IAM roles):
362
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Stop/1.0
364
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
363
365
  # \|
364
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Terminate/1.0
366
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0`
365
367
  # \|
366
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Reboot/1.0
368
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0`
367
369
  # @option options [Array<String>] :insufficient_data_actions
368
370
  # The actions to execute when this alarm transitions to the
369
371
  # `INSUFFICIENT_DATA` state from any other state. Each action is
370
372
  # specified as an Amazon Resource Name (ARN).
371
373
  #
372
- # Valid Values: arn:aws:automate:*region*\:ec2:stop \|
373
- # arn:aws:automate:*region*\:ec2:terminate \|
374
- # arn:aws:automate:*region*\:ec2:recover \|
375
- # arn:aws:sns:*region*\:*account-id*\:*sns-topic-name* \|
376
- # arn:aws:autoscaling:*region*\:*account-id*\:scalingPolicy:*policy-id*
377
- # autoScalingGroupName/*group-friendly-name*\:policyName/*policy-friendly-name*
374
+ # Valid Values: `arn:aws:automate:region:ec2:stop` \|
375
+ # `arn:aws:automate:region:ec2:terminate` \|
376
+ # `arn:aws:automate:region:ec2:recover` \|
377
+ # `arn:aws:sns:region:account-id:sns-topic-name ` \|
378
+ # `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-idautoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
379
+ # `
378
380
  #
379
381
  # Valid Values (for use with IAM roles):
380
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Stop/1.0
382
+ # `>arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
381
383
  # \|
382
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Terminate/1.0
384
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0`
383
385
  # \|
384
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Reboot/1.0
386
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0`
385
387
  # @option options [String] :statistic
386
388
  # The statistic for the metric associated with the alarm, other than
387
389
  # percentile. For percentile statistics, use `ExtendedStatistic`. When
@@ -510,6 +512,8 @@ module Aws::CloudWatch
510
512
  # minimum: 1.0, # required
511
513
  # maximum: 1.0, # required
512
514
  # },
515
+ # values: [1.0],
516
+ # counts: [1.0],
513
517
  # 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
514
518
  # storage_resolution: 1,
515
519
  # },
@@ -517,7 +521,8 @@ module Aws::CloudWatch
517
521
  # })
518
522
  # @param [Hash] options ({})
519
523
  # @option options [required, Array<Types::MetricDatum>] :metric_data
520
- # The data for the metric.
524
+ # The data for the metric. The array can include no more than 20 metrics
525
+ # per call.
521
526
  # @return [EmptyStructure]
522
527
  def put_data(options = {})
523
528
  options = Aws::Util.deep_merge(options,
@@ -559,10 +559,24 @@ module Aws::CloudWatch
559
559
  #
560
560
  # @!attribute [rw] start_time
561
561
  # The time stamp indicating the earliest data to be returned.
562
+ #
563
+ # For better performance, specify `StartTime` and `EndTime` values
564
+ # that align with the value of the metric's `Period` and sync up with
565
+ # the beginning and end of an hour. For example, if the `Period` of a
566
+ # metric is 5 minutes, specifying 12:05 or 12:30 as `StartTime` can
567
+ # get a faster response from CloudWatch then setting 12:07 or 12:29 as
568
+ # the `StartTime`.
562
569
  # @return [Time]
563
570
  #
564
571
  # @!attribute [rw] end_time
565
572
  # The time stamp indicating the latest data to be returned.
573
+ #
574
+ # For better performance, specify `StartTime` and `EndTime` values
575
+ # that align with the value of the metric's `Period` and sync up with
576
+ # the beginning and end of an hour. For example, if the `Period` of a
577
+ # metric is 5 minutes, specifying 12:05 or 12:30 as `EndTime` can get
578
+ # a faster response from CloudWatch then setting 12:07 or 12:29 as the
579
+ # `EndTime`.
566
580
  # @return [Time]
567
581
  #
568
582
  # @!attribute [rw] next_token
@@ -731,7 +745,9 @@ module Aws::CloudWatch
731
745
  # @!attribute [rw] extended_statistics
732
746
  # The percentile statistics. Specify values between p0.0 and p100.
733
747
  # When calling `GetMetricStatistics`, you must specify either
734
- # `Statistics` or `ExtendedStatistics`, but not both.
748
+ # `Statistics` or `ExtendedStatistics`, but not both. Percentile
749
+ # statistics are not available for metrics when any of the metric
750
+ # values are negative numbers.
735
751
  # @return [Array<String>]
736
752
  #
737
753
  # @!attribute [rw] unit
@@ -1246,6 +1262,8 @@ module Aws::CloudWatch
1246
1262
  # minimum: 1.0, # required
1247
1263
  # maximum: 1.0, # required
1248
1264
  # },
1265
+ # values: [1.0],
1266
+ # counts: [1.0],
1249
1267
  # 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
1250
1268
  # storage_resolution: 1,
1251
1269
  # }
@@ -1277,6 +1295,31 @@ module Aws::CloudWatch
1277
1295
  # The statistical values for the metric.
1278
1296
  # @return [Types::StatisticSet]
1279
1297
  #
1298
+ # @!attribute [rw] values
1299
+ # Array of numbers representing the values for the metric during the
1300
+ # period. Each unique value is listed just once in this array, and the
1301
+ # corresponding number in the `Counts` array specifies the number of
1302
+ # times that value occurred during the period. You can include up to
1303
+ # 150 unique values in each `PutMetricData` action that specifies a
1304
+ # `Values` array.
1305
+ #
1306
+ # Although the `Values` array accepts numbers of type `Double`,
1307
+ # CloudWatch rejects values that are either too small or too large.
1308
+ # Values must be in the range of 8.515920e-109 to 1.174271e+108 (Base
1309
+ # 10) or 2e-360 to 2e360 (Base 2). In addition, special values (for
1310
+ # example, NaN, +Infinity, -Infinity) are not supported.
1311
+ # @return [Array<Float>]
1312
+ #
1313
+ # @!attribute [rw] counts
1314
+ # Array of numbers that is used along with the `Values` array. Each
1315
+ # number in the `Count` array is the number of times the corresponding
1316
+ # value in the `Values` array occurred during the period.
1317
+ #
1318
+ # If you omit the `Counts` array, the default of 1 is used as the
1319
+ # value for each count. If you include a `Counts` array, it must
1320
+ # include the same amount of values as the `Values` array.
1321
+ # @return [Array<Float>]
1322
+ #
1280
1323
  # @!attribute [rw] unit
1281
1324
  # The unit of the metric.
1282
1325
  # @return [String]
@@ -1307,6 +1350,8 @@ module Aws::CloudWatch
1307
1350
  :timestamp,
1308
1351
  :value,
1309
1352
  :statistic_values,
1353
+ :values,
1354
+ :counts,
1310
1355
  :unit,
1311
1356
  :storage_resolution)
1312
1357
  include Aws::Structure
@@ -1463,19 +1508,19 @@ module Aws::CloudWatch
1463
1508
  # from any other state. Each action is specified as an Amazon Resource
1464
1509
  # Name (ARN).
1465
1510
  #
1466
- # Valid Values: arn:aws:automate:*region*\:ec2:stop \|
1467
- # arn:aws:automate:*region*\:ec2:terminate \|
1468
- # arn:aws:automate:*region*\:ec2:recover \|
1469
- # arn:aws:sns:*region*\:*account-id*\:*sns-topic-name* \|
1470
- # arn:aws:autoscaling:*region*\:*account-id*\:scalingPolicy:*policy-id*
1471
- # autoScalingGroupName/*group-friendly-name*\:policyName/*policy-friendly-name*
1511
+ # Valid Values: `arn:aws:automate:region:ec2:stop` \|
1512
+ # `arn:aws:automate:region:ec2:terminate` \|
1513
+ # `arn:aws:automate:region:ec2:recover` \|
1514
+ # `arn:aws:sns:region:account-id:sns-topic-name ` \|
1515
+ # `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-idautoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
1516
+ # `
1472
1517
  #
1473
1518
  # Valid Values (for use with IAM roles):
1474
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Stop/1.0
1519
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
1475
1520
  # \|
1476
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Terminate/1.0
1521
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0`
1477
1522
  # \|
1478
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Reboot/1.0
1523
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0`
1479
1524
  # @return [Array<String>]
1480
1525
  #
1481
1526
  # @!attribute [rw] alarm_actions
@@ -1483,19 +1528,19 @@ module Aws::CloudWatch
1483
1528
  # state from any other state. Each action is specified as an Amazon
1484
1529
  # Resource Name (ARN).
1485
1530
  #
1486
- # Valid Values: arn:aws:automate:*region*\:ec2:stop \|
1487
- # arn:aws:automate:*region*\:ec2:terminate \|
1488
- # arn:aws:automate:*region*\:ec2:recover \|
1489
- # arn:aws:sns:*region*\:*account-id*\:*sns-topic-name* \|
1490
- # arn:aws:autoscaling:*region*\:*account-id*\:scalingPolicy:*policy-id*
1491
- # autoScalingGroupName/*group-friendly-name*\:policyName/*policy-friendly-name*
1531
+ # Valid Values: `arn:aws:automate:region:ec2:stop` \|
1532
+ # `arn:aws:automate:region:ec2:terminate` \|
1533
+ # `arn:aws:automate:region:ec2:recover` \|
1534
+ # `arn:aws:sns:region:account-id:sns-topic-name ` \|
1535
+ # `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-idautoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
1536
+ # `
1492
1537
  #
1493
1538
  # Valid Values (for use with IAM roles):
1494
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Stop/1.0
1539
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
1495
1540
  # \|
1496
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Terminate/1.0
1541
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0`
1497
1542
  # \|
1498
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Reboot/1.0
1543
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0`
1499
1544
  # @return [Array<String>]
1500
1545
  #
1501
1546
  # @!attribute [rw] insufficient_data_actions
@@ -1503,19 +1548,19 @@ module Aws::CloudWatch
1503
1548
  # `INSUFFICIENT_DATA` state from any other state. Each action is
1504
1549
  # specified as an Amazon Resource Name (ARN).
1505
1550
  #
1506
- # Valid Values: arn:aws:automate:*region*\:ec2:stop \|
1507
- # arn:aws:automate:*region*\:ec2:terminate \|
1508
- # arn:aws:automate:*region*\:ec2:recover \|
1509
- # arn:aws:sns:*region*\:*account-id*\:*sns-topic-name* \|
1510
- # arn:aws:autoscaling:*region*\:*account-id*\:scalingPolicy:*policy-id*
1511
- # autoScalingGroupName/*group-friendly-name*\:policyName/*policy-friendly-name*
1551
+ # Valid Values: `arn:aws:automate:region:ec2:stop` \|
1552
+ # `arn:aws:automate:region:ec2:terminate` \|
1553
+ # `arn:aws:automate:region:ec2:recover` \|
1554
+ # `arn:aws:sns:region:account-id:sns-topic-name ` \|
1555
+ # `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-idautoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
1556
+ # `
1512
1557
  #
1513
1558
  # Valid Values (for use with IAM roles):
1514
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Stop/1.0
1559
+ # `>arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
1515
1560
  # \|
1516
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Terminate/1.0
1561
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0`
1517
1562
  # \|
1518
- # arn:aws:swf:*region*\:\\\{*account-id*\\}:action/actions/AWS\_EC2.InstanceId.Reboot/1.0
1563
+ # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0`
1519
1564
  # @return [Array<String>]
1520
1565
  #
1521
1566
  # @!attribute [rw] metric_name
@@ -1691,6 +1736,8 @@ module Aws::CloudWatch
1691
1736
  # minimum: 1.0, # required
1692
1737
  # maximum: 1.0, # required
1693
1738
  # },
1739
+ # values: [1.0],
1740
+ # counts: [1.0],
1694
1741
  # 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
1695
1742
  # storage_resolution: 1,
1696
1743
  # },
@@ -1706,7 +1753,8 @@ module Aws::CloudWatch
1706
1753
  # @return [String]
1707
1754
  #
1708
1755
  # @!attribute [rw] metric_data
1709
- # The data for the metric.
1756
+ # The data for the metric. The array can include no more than 20
1757
+ # metrics per call.
1710
1758
  # @return [Array<Types::MetricDatum>]
1711
1759
  #
1712
1760
  # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutMetricDataInput AWS API Documentation
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-cloudwatch
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.8.0
4
+ version: 1.9.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2018-09-06 00:00:00.000000000 Z
11
+ date: 2018-09-17 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core