aws-sdk-cloudwatch 1.44.0 → 1.49.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
  SHA256:
3
- metadata.gz: 0be685b2a4beb76797422f844a0748eb8b529b3dc7184fc78feae952bedb7485
4
- data.tar.gz: 80b39e955a3cdc7bbc9444a56aeacf298ba7858713287d9236a43931e2c087b8
3
+ metadata.gz: c67043928d5f6438e7c92bb9ea213edb77726cea647f5906dbdcdb46a26c58ac
4
+ data.tar.gz: 1ea3c5e5edf11af48bc50814825d7a7fd7e512d22f60a135357656e8eda6688a
5
5
  SHA512:
6
- metadata.gz: 9d625a238d5f72f14f2bcfec278a463d1fa51e5878c5f4bef5ca452ff00be125de121fe84d3c309ea81990f8ed43dcdbfca320e9b8365e8250187a47c01fd1ac
7
- data.tar.gz: af43403695d5a69d67d0338c88b43889359d7d50964b7c6a6c59d2a8daea9444f38ec74817102df885479fc04fb2061593dbbfddfa7263b36da41889a2e39e19
6
+ metadata.gz: e68bb8d1ba5ccf2ee6b3f22aef33f168fc3a92ee9342528cb0a51e26a9a8a3e2fd5b5de811cc087780c144ce645f5d8ce682912b4d78cd48d9eb7ab0345a6893
7
+ data.tar.gz: 74f9753579ee23f5aaea059fbeb3b95300547dc5d05f92376f4bc1ffe5bd25805b1a44bd26b6fed97017f0957d3eb7f56032ae55f90aec95508b484f17f42131
@@ -52,6 +52,6 @@ require_relative 'aws-sdk-cloudwatch/customizations'
52
52
  # @!group service
53
53
  module Aws::CloudWatch
54
54
 
55
- GEM_VERSION = '1.44.0'
55
+ GEM_VERSION = '1.49.0'
56
56
 
57
57
  end
@@ -201,7 +201,7 @@ module Aws::CloudWatch
201
201
  # metric math expression. Each structure either retrieves a metric or
202
202
  # performs a math expression. One item in the Metrics array is the math
203
203
  # expression that the alarm watches. This expression by designated by
204
- # having `ReturnValue` set to true.
204
+ # having `ReturnData` set to true.
205
205
  # @return [Array<Types::MetricDataQuery>]
206
206
  def metrics
207
207
  data[:metrics]
@@ -557,7 +557,7 @@ module Aws::CloudWatch
557
557
  end
558
558
 
559
559
  # Retrieves the specified alarms. You can filter the results by
560
- # specifying a a prefix for the alarm name, the alarm state, or a prefix
560
+ # specifying a prefix for the alarm name, the alarm state, or a prefix
561
561
  # for any action.
562
562
  #
563
563
  # @option params [Array<String>] :alarm_names
@@ -739,6 +739,11 @@ module Aws::CloudWatch
739
739
  # Retrieves the alarms for the specified metric. To filter the results,
740
740
  # specify a statistic, period, or unit.
741
741
  #
742
+ # This operation retrieves only standard alarms that are based on the
743
+ # specified metric. It does not return alarms based on math expressions
744
+ # that use the specified metric, or composite alarms that use the
745
+ # specified metric.
746
+ #
742
747
  # @option params [required, String] :metric_name
743
748
  # The name of the metric.
744
749
  #
@@ -921,7 +926,6 @@ module Aws::CloudWatch
921
926
  end
922
927
 
923
928
  # Returns a list of all the Contributor Insights rules in your account.
924
- # All rules in your account are returned with a single operation.
925
929
  #
926
930
  # For more information about Contributor Insights, see [Using
927
931
  # Contributor Insights to Analyze High-Cardinality Data][1].
@@ -931,11 +935,12 @@ module Aws::CloudWatch
931
935
  # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html
932
936
  #
933
937
  # @option params [String] :next_token
934
- # Reserved for future use.
938
+ # Include this value, if it was returned by the previous operation, to
939
+ # get the next set of rules.
935
940
  #
936
941
  # @option params [Integer] :max_results
937
- # This parameter is not currently used. Reserved for future use. If it
938
- # is used in the future, the maximum value might be different.
942
+ # The maximum number of results to return in one operation. If you omit
943
+ # this parameter, the default of 500 is used.
939
944
  #
940
945
  # @return [Types::DescribeInsightRulesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
