aws-sdk-cloudwatch 1.50.0 → 1.54.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +20 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-cloudwatch.rb +1 -1
- data/lib/aws-sdk-cloudwatch/client.rb +353 -15
- data/lib/aws-sdk-cloudwatch/client_api.rb +168 -0
- data/lib/aws-sdk-cloudwatch/customizations.rb +1 -1
- data/lib/aws-sdk-cloudwatch/metric.rb +7 -1
- data/lib/aws-sdk-cloudwatch/types.rb +441 -12
- metadata +7 -8
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: ad7c17e9b939bf1d29e5ba7c140c4f22a16bd6fe8afcfecf3317684b17b8af4d
|
4
|
+
data.tar.gz: bd2b9f60dc3d02d12fcdf743bcf533283880353f0c4beb34de15ec2bef560dc3
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: '099a12cb4b55528993be39ce3d5fe691246733b1874d353d03f63385026174c70c6fb51bce0aa0ca7b8ac97d14bff5dadde2a41f49b854f192a468c2403b5120'
|
7
|
+
data.tar.gz: 883037f6c9aeb7977b960a0f44c37d22cdbf89b2b9035131756f4014f0f69444a813e8b18ef0f16a45c2c4a4957ed7a80aab4a78f5baf40ca3312a538ce2d74b
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,26 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.54.0 (2021-07-30)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
8
|
+
|
9
|
+
1.53.0 (2021-07-28)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
13
|
+
|
14
|
+
1.52.0 (2021-07-26)
|
15
|
+
------------------
|
16
|
+
|
17
|
+
* Feature - SDK update to support creation of Cross-Account Metric Alarms and update API documentation.
|
18
|
+
|
19
|
+
1.51.0 (2021-03-30)
|
20
|
+
------------------
|
21
|
+
|
22
|
+
* Feature - SDK update for new Metric Streams feature
|
23
|
+
|
4
24
|
1.50.0 (2021-03-10)
|
5
25
|
------------------
|
6
26
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.54.0
|
data/lib/aws-sdk-cloudwatch.rb
CHANGED
@@ -478,6 +478,28 @@ module Aws::CloudWatch
|
|
478
478
|
req.send_request(options)
|
479
479
|
end
|
480
480
|
|
481
|
+
# Permanently deletes the metric stream that you specify.
|
482
|
+
#
|
483
|
+
# @option params [required, String] :name
|
484
|
+
# The name of the metric stream to delete.
|
485
|
+
#
|
486
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
487
|
+
#
|
488
|
+
# @example Request syntax with placeholder values
|
489
|
+
#
|
490
|
+
# resp = client.delete_metric_stream({
|
491
|
+
# name: "MetricStreamName", # required
|
492
|
+
# })
|
493
|
+
#
|
494
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DeleteMetricStream AWS API Documentation
|
495
|
+
#
|
496
|
+
# @overload delete_metric_stream(params = {})
|
497
|
+
# @param [Hash] params ({})
|
498
|
+
def delete_metric_stream(params = {}, options = {})
|
499
|
+
req = build_request(:delete_metric_stream, params)
|
500
|
+
req.send_request(options)
|
501
|
+
end
|
502
|
+
|
481
503
|
# Retrieves the history for the specified alarm. You can filter the
|
482
504
|
# results by date range or item type. If an alarm name is not specified,
|
483
505
|
# the histories for either all metric alarms or all composite alarms are
|
@@ -718,6 +740,7 @@ module Aws::CloudWatch
|
|
718
740
|
# resp.metric_alarms[0].metrics[0].label #=> String
|
719
741
|
# resp.metric_alarms[0].metrics[0].return_data #=> Boolean
|
720
742
|
# resp.metric_alarms[0].metrics[0].period #=> Integer
|
743
|
+
# resp.metric_alarms[0].metrics[0].account_id #=> String
|
721
744
|
# resp.metric_alarms[0].threshold_metric_id #=> String
|
722
745
|
# resp.next_token #=> String
|
723
746
|
#
|
@@ -837,6 +860,7 @@ module Aws::CloudWatch
|
|
837
860
|
# resp.metric_alarms[0].metrics[0].label #=> String
|
838
861
|
# resp.metric_alarms[0].metrics[0].return_data #=> Boolean
|
839
862
|
# resp.metric_alarms[0].metrics[0].period #=> Integer
|
863
|
+
# resp.metric_alarms[0].metrics[0].account_id #=> String
|
840
864
|
# resp.metric_alarms[0].threshold_metric_id #=> String
|
841
865
|
#
|
842
866
|
# @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAlarmsForMetric AWS API Documentation
|
@@ -1433,6 +1457,7 @@ module Aws::CloudWatch
|
|
1433
1457
|
# label: "MetricLabel",
|
1434
1458
|
# return_data: false,
|
1435
1459
|
# period: 1,
|
1460
|
+
# account_id: "AccountId",
|
1436
1461
|
# },
|
1437
1462
|
# ],
|
1438
1463
|
# start_time: Time.now, # required
|
@@ -1527,8 +1552,8 @@ module Aws::CloudWatch
|
|
1527
1552
|
# CloudWatch started retaining 5-minute and 1-hour metric data as of
|
1528
1553
|
# July 9, 2016.
|
1529
1554
|
#
|
1530
|
-
# For information about metrics and dimensions supported by
|
1531
|
-
# services, see the [Amazon CloudWatch Metrics and Dimensions
|
1555
|
+
# For information about metrics and dimensions supported by Amazon Web
|
1556
|
+
# Services services, see the [Amazon CloudWatch Metrics and Dimensions
|
1532
1557
|
# Reference][1] in the *Amazon CloudWatch User Guide*.
|
1533
1558
|
#
|
1534
1559
|
#
|
@@ -1686,6 +1711,54 @@ module Aws::CloudWatch
|
|
1686
1711
|
req.send_request(options)
|
1687
1712
|
end
|
1688
1713
|
|
1714
|
+
# Returns information about the metric stream that you specify.
|
1715
|
+
#
|
1716
|
+
# @option params [required, String] :name
|
1717
|
+
# The name of the metric stream to retrieve information about.
|
1718
|
+
#
|
1719
|
+
# @return [Types::GetMetricStreamOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1720
|
+
#
|
1721
|
+
# * {Types::GetMetricStreamOutput#arn #arn} => String
|
1722
|
+
# * {Types::GetMetricStreamOutput#name #name} => String
|
1723
|
+
# * {Types::GetMetricStreamOutput#include_filters #include_filters} => Array<Types::MetricStreamFilter>
|
1724
|
+
# * {Types::GetMetricStreamOutput#exclude_filters #exclude_filters} => Array<Types::MetricStreamFilter>
|
1725
|
+
# * {Types::GetMetricStreamOutput#firehose_arn #firehose_arn} => String
|
1726
|
+
# * {Types::GetMetricStreamOutput#role_arn #role_arn} => String
|
1727
|
+
# * {Types::GetMetricStreamOutput#state #state} => String
|
1728
|
+
# * {Types::GetMetricStreamOutput#creation_date #creation_date} => Time
|
1729
|
+
# * {Types::GetMetricStreamOutput#last_update_date #last_update_date} => Time
|
1730
|
+
# * {Types::GetMetricStreamOutput#output_format #output_format} => String
|
1731
|
+
#
|
1732
|
+
# @example Request syntax with placeholder values
|
1733
|
+
#
|
1734
|
+
# resp = client.get_metric_stream({
|
1735
|
+
# name: "MetricStreamName", # required
|
1736
|
+
# })
|
1737
|
+
#
|
1738
|
+
# @example Response structure
|
1739
|
+
#
|
1740
|
+
# resp.arn #=> String
|
1741
|
+
# resp.name #=> String
|
1742
|
+
# resp.include_filters #=> Array
|
1743
|
+
# resp.include_filters[0].namespace #=> String
|
1744
|
+
# resp.exclude_filters #=> Array
|
1745
|
+
# resp.exclude_filters[0].namespace #=> String
|
1746
|
+
# resp.firehose_arn #=> String
|
1747
|
+
# resp.role_arn #=> String
|
1748
|
+
# resp.state #=> String
|
1749
|
+
# resp.creation_date #=> Time
|
1750
|
+
# resp.last_update_date #=> Time
|
1751
|
+
# resp.output_format #=> String, one of "json", "opentelemetry0.7"
|
1752
|
+
#
|
1753
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetMetricStream AWS API Documentation
|
1754
|
+
#
|
1755
|
+
# @overload get_metric_stream(params = {})
|
1756
|
+
# @param [Hash] params ({})
|
1757
|
+
def get_metric_stream(params = {}, options = {})
|
1758
|
+
req = build_request(:get_metric_stream, params)
|
1759
|
+
req.send_request(options)
|
1760
|
+
end
|
1761
|
+
|
1689
1762
|
# You can use the `GetMetricWidgetImage` API to retrieve a snapshot
|
1690
1763
|
# graph of one or more Amazon CloudWatch metrics as a bitmap image. You
|
1691
1764
|
# can then embed this image into your services and products, such as
|
@@ -1749,8 +1822,8 @@ module Aws::CloudWatch
|
|
1749
1822
|
# `</GetMetricWidgetImageResponse>`
|
1750
1823
|
#
|
1751
1824
|
# The `image/png` setting is intended only for custom HTTP requests. For
|
1752
|
-
# most use cases, and all actions using an
|
1753
|
-
# `png`. If you specify `image/png`, the HTTP response has a
|
1825
|
+
# most use cases, and all actions using an Amazon Web Services SDK, you
|
1826
|
+
# should use `png`. If you specify `image/png`, the HTTP response has a
|
1754
1827
|
# content-type set to `image/png`, and the body of the response is a PNG
|
1755
1828
|
# image.
|
1756
1829
|
#
|
@@ -1829,6 +1902,50 @@ module Aws::CloudWatch
|
|
1829
1902
|
req.send_request(options)
|
1830
1903
|
end
|
1831
1904
|
|
1905
|
+
# Returns a list of metric streams in this account.
|
1906
|
+
#
|
1907
|
+
# @option params [String] :next_token
|
1908
|
+
# Include this value, if it was returned by the previous call, to get
|
1909
|
+
# the next set of metric streams.
|
1910
|
+
#
|
1911
|
+
# @option params [Integer] :max_results
|
1912
|
+
# The maximum number of results to return in one operation.
|
1913
|
+
#
|
1914
|
+
# @return [Types::ListMetricStreamsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1915
|
+
#
|
1916
|
+
# * {Types::ListMetricStreamsOutput#next_token #next_token} => String
|
1917
|
+
# * {Types::ListMetricStreamsOutput#entries #data.entries} => Array<Types::MetricStreamEntry> (This method conflicts with a method on Response, call it through the data member)
|
1918
|
+
#
|
1919
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
1920
|
+
#
|
1921
|
+
# @example Request syntax with placeholder values
|
1922
|
+
#
|
1923
|
+
# resp = client.list_metric_streams({
|
1924
|
+
# next_token: "NextToken",
|
1925
|
+
# max_results: 1,
|
1926
|
+
# })
|
1927
|
+
#
|
1928
|
+
# @example Response structure
|
1929
|
+
#
|
1930
|
+
# resp.next_token #=> String
|
1931
|
+
# resp.data.entries #=> Array
|
1932
|
+
# resp.data.entries[0].arn #=> String
|
1933
|
+
# resp.data.entries[0].creation_date #=> Time
|
1934
|
+
# resp.data.entries[0].last_update_date #=> Time
|
1935
|
+
# resp.data.entries[0].name #=> String
|
1936
|
+
# resp.data.entries[0].firehose_arn #=> String
|
1937
|
+
# resp.data.entries[0].state #=> String
|
1938
|
+
# resp.data.entries[0].output_format #=> String, one of "json", "opentelemetry0.7"
|
1939
|
+
#
|
1940
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/ListMetricStreams AWS API Documentation
|
1941
|
+
#
|
1942
|
+
# @overload list_metric_streams(params = {})
|
1943
|
+
# @param [Hash] params ({})
|
1944
|
+
def list_metric_streams(params = {}, options = {})
|
1945
|
+
req = build_request(:list_metric_streams, params)
|
1946
|
+
req.send_request(options)
|
1947
|
+
end
|
1948
|
+
|
1832
1949
|
# List the specified metrics. You can use the returned metrics with
|
1833
1950
|
# [GetMetricData][1] or [GetMetricStatistics][2] to obtain statistical
|
1834
1951
|
# data.
|
@@ -2362,16 +2479,39 @@ module Aws::CloudWatch
|
|
2362
2479
|
# * The `iam:CreateServiceLinkedRole` to create an alarm with Systems
|
2363
2480
|
# Manager OpsItem actions.
|
2364
2481
|
#
|
2365
|
-
# The first time you create an alarm in the
|
2366
|
-
#
|
2367
|
-
#
|
2368
|
-
#
|
2482
|
+
# The first time you create an alarm in the Management Console, the CLI,
|
2483
|
+
# or by using the PutMetricAlarm API, CloudWatch creates the necessary
|
2484
|
+
# service-linked role for you. The service-linked roles are called
|
2485
|
+
# `AWSServiceRoleForCloudWatchEvents` and
|
2369
2486
|
# `AWSServiceRoleForCloudWatchAlarms_ActionSSM`. For more information,
|
2370
|
-
# see [
|
2487
|
+
# see [Amazon Web Services service-linked role][1].
|
2488
|
+
#
|
2489
|
+
# **Cross-account alarms**
|
2490
|
+
#
|
2491
|
+
# You can set an alarm on metrics in the current account, or in another
|
2492
|
+
# account. To create a cross-account alarm that watches a metric in a
|
2493
|
+
# different account, you must have completed the following
|
2494
|
+
# pre-requisites:
|
2495
|
+
#
|
2496
|
+
# * The account where the metrics are located (the *sharing account*)
|
2497
|
+
# must already have a sharing role named
|
2498
|
+
# **CloudWatch-CrossAccountSharingRole**. If it does not already have
|
2499
|
+
# this role, you must create it using the instructions in **Set up a
|
2500
|
+
# sharing account** in [ Cross-account cross-Region CloudWatch
|
2501
|
+
# console][2]. The policy for that role must grant access to the ID of
|
2502
|
+
# the account where you are creating the alarm.
|
2503
|
+
#
|
2504
|
+
# * The account where you are creating the alarm (the *monitoring
|
2505
|
+
# account*) must already have a service-linked role named
|
2506
|
+
# **AWSServiceRoleForCloudWatchCrossAccount** to allow CloudWatch to
|
2507
|
+
# assume the sharing role in the sharing account. If it does not, you
|
2508
|
+
# must create it following the directions in **Set up a monitoring
|
2509
|
+
# account** in [ Cross-account cross-Region CloudWatch console][2].
|
2371
2510
|
#
|
2372
2511
|
#
|
2373
2512
|
#
|
2374
2513
|
# [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role
|
2514
|
+
# [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Cross-Account-Cross-Region.html#enable-cross-account-cross-Region
|
2375
2515
|
#
|
2376
2516
|
# @option params [required, String] :alarm_name
|
2377
2517
|
# The name for the alarm. This name must be unique within the Region.
|
@@ -2402,6 +2542,8 @@ module Aws::CloudWatch
|
|
2402
2542
|
# `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0`
|
2403
2543
|
# \|
|
2404
2544
|
# `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0`
|
2545
|
+
# \|
|
2546
|
+
# `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Recover/1.0`
|
2405
2547
|
#
|
2406
2548
|
# @option params [Array<String>] :alarm_actions
|
2407
2549
|
# The actions to execute when this alarm transitions to the `ALARM`
|
@@ -2414,7 +2556,8 @@ module Aws::CloudWatch
|
|
2414
2556
|
# `arn:aws:automate:region:ec2:reboot` \|
|
2415
2557
|
# `arn:aws:sns:region:account-id:sns-topic-name ` \|
|
2416
2558
|
# `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
|
2417
|
-
# ` \| `arn:aws:ssm:region:account-id:opsitem:severity `
|
2559
|
+
# ` \| `arn:aws:ssm:region:account-id:opsitem:severity ` \|
|
2560
|
+
# `arn:aws:ssm-incidents::account-id:response-plan:response-plan-name `
|
2418
2561
|
#
|
2419
2562
|
# Valid Values (for use with IAM roles):
|
2420
2563
|
# `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
|
@@ -2422,6 +2565,8 @@ module Aws::CloudWatch
|
|
2422
2565
|
# `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0`
|
2423
2566
|
# \|
|
2424
2567
|
# `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0`
|
2568
|
+
# \|
|
2569
|
+
# `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Recover/1.0`
|
2425
2570
|
#
|
2426
2571
|
# @option params [Array<String>] :insufficient_data_actions
|
2427
2572
|
# The actions to execute when this alarm transitions to the
|
@@ -2685,6 +2830,7 @@ module Aws::CloudWatch
|
|
2685
2830
|
# label: "MetricLabel",
|
2686
2831
|
# return_data: false,
|
2687
2832
|
# period: 1,
|
2833
|
+
# account_id: "AccountId",
|
2688
2834
|
# },
|
2689
2835
|
# ],
|
2690
2836
|
# tags: [
|
@@ -2765,8 +2911,8 @@ module Aws::CloudWatch
|
|
2765
2911
|
# @option params [required, String] :namespace
|
2766
2912
|
# The namespace for the metric data.
|
2767
2913
|
#
|
2768
|
-
# To avoid conflicts with
|
2769
|
-
# a namespace that begins with `AWS/`
|
2914
|
+
# To avoid conflicts with Amazon Web Services service namespaces, you
|
2915
|
+
# should not specify a namespace that begins with `AWS/`
|
2770
2916
|
#
|
2771
2917
|
# @option params [required, Array<Types::MetricDatum>] :metric_data
|
2772
2918
|
# The data for the metric. The array can include no more than 20 metrics
|
@@ -2812,6 +2958,145 @@ module Aws::CloudWatch
|
|
2812
2958
|
req.send_request(options)
|
2813
2959
|
end
|
2814
2960
|
|
2961
|
+
# Creates or updates a metric stream. Metric streams can automatically
|
2962
|
+
# stream CloudWatch metrics to Amazon Web Services destinations
|
2963
|
+
# including Amazon S3 and to many third-party solutions.
|
2964
|
+
#
|
2965
|
+
# For more information, see [ Using Metric Streams][1].
|
2966
|
+
#
|
2967
|
+
# To create a metric stream, you must be logged on to an account that
|
2968
|
+
# has the `iam:PassRole` permission and either the
|
2969
|
+
# `CloudWatchFullAccess` policy or the `cloudwatch:PutMetricStream`
|
2970
|
+
# permission.
|
2971
|
+
#
|
2972
|
+
# When you create or update a metric stream, you choose one of the
|
2973
|
+
# following:
|
2974
|
+
#
|
2975
|
+
# * Stream metrics from all metric namespaces in the account.
|
2976
|
+
#
|
2977
|
+
# * Stream metrics from all metric namespaces in the account, except for
|
2978
|
+
# the namespaces that you list in `ExcludeFilters`.
|
2979
|
+
#
|
2980
|
+
# * Stream metrics from only the metric namespaces that you list in
|
2981
|
+
# `IncludeFilters`.
|
2982
|
+
#
|
2983
|
+
# When you use `PutMetricStream` to create a new metric stream, the
|
2984
|
+
# stream is created in the `running` state. If you use it to update an
|
2985
|
+
# existing stream, the state of the stream is not changed.
|
2986
|
+
#
|
2987
|
+
#
|
2988
|
+
#
|
2989
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Metric-Streams.html
|
2990
|
+
#
|
2991
|
+
# @option params [required, String] :name
|
2992
|
+
# If you are creating a new metric stream, this is the name for the new
|
2993
|
+
# stream. The name must be different than the names of other metric
|
2994
|
+
# streams in this account and Region.
|
2995
|
+
#
|
2996
|
+
# If you are updating a metric stream, specify the name of that stream
|
2997
|
+
# here.
|
2998
|
+
#
|
2999
|
+
# Valid characters are A-Z, a-z, 0-9, "-" and "\_".
|
3000
|
+
#
|
3001
|
+
# @option params [Array<Types::MetricStreamFilter>] :include_filters
|
3002
|
+
# If you specify this parameter, the stream sends only the metrics from
|
3003
|
+
# the metric namespaces that you specify here.
|
3004
|
+
#
|
3005
|
+
# You cannot include `IncludeFilters` and `ExcludeFilters` in the same
|
3006
|
+
# operation.
|
3007
|
+
#
|
3008
|
+
# @option params [Array<Types::MetricStreamFilter>] :exclude_filters
|
3009
|
+
# If you specify this parameter, the stream sends metrics from all
|
3010
|
+
# metric namespaces except for the namespaces that you specify here.
|
3011
|
+
#
|
3012
|
+
# You cannot include `ExcludeFilters` and `IncludeFilters` in the same
|
3013
|
+
# operation.
|
3014
|
+
#
|
3015
|
+
# @option params [required, String] :firehose_arn
|
3016
|
+
# The ARN of the Amazon Kinesis Firehose delivery stream to use for this
|
3017
|
+
# metric stream. This Amazon Kinesis Firehose delivery stream must
|
3018
|
+
# already exist and must be in the same account as the metric stream.
|
3019
|
+
#
|
3020
|
+
# @option params [required, String] :role_arn
|
3021
|
+
# The ARN of an IAM role that this metric stream will use to access
|
3022
|
+
# Amazon Kinesis Firehose resources. This IAM role must already exist
|
3023
|
+
# and must be in the same account as the metric stream. This IAM role
|
3024
|
+
# must include the following permissions:
|
3025
|
+
#
|
3026
|
+
# * firehose:PutRecord
|
3027
|
+
#
|
3028
|
+
# * firehose:PutRecordBatch
|
3029
|
+
#
|
3030
|
+
# @option params [required, String] :output_format
|
3031
|
+
# The output format for the stream. Valid values are `json` and
|
3032
|
+
# `opentelemetry0.7`. For more information about metric stream output
|
3033
|
+
# formats, see [ Metric streams output formats][1].
|
3034
|
+
#
|
3035
|
+
#
|
3036
|
+
#
|
3037
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-metric-streams-formats.html
|
3038
|
+
#
|
3039
|
+
# @option params [Array<Types::Tag>] :tags
|
3040
|
+
# A list of key-value pairs to associate with the metric stream. You can
|
3041
|
+
# associate as many as 50 tags with a metric stream.
|
3042
|
+
#
|
3043
|
+
# Tags can help you organize and categorize your resources. You can also
|
3044
|
+
# use them to scope user permissions by granting a user permission to
|
3045
|
+
# access or change only resources with certain tag values.
|
3046
|
+
#
|
3047
|
+
# You can use this parameter only when you are creating a new metric
|
3048
|
+
# stream. If you are using this operation to update an existing metric
|
3049
|
+
# stream, any tags you specify in this parameter are ignored. To change
|
3050
|
+
# the tags of an existing metric stream, use [TagResource][1] or
|
3051
|
+
# [UntagResource][2].
|
3052
|
+
#
|
3053
|
+
#
|
3054
|
+
#
|
3055
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html
|
3056
|
+
# [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_UntagResource.html
|
3057
|
+
#
|
3058
|
+
# @return [Types::PutMetricStreamOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3059
|
+
#
|
3060
|
+
# * {Types::PutMetricStreamOutput#arn #arn} => String
|
3061
|
+
#
|
3062
|
+
# @example Request syntax with placeholder values
|
3063
|
+
#
|
3064
|
+
# resp = client.put_metric_stream({
|
3065
|
+
# name: "MetricStreamName", # required
|
3066
|
+
# include_filters: [
|
3067
|
+
# {
|
3068
|
+
# namespace: "Namespace",
|
3069
|
+
# },
|
3070
|
+
# ],
|
3071
|
+
# exclude_filters: [
|
3072
|
+
# {
|
3073
|
+
# namespace: "Namespace",
|
3074
|
+
# },
|
3075
|
+
# ],
|
3076
|
+
# firehose_arn: "AmazonResourceName", # required
|
3077
|
+
# role_arn: "AmazonResourceName", # required
|
3078
|
+
# output_format: "json", # required, accepts json, opentelemetry0.7
|
3079
|
+
# tags: [
|
3080
|
+
# {
|
3081
|
+
# key: "TagKey", # required
|
3082
|
+
# value: "TagValue", # required
|
3083
|
+
# },
|
3084
|
+
# ],
|
3085
|
+
# })
|
3086
|
+
#
|
3087
|
+
# @example Response structure
|
3088
|
+
#
|
3089
|
+
# resp.arn #=> String
|
3090
|
+
#
|
3091
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutMetricStream AWS API Documentation
|
3092
|
+
#
|
3093
|
+
# @overload put_metric_stream(params = {})
|
3094
|
+
# @param [Hash] params ({})
|
3095
|
+
def put_metric_stream(params = {}, options = {})
|
3096
|
+
req = build_request(:put_metric_stream, params)
|
3097
|
+
req.send_request(options)
|
3098
|
+
end
|
3099
|
+
|
2815
3100
|
# Temporarily sets the state of an alarm for testing purposes. When the
|
2816
3101
|
# updated state differs from the previous value, the action configured
|
2817
3102
|
# for the appropriate state is invoked. For example, if your alarm is
|
@@ -2876,6 +3161,59 @@ module Aws::CloudWatch
|
|
2876
3161
|
req.send_request(options)
|
2877
3162
|
end
|
2878
3163
|
|
3164
|
+
# Starts the streaming of metrics for one or more of your metric
|
3165
|
+
# streams.
|
3166
|
+
#
|
3167
|
+
# @option params [required, Array<String>] :names
|
3168
|
+
# The array of the names of metric streams to start streaming.
|
3169
|
+
#
|
3170
|
+
# This is an "all or nothing" operation. If you do not have permission
|
3171
|
+
# to access all of the metric streams that you list here, then none of
|
3172
|
+
# the streams that you list in the operation will start streaming.
|
3173
|
+
#
|
3174
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
3175
|
+
#
|
3176
|
+
# @example Request syntax with placeholder values
|
3177
|
+
#
|
3178
|
+
# resp = client.start_metric_streams({
|
3179
|
+
# names: ["MetricStreamName"], # required
|
3180
|
+
# })
|
3181
|
+
#
|
3182
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/StartMetricStreams AWS API Documentation
|
3183
|
+
#
|
3184
|
+
# @overload start_metric_streams(params = {})
|
3185
|
+
# @param [Hash] params ({})
|
3186
|
+
def start_metric_streams(params = {}, options = {})
|
3187
|
+
req = build_request(:start_metric_streams, params)
|
3188
|
+
req.send_request(options)
|
3189
|
+
end
|
3190
|
+
|
3191
|
+
# Stops the streaming of metrics for one or more of your metric streams.
|
3192
|
+
#
|
3193
|
+
# @option params [required, Array<String>] :names
|
3194
|
+
# The array of the names of metric streams to stop streaming.
|
3195
|
+
#
|
3196
|
+
# This is an "all or nothing" operation. If you do not have permission
|
3197
|
+
# to access all of the metric streams that you list here, then none of
|
3198
|
+
# the streams that you list in the operation will stop streaming.
|
3199
|
+
#
|
3200
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
3201
|
+
#
|
3202
|
+
# @example Request syntax with placeholder values
|
3203
|
+
#
|
3204
|
+
# resp = client.stop_metric_streams({
|
3205
|
+
# names: ["MetricStreamName"], # required
|
3206
|
+
# })
|
3207
|
+
#
|
3208
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/StopMetricStreams AWS API Documentation
|
3209
|
+
#
|
3210
|
+
# @overload stop_metric_streams(params = {})
|
3211
|
+
# @param [Hash] params ({})
|
3212
|
+
def stop_metric_streams(params = {}, options = {})
|
3213
|
+
req = build_request(:stop_metric_streams, params)
|
3214
|
+
req.send_request(options)
|
3215
|
+
end
|
3216
|
+
|
2879
3217
|
# Assigns one or more tags (key-value pairs) to the specified CloudWatch
|
2880
3218
|
# resource. Currently, the only CloudWatch resources that can be tagged
|
2881
3219
|
# are alarms and Contributor Insights rules.
|
@@ -2884,8 +3222,8 @@ module Aws::CloudWatch
|
|
2884
3222
|
# use them to scope user permissions by granting a user permission to
|
2885
3223
|
# access or change only resources with certain tag values.
|
2886
3224
|
#
|
2887
|
-
# Tags don't have any semantic meaning to
|
2888
|
-
# strictly as strings of characters.
|
3225
|
+
# Tags don't have any semantic meaning to Amazon Web Services and are
|
3226
|
+
# interpreted strictly as strings of characters.
|
2889
3227
|
#
|
2890
3228
|
# You can use the `TagResource` action with an alarm that already has
|
2891
3229
|
# tags. If you specify a new tag key for the alarm, this tag is appended
|
@@ -2989,7 +3327,7 @@ module Aws::CloudWatch
|
|
2989
3327
|
params: params,
|
2990
3328
|
config: config)
|
2991
3329
|
context[:gem_name] = 'aws-sdk-cloudwatch'
|
2992
|
-
context[:gem_version] = '1.
|
3330
|
+
context[:gem_version] = '1.54.0'
|
2993
3331
|
Seahorse::Client::Request.new(handlers, context)
|
2994
3332
|
end
|
2995
3333
|
|