aws-sdk-cloudwatch 1.44.0 → 1.49.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
  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