941
946
  #
@@ -1376,8 +1381,8 @@ module Aws::CloudWatch
1376
1381
  # response from CloudWatch than setting 12:07 or 12:29 as the `EndTime`.
1377
1382
  #
1378
1383
  # @option params [String] :next_token
1379
- # Include this value, if it was returned by the previous call, to get
1380
- # the next set of data points.
1384
+ # Include this value, if it was returned by the previous `GetMetricData`
1385
+ # operation, to get the next set of data points.
1381
1386
  #
1382
1387
  # @option params [String] :scan_by
1383
1388
  # The order in which data points should be returned.
@@ -1390,6 +1395,11 @@ module Aws::CloudWatch
1390
1395
  # The maximum number of data points the request should return before
1391
1396
  # paginating. If you omit this, the default of 100,800 is used.
1392
1397
  #
1398
+ # @option params [Types::LabelOptions] :label_options
1399
+ # This structure includes the `Timezone` parameter, which you can use to
1400
+ # specify your time zone so that the labels of returned data display the
1401
+ # correct time for your time zone.
1402
+ #
1393
1403
  # @return [Types::GetMetricDataOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1394
1404
  #
1395
1405
  # * {Types::GetMetricDataOutput#metric_data_results #metric_data_results} => Array&lt;Types::MetricDataResult&gt;
@@ -1430,6 +1440,9 @@ module Aws::CloudWatch
1430
1440
  # next_token: "NextToken",
1431
1441
  # scan_by: "TimestampDescending", # accepts TimestampDescending, TimestampAscending
1432
1442
  # max_datapoints: 1,
1443
+ # label_options: {
1444
+ # timezone: "GetMetricDataLabelTimezone",
1445
+ # },
1433
1446
  # })
1434
1447
  #
1435
1448
  # @example Response structure
@@ -1837,13 +1850,16 @@ module Aws::CloudWatch
1837
1850
  # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html
1838
1851
  #
1839
1852
  # @option params [String] :namespace
1840
- # The namespace to filter against.
1853
+ # The metric namespace to filter against. Only the namespace that
1854
+ # matches exactly will be returned.
1841
1855
  #
1842
1856
  # @option params [String] :metric_name
1843
- # The name of the metric to filter against.
1857
+ # The name of the metric to filter against. Only the metrics with names
1858
+ # that match exactly will be returned.
1844
1859
  #
1845
1860
  # @option params [Array<Types::DimensionFilter>] :dimensions
1846
- # The dimensions to filter against.
1861
+ # The dimensions to filter against. Only the dimensions that match
1862
+ # exactly will be returned.
1847
1863
  #
1848
1864
  # @option params [String] :next_token
1849
1865
  # The token returned by a previous call to indicate that there is more
@@ -1974,8 +1990,6 @@ module Aws::CloudWatch
1974
1990
  # The configuration can also include the time zone to use for the
1975
1991
  # metric.
1976
1992
  #
1977
- # You can in
1978
- #
1979
1993
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1980
1994
  #
1981
1995
  # @example Request syntax with placeholder values
@@ -2056,6 +2070,9 @@ module Aws::CloudWatch
2056
2070
  # the update completely overwrites the previous configuration of the
2057
2071
  # alarm.
2058
2072
  #
2073
+ # If you are an IAM user, you must have `iam:CreateServiceLinkedRole` to
2074
+ # create a composite alarm that has Systems Manager OpsItem actions.
2075
+ #
2059
2076
  # @option params [Boolean] :actions_enabled
2060
2077
  # Indicates whether actions should be executed during any changes to the
2061
2078
  # alarm state of the composite alarm. The default is `TRUE`.
@@ -2065,7 +2082,8 @@ module Aws::CloudWatch
2065
2082
  # state from any other state. Each action is specified as an Amazon
2066
2083
  # Resource Name (ARN).
2067
2084
  #
2068
- # Valid Values: `arn:aws:sns:region:account-id:sns-topic-name `
2085
+ # Valid Values: `arn:aws:sns:region:account-id:sns-topic-name ` \|
2086
+ # `arn:aws:ssm:region:account-id:opsitem:severity `
2069
2087
  #
2070
2088
  # @option params [String] :alarm_description
2071
2089
  # The description for the composite alarm.
@@ -2339,36 +2357,17 @@ module Aws::CloudWatch
2339
2357
  # If you are an IAM user, you must have Amazon EC2 permissions for some
