aws-sdk-cloudwatch 1.8.0 → 1.9.0

Sign up to get free protection for your applications and to get access to all the features.
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