2340
2358
  # alarm operations:
2341
2359
  #
2342
- # * `iam:CreateServiceLinkedRole` for all alarms with EC2 actions
2343
- #
2344
- # * `ec2:DescribeInstanceStatus` and `ec2:DescribeInstances` for all
2345
- # alarms on EC2 instance status metrics
2346
- #
2347
- # * `ec2:StopInstances` for alarms with stop actions
2348
- #
2349
- # * `ec2:TerminateInstances` for alarms with terminate actions
2350
- #
2351
- # * No specific permissions are needed for alarms with recover actions
2360
+ # * The `iam:CreateServiceLinkedRole` for all alarms with EC2 actions
2352
2361
  #
2353
- # If you have read/write permissions for Amazon CloudWatch but not for
2354
- # Amazon EC2, you can still create an alarm, but the stop or terminate
2355
- # actions are not performed. However, if you are later granted the
2356
- # required permissions, the alarm actions that you created earlier are
2357
- # performed.
2358
- #
2359
- # If you are using an IAM role (for example, an EC2 instance profile),
2360
- # you cannot stop or terminate the instance using alarm actions.
2361
- # However, you can still see the alarm state and perform any other
2362
- # actions such as Amazon SNS notifications or Auto Scaling policies.
2363
- #
2364
- # If you are using temporary security credentials granted using AWS STS,
2365
- # you cannot stop or terminate an EC2 instance using alarm actions.
2362
+ # * The `iam:CreateServiceLinkedRole` to create an alarm with Systems
2363
+ # Manager OpsItem actions.
2366
2364
  #
2367
2365
  # The first time you create an alarm in the AWS Management Console, the
2368
2366
  # CLI, or by using the PutMetricAlarm API, CloudWatch creates the
2369
- # necessary service-linked role for you. The service-linked role is
2370
- # called `AWSServiceRoleForCloudWatchEvents`. For more information, see
2371
- # [AWS service-linked role][1].
2367
+ # necessary service-linked rolea for you. The service-linked roles are
2368
+ # called `AWSServiceRoleForCloudWatchEvents` and
2369
+ # `AWSServiceRoleForCloudWatchAlarms_ActionSSM`. For more information,
2370
+ # see [AWS service-linked role][1].
2372
2371
  #
2373
2372
  #
2374
2373
  #
@@ -2415,7 +2414,7 @@ module Aws::CloudWatch
2415
2414
  # `arn:aws:automate:region:ec2:reboot` \|
2416
2415
  # `arn:aws:sns:region:account-id:sns-topic-name ` \|
2417
2416
  # `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
2418
- # `
2417
+ # ` \| `arn:aws:ssm:region:account-id:opsitem:severity `
2419
2418
  #
2420
2419
  # Valid Values (for use with IAM roles):
2421
2420
  # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
@@ -2594,8 +2593,8 @@ module Aws::CloudWatch
2594
2593
  # a math expression.
2595
2594
  #
2596
2595
  # One item in the `Metrics` array is the expression that the alarm
2597
- # watches. You designate this expression by setting `ReturnValue` to
2598
- # true for this object in the array. For more information, see
2596
+ # watches. You designate this expression by setting `ReturnData` to true
2597
+ # for this object in the array. For more information, see
2599
2598
  # [MetricDataQuery][1].
2600
2599
  #
2601
2600
  # If you use the `Metrics` parameter, you cannot include the
@@ -2616,6 +2615,15 @@ module Aws::CloudWatch
2616
2615
  # use them to scope user permissions by granting a user permission to
2617
2616
  # access or change only resources with certain tag values.
2618
2617
  #
2618
+ # If you are using this operation to update an existing alarm, any tags
2619
+ # you specify in this parameter are ignored. To change the tags of an
2620
+ # existing alarm, use [TagResource][1] or [UntagResource][2].
2621
+ #
2622
+ #
2623
+ #
2624
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html
2625
+ # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_UntagResource.html
2626
+ #
2619
2627
  # @option params [String] :threshold_metric_id
2620
2628
  # If this is an alarm based on an anomaly detection model, make this
2621
2629
  # value match the ID of the `ANOMALY_DETECTION_BAND` function.
@@ -2725,6 +2733,10 @@ module Aws::CloudWatch
2725
2733
  # pair. For more information about specifying dimensions, see
2726
2734
  # [Publishing Metrics][2] in the *Amazon CloudWatch User Guide*.
2727
2735
  #
2736
+ # You specify the time stamp to be associated with each data point. You
2737
+ # can specify time stamps that are as much as two weeks before the
2738
+ # current date, and as much as 2 hours after the current day and time.
2739
+ #
2728
2740
  # Data points with time stamps from 24 hours ago or longer can take at
2729
2741
  # least 48 hours to become available for [GetMetricData][3] or
2730
2742
  # [GetMetricStatistics][4] from the time they are submitted. Data points
@@ -2977,7 +2989,7 @@ module Aws::CloudWatch
2977
2989
  params: params,
2978
2990
  config: config)
2979
2991
  context[:gem_name] = 'aws-sdk-cloudwatch'
2980
- context[:gem_version] = '1.44.0'
2992
+ context[:gem_version] = '1.49.0'
2981
2993
  Seahorse::Client::Request.new(handlers, context)
2982
2994
  end
2983
2995
 
@@ -103,6 +103,7 @@ module Aws::CloudWatch
103
103
  GetInsightRuleReportInput = Shapes::StructureShape.new(name: 'GetInsightRuleReportInput')
104
104
  GetInsightRuleReportOutput = Shapes::StructureShape.new(name: 'GetInsightRuleReportOutput')
105
105
  GetMetricDataInput = Shapes::StructureShape.new(name: 'GetMetricDataInput')
106
+ GetMetricDataLabelTimezone = Shapes::StringShape.new(name: 'GetMetricDataLabelTimezone')
106
107
  GetMetricDataMaxDatapoints = Shapes::IntegerShape.new(name: 'GetMetricDataMaxDatapoints')
107
108
  GetMetricDataOutput = Shapes::StructureShape.new(name: 'GetMetricDataOutput')
108
109
  GetMetricStatisticsInput = Shapes::StructureShape.new(name: 'GetMetricStatisticsInput')
@@ -142,6 +143,7 @@ module Aws::CloudWatch
142
143
  InvalidNextToken = Shapes::StructureShape.new(name: 'InvalidNextToken')
143
144
  InvalidParameterCombinationException = Shapes::StructureShape.new(name: 'InvalidParameterCombinationException')
144
145
  InvalidParameterValueException = Shapes::StructureShape.new(name: 'InvalidParameterValueException')
146
+ LabelOptions = Shapes::StructureShape.new(name: 'LabelOptions')
145
147
  LastModified = Shapes::TimestampShape.new(name: 'LastModified')
146
148
  LimitExceededException = Shapes::StructureShape.new(name: 'LimitExceededException')
147
149
  LimitExceededFault = Shapes::StructureShape.new(name: 'LimitExceededFault')
@@ -466,6 +468,7 @@ module Aws::CloudWatch
466
468
  GetMetricDataInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
467
469
  GetMetricDataInput.add_member(:scan_by, Shapes::ShapeRef.new(shape: ScanBy, location_name: "ScanBy"))
468
470
  GetMetricDataInput.add_member(:max_datapoints, Shapes::ShapeRef.new(shape: GetMetricDataMaxDatapoints, location_name: "MaxDatapoints"))
471
+ GetMetricDataInput.add_member(:label_options, Shapes::ShapeRef.new(shape: LabelOptions, location_name: "LabelOptions"))
469
472
  GetMetricDataInput.struct_class = Types::GetMetricDataInput
470
473
 
471
474
  GetMetricDataOutput.add_member(:metric_data_results, Shapes::ShapeRef.new(shape: MetricDataResults, location_name: "MetricDataResults"))
@@ -551,6 +554,9 @@ module Aws::CloudWatch
551
554
  InvalidParameterValueException.add_member(:message, Shapes::ShapeRef.new(shape: AwsQueryErrorMessage, location_name: "message"))
552
555
  InvalidParameterValueException.struct_class = Types::InvalidParameterValueException
553
556
 
557
+ LabelOptions.add_member(:timezone, Shapes::ShapeRef.new(shape: GetMetricDataLabelTimezone, location_name: "Timezone"))
558
+ LabelOptions.struct_class = Types::LabelOptions
559
+
554
560
  LimitExceededException.struct_class = Types::LimitExceededException
555
561
 
556
562
  LimitExceededFault.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "message"))
@@ -399,7 +399,7 @@ module Aws::CloudWatch
399
399
  # `arn:aws:automate:region:ec2:reboot` \|
400
400
  # `arn:aws:sns:region:account-id:sns-topic-name ` \|
401
401
  # `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
402
- # `
402
+ # ` \| `arn:aws:ssm:region:account-id:opsitem:severity `
403
403
  #
404
404
  # Valid Values (for use with IAM roles):
405
405
  # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
@@ -552,8 +552,8 @@ module Aws::CloudWatch
552
552
  # a math expression.
553
553
  #
554
554
  # One item in the `Metrics` array is the expression that the alarm
555
- # watches. You designate this expression by setting `ReturnValue` to
556
- # true for this object in the array. For more information, see
555
+ # watches. You designate this expression by setting `ReturnData` to true
556
+ # for this object in the array. For more information, see
557
557
  # [MetricDataQuery][1].
558
558
  #
559
559
  # If you use the `Metrics` parameter, you cannot include the
@@ -572,6 +572,15 @@ module Aws::CloudWatch
572
572
  # Tags can help you organize and categorize your resources. You can also
573
573
  # use them to scope user permissions by granting a user permission to
574
574
  # access or change only resources with certain tag values.
575
+ #
576
+ # If you are using this operation to update an existing alarm, any tags
577
+ # you specify in this parameter are ignored. To change the tags of an
578
+ # existing alarm, use [TagResource][1] or [UntagResource][2].
579
+ #
580
+ #
581
+ #
582
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html
583
+ # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_UntagResource.html
575
584
  # @option options [String] :threshold_metric_id
576
585
  # If this is an alarm based on an anomaly detection model, make this
577
586
  # value match the ID of the `ANOMALY_DETECTION_BAND` function.
@@ -257,11 +257,14 @@ module Aws::CloudWatch
257
257
  # })
258
258
  # @param [Hash] options ({})
259
259
  # @option options [String] :namespace
260
- # The namespace to filter against.
260
+ # The metric namespace to filter against. Only the namespace that
261
+ # matches exactly will be returned.
261
262
  # @option options [String] :metric_name
262
- # The name of the metric to filter against.
263
+ # The name of the metric to filter against. Only the metrics with names
264
+ # that match exactly will be returned.
263
265
  # @option options [Array<Types::DimensionFilter>] :dimensions
264
- # The dimensions to filter against.
266
+ # The dimensions to filter against. Only the dimensions that match
267
+ # exactly will be returned.
265
268
  # @option options [String] :recently_active
266
269
  # To filter the results to show only metrics that have had data points
267
270
  # published in the past three hours, specify this parameter with a value
@@ -871,12 +871,13 @@ module Aws::CloudWatch
871
871
  # }
872
872
  #
873
873
  # @!attribute [rw] next_token
874
- # Reserved for future use.
874
+ # Include this value, if it was returned by the previous operation, to
875
+ # get the next set of rules.
875
876
  # @return [String]
876
877
  #
877
878
  # @!attribute [rw] max_results
878
- # This parameter is not currently used. Reserved for future use. If it
879
- # is used in the future, the maximum value might be different.
879
+ # The maximum number of results to return in one operation. If you
880
+ # omit this parameter, the default of 500 is used.
880
881
  # @return [Integer]
881
882
  #
882
883
  # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeInsightRulesInput AWS API Documentation
@@ -889,7 +890,8 @@ module Aws::CloudWatch
889
890
  end
890
891
 
891
892
  # @!attribute [rw] next_token
892
- # Reserved for future use.
893
+ # If this parameter is present, it is a token that marks the start of
894
+ # the next batch of returned results.
893
895
  # @return [String]
894
896
  #
895
897
  # @!attribute [rw] insight_rules
@@ -925,7 +927,8 @@ module Aws::CloudWatch
925
927
  # @return [String]
926
928
  #
927
929
  # @!attribute [rw] value
928
- # The value of the dimension.
930
+ # The value of the dimension. Dimension values cannot contain blank
931
+ # spaces or non-ASCII characters.
929
932
  # @return [String]
930
933
  #
931
934
  # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/Dimension AWS API Documentation
@@ -1294,6 +1297,9 @@ module Aws::CloudWatch
1294
1297
  # next_token: "NextToken",
1295
1298
  # scan_by: "TimestampDescending", # accepts TimestampDescending, TimestampAscending
1296
1299
  # max_datapoints: 1,
1300
+ # label_options: {
1301
+ # timezone: "GetMetricDataLabelTimezone",
1302
+ # },
1297
1303
  # }
1298
1304
  #
1299
1305
  # @!attribute [rw] metric_data_queries
@@ -1354,8 +1360,8 @@ module Aws::CloudWatch
1354
1360
  # @return [Time]
1355
1361
  #
1356
1362
  # @!attribute [rw] next_token
1357
- # Include this value, if it was returned by the previous call, to get
1358
- # the next set of data points.
1363
+ # Include this value, if it was returned by the previous
1364
+ # `GetMetricData` operation, to get the next set of data points.
1359
1365
  # @return [String]
1360
1366
  #
1361
1367
  # @!attribute [rw] scan_by
@@ -1371,6 +1377,12 @@ module Aws::CloudWatch
1371
1377
  # paginating. If you omit this, the default of 100,800 is used.
1372
1378
  # @return [Integer]
1373
1379
  #
1380
+ # @!attribute [rw] label_options
1381
+ # This structure includes the `Timezone` parameter, which you can use
1382
+ # to specify your time zone so that the labels of returned data
1383
+ # display the correct time for your time zone.
1384
+ # @return [Types::LabelOptions]
1385
+ #
1374
1386
  # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetMetricDataInput AWS API Documentation
1375
1387
  #
1376
1388
  class GetMetricDataInput < Struct.new(
@@ -1379,7 +1391,8 @@ module Aws::CloudWatch
1379
1391
  :end_time,
1380
1392
  :next_token,
1381
1393
  :scan_by,
1382
- :max_datapoints)
1394
+ :max_datapoints,
1395
+ :label_options)
1383
1396
  SENSITIVE = []
1384
1397
  include Aws::Structure
1385
1398
  end
@@ -1923,6 +1936,42 @@ module Aws::CloudWatch
1923
1936
  include Aws::Structure
1924
1937
  end
1925
1938
 
1939
+ # This structure includes the `Timezone` parameter, which you can use to
1940
+ # specify your time zone so that the labels that are associated with
1941
+ # returned metrics display the correct time for your time zone.
1942
+ #
1943
+ # The `Timezone` value affects a label only if you have a time-based
1944
+ # dynamic expression in the label. For more information about dynamic
1945
+ # expressions in labels, see [Using Dynamic Labels][1].
1946
+ #
1947
+ #
1948
+ #
1949
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html
1950
+ #
1951
+ # @note When making an API call, you may pass LabelOptions
1952
+ # data as a hash:
1953
+ #
1954
+ # {
1955
+ # timezone: "GetMetricDataLabelTimezone",
1956
+ # }
1957
+ #
1958
+ # @!attribute [rw] timezone
1959
+ # The time zone to use for metric data return in this operation. The
1960
+ # format is `+` or `-` followed by four digits. The first two digits
1961
+ # indicate the number of hours ahead or behind of UTC, and the final
1962
+ # two digits are the number of minutes. For example, +0130 indicates a
1963
+ # time zone that is 1 hour and 30 minutes ahead of UTC. The default is
1964
+ # +0000.
1965
+ # @return [String]
1966
+ #
1967
+ # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/LabelOptions AWS API Documentation
1968
+ #
1969
+ class LabelOptions < Struct.new(
1970
+ :timezone)
1971
+ SENSITIVE = []
1972
+ include Aws::Structure
1973
+ end
1974
+
1926
1975
  # The operation exceeded one or more limits.
1927
1976
  #
1928
1977
  # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/LimitExceededException AWS API Documentation
@@ -2006,15 +2055,18 @@ module Aws::CloudWatch
2006
2055
  # }
2007
2056
  #
2008
2057
  # @!attribute [rw] namespace
2009
- # The namespace to filter against.
2058
+ # The metric namespace to filter against. Only the namespace that
2059
+ # matches exactly will be returned.
2010
2060
  # @return [String]
2011
2061
  #
2012
2062
  # @!attribute [rw] metric_name
2013
- # The name of the metric to filter against.
2063
+ # The name of the metric to filter against. Only the metrics with
2064
+ # names that match exactly will be returned.
2014
2065
  # @return [String]
2015
2066
  #
2016
2067
  # @!attribute [rw] dimensions
2017
- # The dimensions to filter against.
2068
+ # The dimensions to filter against. Only the dimensions that match
2069
+ # exactly will be returned.
2018
2070
  # @return [Array<Types::DimensionFilter>]
2019
2071
  #
2020
2072
  # @!attribute [rw] next_token
@@ -2294,7 +2346,7 @@ module Aws::CloudWatch
2294
2346
  # metric math expression. Each structure either retrieves a metric or
2295
2347
  # performs a math expression. One item in the Metrics array is the
2296
2348
  # math expression that the alarm watches. This expression by
2297
- # designated by having `ReturnValue` set to true.
2349
+ # designated by having `ReturnData` set to true.
2298
2350
  # @return [Array<Types::MetricDataQuery>]
2299
2351
  #
2300
2352
  # @!attribute [rw] threshold_metric_id
@@ -2439,6 +2491,13 @@ module Aws::CloudWatch
2439
2491
  # the value represents. If the metric or expression is shown in a
2440
2492
  # CloudWatch dashboard widget, the label is shown. If Label is
2441
2493
  # omitted, CloudWatch generates a default.
2494
+ #
2495
+ # You can put dynamic expressions into a label, so that it is more
2496
+ # descriptive. For more information, see [Using Dynamic Labels][1].
2497
+ #
2498
+ #
2499
+ #
2500
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html
2442
2501
  # @return [String]
2443
2502
  #
2444
2503
  # @!attribute [rw] return_data
@@ -2823,8 +2882,6 @@ module Aws::CloudWatch
2823
2882
  #
2824
2883
  # The configuration can also include the time zone to use for the
2825
2884
  # metric.
2826
- #
2827
- # You can in
2828
2885
  # @return [Types::AnomalyDetectorConfiguration]
2829
2886
  #
2830
2887
  # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutAnomalyDetectorInput AWS API Documentation
@@ -2872,7 +2929,8 @@ module Aws::CloudWatch
2872
2929
  # state from any other state. Each action is specified as an Amazon
2873
2930
  # Resource Name (ARN).
2874
2931
  #
2875
- # Valid Values: `arn:aws:sns:region:account-id:sns-topic-name `
2932
+ # Valid Values: `arn:aws:sns:region:account-id:sns-topic-name ` \|
2933
+ # `arn:aws:ssm:region:account-id:opsitem:severity `
2876
2934
  # @return [Array<String>]
2877
2935
  #
2878
2936
  # @!attribute [rw] alarm_description
@@ -3217,7 +3275,7 @@ module Aws::CloudWatch
3217
3275
  # `arn:aws:automate:region:ec2:reboot` \|
3218
3276
  # `arn:aws:sns:region:account-id:sns-topic-name ` \|
3219
3277
  # `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
3220
- # `
3278
+ # ` \| `arn:aws:ssm:region:account-id:opsitem:severity `
3221
3279
  #
3222
3280
  # Valid Values (for use with IAM roles):
3223
3281
  # `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
@@ -3414,7 +3472,7 @@ module Aws::CloudWatch
3414
3472
  # performs a math expression.
3415
3473
  #
3416
3474
  # One item in the `Metrics` array is the expression that the alarm
3417
- # watches. You designate this expression by setting `ReturnValue` to
3475
+ # watches. You designate this expression by setting `ReturnData` to
3418
3476
  # true for this object in the array. For more information, see
3419
3477
  # [MetricDataQuery][1].
3420
3478
  #
@@ -3437,6 +3495,15 @@ module Aws::CloudWatch
3437
3495
  # also use them to scope user permissions by granting a user
3438
3496
  # permission to access or change only resources with certain tag
3439
3497
  # values.
3498
+ #
3499
+ # If you are using this operation to update an existing alarm, any
3500
+ # tags you specify in this parameter are ignored. To change the tags
3501
+ # of an existing alarm, use [TagResource][1] or [UntagResource][2].
3502
+ #
3503
+ #
3504
+ #
3505
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html
3506
+ # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_UntagResource.html
3440
3507
  # @return [Array<Types::Tag>]
3441
3508
  #
3442
3509
  # @!attribute [rw] threshold_metric_id
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.44.0
4
+ version: 1.49.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: 2020-09-15 00:00:00.000000000 Z
11
+ date: 2021-02-02 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
19
19
  version: '3'
20
20
  - - ">="
21
21
  - !ruby/object:Gem::Version
22
- version: 3.99.0
22
+ version: 3.112.0
23
23
  type: :runtime
24
24
  prerelease: false
25
25
  version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
29
29
  version: '3'
30
30
  - - ">="
31
31
  - !ruby/object:Gem::Version
32
- version: 3.99.0
32
+ version: 3.112.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement