@aws-sdk/client-cloudwatch 3.67.0 → 3.72.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.
package/CHANGELOG.md CHANGED
@@ -3,6 +3,33 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ # [3.72.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.71.0...v3.72.0) (2022-04-15)
7
+
8
+ **Note:** Version bump only for package @aws-sdk/client-cloudwatch
9
+
10
+
11
+
12
+
13
+
14
+ # [3.71.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.70.0...v3.71.0) (2022-04-14)
15
+
16
+ **Note:** Version bump only for package @aws-sdk/client-cloudwatch
17
+
18
+
19
+
20
+
21
+
22
+ # [3.70.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.69.0...v3.70.0) (2022-04-13)
23
+
24
+
25
+ ### Features
26
+
27
+ * **client-cloudwatch:** Adds support for additional statistics in CloudWatch Metric Streams. ([58e3a94](https://github.com/aws/aws-sdk-js-v3/commit/58e3a94179ee1a06e05138408b64cc96514b0e6e))
28
+
29
+
30
+
31
+
32
+
6
33
  # [3.67.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.66.0...v3.67.0) (2022-04-08)
7
34
 
8
35
  **Note:** Version bump only for package @aws-sdk/client-cloudwatch
@@ -1,8 +1,8 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.DisableAlarmActionsInput = exports.DimensionFilter = exports.DescribeInsightRulesOutput = exports.InsightRule = exports.DescribeInsightRulesInput = exports.DescribeAnomalyDetectorsOutput = exports.DescribeAnomalyDetectorsInput = exports.DescribeAlarmsForMetricOutput = exports.DescribeAlarmsForMetricInput = exports.DescribeAlarmsOutput = exports.MetricAlarm = exports.DescribeAlarmsInput = exports.InvalidNextToken = exports.DescribeAlarmHistoryOutput = exports.DescribeAlarmHistoryInput = exports.ScanBy = exports.DeleteMetricStreamOutput = exports.DeleteMetricStreamInput = exports.DeleteInsightRulesOutput = exports.DeleteInsightRulesInput = exports.DeleteDashboardsOutput = exports.DeleteDashboardsInput = exports.ResourceNotFoundException = exports.MissingRequiredParameterException = exports.InvalidParameterValueException = exports.InvalidParameterCombinationException = exports.InternalServiceFault = exports.DeleteAnomalyDetectorOutput = exports.DeleteAnomalyDetectorInput = exports.ResourceNotFound = exports.DeleteAlarmsInput = exports.Datapoint = exports.DashboardNotFoundError = exports.DashboardInvalidInputError = exports.DashboardValidationMessage = exports.DashboardEntry = exports.ConcurrentModificationException = exports.CompositeAlarm = exports.PartialFailure = exports.AnomalyDetectorType = exports.AnomalyDetector = exports.SingleMetricAnomalyDetector = exports.MetricMathAnomalyDetector = exports.MetricDataQuery = exports.MetricStat = exports.Metric = exports.Dimension = exports.AnomalyDetectorConfiguration = exports.Range = exports.AlarmHistoryItem = void 0;
4
- exports.PutMetricDataInput = exports.MetricDatum = exports.StatisticSet = exports.PutMetricAlarmInput = exports.PutInsightRuleOutput = exports.PutInsightRuleInput = exports.PutDashboardOutput = exports.PutDashboardInput = exports.PutCompositeAlarmInput = exports.LimitExceededFault = exports.PutAnomalyDetectorOutput = exports.PutAnomalyDetectorInput = exports.ListTagsForResourceOutput = exports.Tag = exports.ListTagsForResourceInput = exports.ListMetricStreamsOutput = exports.MetricStreamEntry = exports.ListMetricStreamsInput = exports.ListMetricsOutput = exports.ListMetricsInput = exports.RecentlyActive = exports.ListDashboardsOutput = exports.ListDashboardsInput = exports.GetMetricWidgetImageOutput = exports.GetMetricWidgetImageInput = exports.GetMetricStreamOutput = exports.MetricStreamOutputFormat = exports.MetricStreamFilter = exports.GetMetricStreamInput = exports.GetMetricStatisticsOutput = exports.GetMetricStatisticsInput = exports.GetMetricDataOutput = exports.MetricDataResult = exports.StatusCode = exports.MessageData = exports.GetMetricDataInput = exports.LabelOptions = exports.GetInsightRuleReportOutput = exports.InsightRuleMetricDatapoint = exports.InsightRuleContributor = exports.InsightRuleContributorDatapoint = exports.GetInsightRuleReportInput = exports.GetDashboardOutput = exports.GetDashboardInput = exports.LimitExceededException = exports.EnableInsightRulesOutput = exports.EnableInsightRulesInput = exports.EnableAlarmActionsInput = exports.DisableInsightRulesOutput = exports.DisableInsightRulesInput = void 0;
5
- exports.UntagResourceOutput = exports.UntagResourceInput = exports.TagResourceOutput = exports.TagResourceInput = exports.StopMetricStreamsOutput = exports.StopMetricStreamsInput = exports.StartMetricStreamsOutput = exports.StartMetricStreamsInput = exports.SetAlarmStateInput = exports.InvalidFormatFault = exports.PutMetricStreamOutput = exports.PutMetricStreamInput = void 0;
4
+ exports.StatisticSet = exports.PutMetricAlarmInput = exports.PutInsightRuleOutput = exports.PutInsightRuleInput = exports.PutDashboardOutput = exports.PutDashboardInput = exports.PutCompositeAlarmInput = exports.LimitExceededFault = exports.PutAnomalyDetectorOutput = exports.PutAnomalyDetectorInput = exports.ListTagsForResourceOutput = exports.Tag = exports.ListTagsForResourceInput = exports.ListMetricStreamsOutput = exports.MetricStreamEntry = exports.ListMetricStreamsInput = exports.ListMetricsOutput = exports.ListMetricsInput = exports.RecentlyActive = exports.ListDashboardsOutput = exports.ListDashboardsInput = exports.GetMetricWidgetImageOutput = exports.GetMetricWidgetImageInput = exports.GetMetricStreamOutput = exports.MetricStreamStatisticsConfiguration = exports.MetricStreamStatisticsMetric = exports.MetricStreamOutputFormat = exports.MetricStreamFilter = exports.GetMetricStreamInput = exports.GetMetricStatisticsOutput = exports.GetMetricStatisticsInput = exports.GetMetricDataOutput = exports.MetricDataResult = exports.StatusCode = exports.MessageData = exports.GetMetricDataInput = exports.LabelOptions = exports.GetInsightRuleReportOutput = exports.InsightRuleMetricDatapoint = exports.InsightRuleContributor = exports.InsightRuleContributorDatapoint = exports.GetInsightRuleReportInput = exports.GetDashboardOutput = exports.GetDashboardInput = exports.LimitExceededException = exports.EnableInsightRulesOutput = exports.EnableInsightRulesInput = exports.EnableAlarmActionsInput = exports.DisableInsightRulesOutput = exports.DisableInsightRulesInput = void 0;
5
+ exports.UntagResourceOutput = exports.UntagResourceInput = exports.TagResourceOutput = exports.TagResourceInput = exports.StopMetricStreamsOutput = exports.StopMetricStreamsInput = exports.StartMetricStreamsOutput = exports.StartMetricStreamsInput = exports.SetAlarmStateInput = exports.InvalidFormatFault = exports.PutMetricStreamOutput = exports.PutMetricStreamInput = exports.PutMetricDataInput = exports.MetricDatum = void 0;
6
6
  const CloudWatchServiceException_1 = require("./CloudWatchServiceException");
7
7
  var AlarmHistoryItem;
8
8
  (function (AlarmHistoryItem) {
@@ -529,6 +529,18 @@ var MetricStreamOutputFormat;
529
529
  MetricStreamOutputFormat["JSON"] = "json";
530
530
  MetricStreamOutputFormat["OPEN_TELEMETRY_0_7"] = "opentelemetry0.7";
531
531
  })(MetricStreamOutputFormat = exports.MetricStreamOutputFormat || (exports.MetricStreamOutputFormat = {}));
532
+ var MetricStreamStatisticsMetric;
533
+ (function (MetricStreamStatisticsMetric) {
534
+ MetricStreamStatisticsMetric.filterSensitiveLog = (obj) => ({
535
+ ...obj,
536
+ });
537
+ })(MetricStreamStatisticsMetric = exports.MetricStreamStatisticsMetric || (exports.MetricStreamStatisticsMetric = {}));
538
+ var MetricStreamStatisticsConfiguration;
539
+ (function (MetricStreamStatisticsConfiguration) {
540
+ MetricStreamStatisticsConfiguration.filterSensitiveLog = (obj) => ({
541
+ ...obj,
542
+ });
543
+ })(MetricStreamStatisticsConfiguration = exports.MetricStreamStatisticsConfiguration || (exports.MetricStreamStatisticsConfiguration = {}));
532
544
  var GetMetricStreamOutput;
533
545
  (function (GetMetricStreamOutput) {
534
546
  GetMetricStreamOutput.filterSensitiveLog = (obj) => ({
@@ -2837,6 +2837,76 @@ const serializeAws_queryMetricStreamNames = (input, context) => {
2837
2837
  }
2838
2838
  return entries;
2839
2839
  };
2840
+ const serializeAws_queryMetricStreamStatisticsAdditionalStatistics = (input, context) => {
2841
+ const entries = {};
2842
+ let counter = 1;
2843
+ for (const entry of input) {
2844
+ if (entry === null) {
2845
+ continue;
2846
+ }
2847
+ entries[`member.${counter}`] = entry;
2848
+ counter++;
2849
+ }
2850
+ return entries;
2851
+ };
2852
+ const serializeAws_queryMetricStreamStatisticsConfiguration = (input, context) => {
2853
+ const entries = {};
2854
+ if (input.IncludeMetrics !== undefined && input.IncludeMetrics !== null) {
2855
+ const memberEntries = serializeAws_queryMetricStreamStatisticsIncludeMetrics(input.IncludeMetrics, context);
2856
+ Object.entries(memberEntries).forEach(([key, value]) => {
2857
+ const loc = `IncludeMetrics.${key}`;
2858
+ entries[loc] = value;
2859
+ });
2860
+ }
2861
+ if (input.AdditionalStatistics !== undefined && input.AdditionalStatistics !== null) {
2862
+ const memberEntries = serializeAws_queryMetricStreamStatisticsAdditionalStatistics(input.AdditionalStatistics, context);
2863
+ Object.entries(memberEntries).forEach(([key, value]) => {
2864
+ const loc = `AdditionalStatistics.${key}`;
2865
+ entries[loc] = value;
2866
+ });
2867
+ }
2868
+ return entries;
2869
+ };
2870
+ const serializeAws_queryMetricStreamStatisticsConfigurations = (input, context) => {
2871
+ const entries = {};
2872
+ let counter = 1;
2873
+ for (const entry of input) {
2874
+ if (entry === null) {
2875
+ continue;
2876
+ }
2877
+ const memberEntries = serializeAws_queryMetricStreamStatisticsConfiguration(entry, context);
2878
+ Object.entries(memberEntries).forEach(([key, value]) => {
2879
+ entries[`member.${counter}.${key}`] = value;
2880
+ });
2881
+ counter++;
2882
+ }
2883
+ return entries;
2884
+ };
2885
+ const serializeAws_queryMetricStreamStatisticsIncludeMetrics = (input, context) => {
2886
+ const entries = {};
2887
+ let counter = 1;
2888
+ for (const entry of input) {
2889
+ if (entry === null) {
2890
+ continue;
2891
+ }
2892
+ const memberEntries = serializeAws_queryMetricStreamStatisticsMetric(entry, context);
2893
+ Object.entries(memberEntries).forEach(([key, value]) => {
2894
+ entries[`member.${counter}.${key}`] = value;
2895
+ });
2896
+ counter++;
2897
+ }
2898
+ return entries;
2899
+ };
2900
+ const serializeAws_queryMetricStreamStatisticsMetric = (input, context) => {
2901
+ const entries = {};
2902
+ if (input.Namespace !== undefined && input.Namespace !== null) {
2903
+ entries["Namespace"] = input.Namespace;
2904
+ }
2905
+ if (input.MetricName !== undefined && input.MetricName !== null) {
2906
+ entries["MetricName"] = input.MetricName;
2907
+ }
2908
+ return entries;
2909
+ };
2840
2910
  const serializeAws_queryPutAnomalyDetectorInput = (input, context) => {
2841
2911
  const entries = {};
2842
2912
  if (input.Namespace !== undefined && input.Namespace !== null) {
@@ -3095,6 +3165,13 @@ const serializeAws_queryPutMetricStreamInput = (input, context) => {
3095
3165
  entries[loc] = value;
3096
3166
  });
3097
3167
  }
3168
+ if (input.StatisticsConfigurations !== undefined && input.StatisticsConfigurations !== null) {
3169
+ const memberEntries = serializeAws_queryMetricStreamStatisticsConfigurations(input.StatisticsConfigurations, context);
3170
+ Object.entries(memberEntries).forEach(([key, value]) => {
3171
+ const loc = `StatisticsConfigurations.${key}`;
3172
+ entries[loc] = value;
3173
+ });
3174
+ }
3098
3175
  return entries;
3099
3176
  };
3100
3177
  const serializeAws_queryRange = (input, context) => {
@@ -3903,6 +3980,7 @@ const deserializeAws_queryGetMetricStreamOutput = (output, context) => {
3903
3980
  CreationDate: undefined,
3904
3981
  LastUpdateDate: undefined,
3905
3982
  OutputFormat: undefined,
3983
+ StatisticsConfigurations: undefined,
3906
3984
  };
3907
3985
  if (output["Arn"] !== undefined) {
3908
3986
  contents.Arn = (0, smithy_client_1.expectString)(output["Arn"]);
@@ -3940,6 +4018,12 @@ const deserializeAws_queryGetMetricStreamOutput = (output, context) => {
3940
4018
  if (output["OutputFormat"] !== undefined) {
3941
4019
  contents.OutputFormat = (0, smithy_client_1.expectString)(output["OutputFormat"]);
3942
4020
  }
4021
+ if (output.StatisticsConfigurations === "") {
4022
+ contents.StatisticsConfigurations = [];
4023
+ }
4024
+ if (output["StatisticsConfigurations"] !== undefined && output["StatisticsConfigurations"]["member"] !== undefined) {
4025
+ contents.StatisticsConfigurations = deserializeAws_queryMetricStreamStatisticsConfigurations((0, smithy_client_1.getArrayIfSingleItem)(output["StatisticsConfigurations"]["member"]), context);
4026
+ }
3943
4027
  return contents;
3944
4028
  };
3945
4029
  const deserializeAws_queryGetMetricWidgetImageOutput = (output, context) => {
@@ -4605,6 +4689,68 @@ const deserializeAws_queryMetricStreamFilters = (output, context) => {
4605
4689
  return deserializeAws_queryMetricStreamFilter(entry, context);
4606
4690
  });
4607
4691
  };
4692
+ const deserializeAws_queryMetricStreamStatisticsAdditionalStatistics = (output, context) => {
4693
+ return (output || [])
4694
+ .filter((e) => e != null)
4695
+ .map((entry) => {
4696
+ if (entry === null) {
4697
+ return null;
4698
+ }
4699
+ return (0, smithy_client_1.expectString)(entry);
4700
+ });
4701
+ };
4702
+ const deserializeAws_queryMetricStreamStatisticsConfiguration = (output, context) => {
4703
+ const contents = {
4704
+ IncludeMetrics: undefined,
4705
+ AdditionalStatistics: undefined,
4706
+ };
4707
+ if (output.IncludeMetrics === "") {
4708
+ contents.IncludeMetrics = [];
4709
+ }
4710
+ if (output["IncludeMetrics"] !== undefined && output["IncludeMetrics"]["member"] !== undefined) {
4711
+ contents.IncludeMetrics = deserializeAws_queryMetricStreamStatisticsIncludeMetrics((0, smithy_client_1.getArrayIfSingleItem)(output["IncludeMetrics"]["member"]), context);
4712
+ }
4713
+ if (output.AdditionalStatistics === "") {
4714
+ contents.AdditionalStatistics = [];
4715
+ }
4716
+ if (output["AdditionalStatistics"] !== undefined && output["AdditionalStatistics"]["member"] !== undefined) {
4717
+ contents.AdditionalStatistics = deserializeAws_queryMetricStreamStatisticsAdditionalStatistics((0, smithy_client_1.getArrayIfSingleItem)(output["AdditionalStatistics"]["member"]), context);
4718
+ }
4719
+ return contents;
4720
+ };
4721
+ const deserializeAws_queryMetricStreamStatisticsConfigurations = (output, context) => {
4722
+ return (output || [])
4723
+ .filter((e) => e != null)
4724
+ .map((entry) => {
4725
+ if (entry === null) {
4726
+ return null;
4727
+ }
4728
+ return deserializeAws_queryMetricStreamStatisticsConfiguration(entry, context);
4729
+ });
4730
+ };
4731
+ const deserializeAws_queryMetricStreamStatisticsIncludeMetrics = (output, context) => {
4732
+ return (output || [])
4733
+ .filter((e) => e != null)
4734
+ .map((entry) => {
4735
+ if (entry === null) {
4736
+ return null;
4737
+ }
4738
+ return deserializeAws_queryMetricStreamStatisticsMetric(entry, context);
4739
+ });
4740
+ };
4741
+ const deserializeAws_queryMetricStreamStatisticsMetric = (output, context) => {
4742
+ const contents = {
4743
+ Namespace: undefined,
4744
+ MetricName: undefined,
4745
+ };
4746
+ if (output["Namespace"] !== undefined) {
4747
+ contents.Namespace = (0, smithy_client_1.expectString)(output["Namespace"]);
4748
+ }
4749
+ if (output["MetricName"] !== undefined) {
4750
+ contents.MetricName = (0, smithy_client_1.expectString)(output["MetricName"]);
4751
+ }
4752
+ return contents;
4753
+ };
4608
4754
  const deserializeAws_queryMissingRequiredParameterException = (output, context) => {
4609
4755
  const contents = {
4610
4756
  message: undefined,
@@ -396,6 +396,14 @@ export var MetricStreamOutputFormat;
396
396
  MetricStreamOutputFormat["JSON"] = "json";
397
397
  MetricStreamOutputFormat["OPEN_TELEMETRY_0_7"] = "opentelemetry0.7";
398
398
  })(MetricStreamOutputFormat || (MetricStreamOutputFormat = {}));
399
+ export var MetricStreamStatisticsMetric;
400
+ (function (MetricStreamStatisticsMetric) {
401
+ MetricStreamStatisticsMetric.filterSensitiveLog = function (obj) { return (__assign({}, obj)); };
402
+ })(MetricStreamStatisticsMetric || (MetricStreamStatisticsMetric = {}));
403
+ export var MetricStreamStatisticsConfiguration;
404
+ (function (MetricStreamStatisticsConfiguration) {
405
+ MetricStreamStatisticsConfiguration.filterSensitiveLog = function (obj) { return (__assign({}, obj)); };
406
+ })(MetricStreamStatisticsConfiguration || (MetricStreamStatisticsConfiguration = {}));
399
407
  export var GetMetricStreamOutput;
400
408
  (function (GetMetricStreamOutput) {
401
409
  GetMetricStreamOutput.filterSensitiveLog = function (obj) { return (__assign({}, obj)); };
@@ -3504,6 +3504,113 @@ var serializeAws_queryMetricStreamNames = function (input, context) {
3504
3504
  }
3505
3505
  return entries;
3506
3506
  };
3507
+ var serializeAws_queryMetricStreamStatisticsAdditionalStatistics = function (input, context) {
3508
+ var e_16, _a;
3509
+ var entries = {};
3510
+ var counter = 1;
3511
+ try {
3512
+ for (var input_16 = __values(input), input_16_1 = input_16.next(); !input_16_1.done; input_16_1 = input_16.next()) {
3513
+ var entry = input_16_1.value;
3514
+ if (entry === null) {
3515
+ continue;
3516
+ }
3517
+ entries["member.".concat(counter)] = entry;
3518
+ counter++;
3519
+ }
3520
+ }
3521
+ catch (e_16_1) { e_16 = { error: e_16_1 }; }
3522
+ finally {
3523
+ try {
3524
+ if (input_16_1 && !input_16_1.done && (_a = input_16.return)) _a.call(input_16);
3525
+ }
3526
+ finally { if (e_16) throw e_16.error; }
3527
+ }
3528
+ return entries;
3529
+ };
3530
+ var serializeAws_queryMetricStreamStatisticsConfiguration = function (input, context) {
3531
+ var entries = {};
3532
+ if (input.IncludeMetrics !== undefined && input.IncludeMetrics !== null) {
3533
+ var memberEntries = serializeAws_queryMetricStreamStatisticsIncludeMetrics(input.IncludeMetrics, context);
3534
+ Object.entries(memberEntries).forEach(function (_a) {
3535
+ var _b = __read(_a, 2), key = _b[0], value = _b[1];
3536
+ var loc = "IncludeMetrics.".concat(key);
3537
+ entries[loc] = value;
3538
+ });
3539
+ }
3540
+ if (input.AdditionalStatistics !== undefined && input.AdditionalStatistics !== null) {
3541
+ var memberEntries = serializeAws_queryMetricStreamStatisticsAdditionalStatistics(input.AdditionalStatistics, context);
3542
+ Object.entries(memberEntries).forEach(function (_a) {
3543
+ var _b = __read(_a, 2), key = _b[0], value = _b[1];
3544
+ var loc = "AdditionalStatistics.".concat(key);
3545
+ entries[loc] = value;
3546
+ });
3547
+ }
3548
+ return entries;
3549
+ };
3550
+ var serializeAws_queryMetricStreamStatisticsConfigurations = function (input, context) {
3551
+ var e_17, _a;
3552
+ var entries = {};
3553
+ var counter = 1;
3554
+ try {
3555
+ for (var input_17 = __values(input), input_17_1 = input_17.next(); !input_17_1.done; input_17_1 = input_17.next()) {
3556
+ var entry = input_17_1.value;
3557
+ if (entry === null) {
3558
+ continue;
3559
+ }
3560
+ var memberEntries = serializeAws_queryMetricStreamStatisticsConfiguration(entry, context);
3561
+ Object.entries(memberEntries).forEach(function (_a) {
3562
+ var _b = __read(_a, 2), key = _b[0], value = _b[1];
3563
+ entries["member.".concat(counter, ".").concat(key)] = value;
3564
+ });
3565
+ counter++;
3566
+ }
3567
+ }
3568
+ catch (e_17_1) { e_17 = { error: e_17_1 }; }
3569
+ finally {
3570
+ try {
3571
+ if (input_17_1 && !input_17_1.done && (_a = input_17.return)) _a.call(input_17);
3572
+ }
3573
+ finally { if (e_17) throw e_17.error; }
3574
+ }
3575
+ return entries;
3576
+ };
3577
+ var serializeAws_queryMetricStreamStatisticsIncludeMetrics = function (input, context) {
3578
+ var e_18, _a;
3579
+ var entries = {};
3580
+ var counter = 1;
3581
+ try {
3582
+ for (var input_18 = __values(input), input_18_1 = input_18.next(); !input_18_1.done; input_18_1 = input_18.next()) {
3583
+ var entry = input_18_1.value;
3584
+ if (entry === null) {
3585
+ continue;
3586
+ }
3587
+ var memberEntries = serializeAws_queryMetricStreamStatisticsMetric(entry, context);
3588
+ Object.entries(memberEntries).forEach(function (_a) {
3589
+ var _b = __read(_a, 2), key = _b[0], value = _b[1];
3590
+ entries["member.".concat(counter, ".").concat(key)] = value;
3591
+ });
3592
+ counter++;
3593
+ }
3594
+ }
3595
+ catch (e_18_1) { e_18 = { error: e_18_1 }; }
3596
+ finally {
3597
+ try {
3598
+ if (input_18_1 && !input_18_1.done && (_a = input_18.return)) _a.call(input_18);
3599
+ }
3600
+ finally { if (e_18) throw e_18.error; }
3601
+ }
3602
+ return entries;
3603
+ };
3604
+ var serializeAws_queryMetricStreamStatisticsMetric = function (input, context) {
3605
+ var entries = {};
3606
+ if (input.Namespace !== undefined && input.Namespace !== null) {
3607
+ entries["Namespace"] = input.Namespace;
3608
+ }
3609
+ if (input.MetricName !== undefined && input.MetricName !== null) {
3610
+ entries["MetricName"] = input.MetricName;
3611
+ }
3612
+ return entries;
3613
+ };
3507
3614
  var serializeAws_queryPutAnomalyDetectorInput = function (input, context) {
3508
3615
  var entries = {};
3509
3616
  if (input.Namespace !== undefined && input.Namespace !== null) {
@@ -3781,6 +3888,14 @@ var serializeAws_queryPutMetricStreamInput = function (input, context) {
3781
3888
  entries[loc] = value;
3782
3889
  });
3783
3890
  }
3891
+ if (input.StatisticsConfigurations !== undefined && input.StatisticsConfigurations !== null) {
3892
+ var memberEntries = serializeAws_queryMetricStreamStatisticsConfigurations(input.StatisticsConfigurations, context);
3893
+ Object.entries(memberEntries).forEach(function (_a) {
3894
+ var _b = __read(_a, 2), key = _b[0], value = _b[1];
3895
+ var loc = "StatisticsConfigurations.".concat(key);
3896
+ entries[loc] = value;
3897
+ });
3898
+ }
3784
3899
  return entries;
3785
3900
  };
3786
3901
  var serializeAws_queryRange = function (input, context) {
@@ -3794,12 +3909,12 @@ var serializeAws_queryRange = function (input, context) {
3794
3909
  return entries;
3795
3910
  };
3796
3911
  var serializeAws_queryResourceList = function (input, context) {
3797
- var e_16, _a;
3912
+ var e_19, _a;
3798
3913
  var entries = {};
3799
3914
  var counter = 1;
3800
3915
  try {
3801
- for (var input_16 = __values(input), input_16_1 = input_16.next(); !input_16_1.done; input_16_1 = input_16.next()) {
3802
- var entry = input_16_1.value;
3916
+ for (var input_19 = __values(input), input_19_1 = input_19.next(); !input_19_1.done; input_19_1 = input_19.next()) {
3917
+ var entry = input_19_1.value;
3803
3918
  if (entry === null) {
3804
3919
  continue;
3805
3920
  }
@@ -3807,12 +3922,12 @@ var serializeAws_queryResourceList = function (input, context) {
3807
3922
  counter++;
3808
3923
  }
3809
3924
  }
3810
- catch (e_16_1) { e_16 = { error: e_16_1 }; }
3925
+ catch (e_19_1) { e_19 = { error: e_19_1 }; }
3811
3926
  finally {
3812
3927
  try {
3813
- if (input_16_1 && !input_16_1.done && (_a = input_16.return)) _a.call(input_16);
3928
+ if (input_19_1 && !input_19_1.done && (_a = input_19.return)) _a.call(input_19);
3814
3929
  }
3815
- finally { if (e_16) throw e_16.error; }
3930
+ finally { if (e_19) throw e_19.error; }
3816
3931
  }
3817
3932
  return entries;
3818
3933
  };
@@ -3866,12 +3981,12 @@ var serializeAws_queryStartMetricStreamsInput = function (input, context) {
3866
3981
  return entries;
3867
3982
  };
3868
3983
  var serializeAws_queryStatistics = function (input, context) {
3869
- var e_17, _a;
3984
+ var e_20, _a;
3870
3985
  var entries = {};
3871
3986
  var counter = 1;
3872
3987
  try {
3873
- for (var input_17 = __values(input), input_17_1 = input_17.next(); !input_17_1.done; input_17_1 = input_17.next()) {
3874
- var entry = input_17_1.value;
3988
+ for (var input_20 = __values(input), input_20_1 = input_20.next(); !input_20_1.done; input_20_1 = input_20.next()) {
3989
+ var entry = input_20_1.value;
3875
3990
  if (entry === null) {
3876
3991
  continue;
3877
3992
  }
@@ -3879,12 +3994,12 @@ var serializeAws_queryStatistics = function (input, context) {
3879
3994
  counter++;
3880
3995
  }
3881
3996
  }
3882
- catch (e_17_1) { e_17 = { error: e_17_1 }; }
3997
+ catch (e_20_1) { e_20 = { error: e_20_1 }; }
3883
3998
  finally {
3884
3999
  try {
3885
- if (input_17_1 && !input_17_1.done && (_a = input_17.return)) _a.call(input_17);
4000
+ if (input_20_1 && !input_20_1.done && (_a = input_20.return)) _a.call(input_20);
3886
4001
  }
3887
- finally { if (e_17) throw e_17.error; }
4002
+ finally { if (e_20) throw e_20.error; }
3888
4003
  }
3889
4004
  return entries;
3890
4005
  };
@@ -3927,12 +4042,12 @@ var serializeAws_queryTag = function (input, context) {
3927
4042
  return entries;
3928
4043
  };
3929
4044
  var serializeAws_queryTagKeyList = function (input, context) {
3930
- var e_18, _a;
4045
+ var e_21, _a;
3931
4046
  var entries = {};
3932
4047
  var counter = 1;
3933
4048
  try {
3934
- for (var input_18 = __values(input), input_18_1 = input_18.next(); !input_18_1.done; input_18_1 = input_18.next()) {
3935
- var entry = input_18_1.value;
4049
+ for (var input_21 = __values(input), input_21_1 = input_21.next(); !input_21_1.done; input_21_1 = input_21.next()) {
4050
+ var entry = input_21_1.value;
3936
4051
  if (entry === null) {
3937
4052
  continue;
3938
4053
  }
@@ -3940,22 +4055,22 @@ var serializeAws_queryTagKeyList = function (input, context) {
3940
4055
  counter++;
3941
4056
  }
3942
4057
  }
3943
- catch (e_18_1) { e_18 = { error: e_18_1 }; }
4058
+ catch (e_21_1) { e_21 = { error: e_21_1 }; }
3944
4059
  finally {
3945
4060
  try {
3946
- if (input_18_1 && !input_18_1.done && (_a = input_18.return)) _a.call(input_18);
4061
+ if (input_21_1 && !input_21_1.done && (_a = input_21.return)) _a.call(input_21);
3947
4062
  }
3948
- finally { if (e_18) throw e_18.error; }
4063
+ finally { if (e_21) throw e_21.error; }
3949
4064
  }
3950
4065
  return entries;
3951
4066
  };
3952
4067
  var serializeAws_queryTagList = function (input, context) {
3953
- var e_19, _a;
4068
+ var e_22, _a;
3954
4069
  var entries = {};
3955
4070
  var counter = 1;
3956
4071
  try {
3957
- for (var input_19 = __values(input), input_19_1 = input_19.next(); !input_19_1.done; input_19_1 = input_19.next()) {
3958
- var entry = input_19_1.value;
4072
+ for (var input_22 = __values(input), input_22_1 = input_22.next(); !input_22_1.done; input_22_1 = input_22.next()) {
4073
+ var entry = input_22_1.value;
3959
4074
  if (entry === null) {
3960
4075
  continue;
3961
4076
  }
@@ -3967,12 +4082,12 @@ var serializeAws_queryTagList = function (input, context) {
3967
4082
  counter++;
3968
4083
  }
3969
4084
  }
3970
- catch (e_19_1) { e_19 = { error: e_19_1 }; }
4085
+ catch (e_22_1) { e_22 = { error: e_22_1 }; }
3971
4086
  finally {
3972
4087
  try {
3973
- if (input_19_1 && !input_19_1.done && (_a = input_19.return)) _a.call(input_19);
4088
+ if (input_22_1 && !input_22_1.done && (_a = input_22.return)) _a.call(input_22);
3974
4089
  }
3975
- finally { if (e_19) throw e_19.error; }
4090
+ finally { if (e_22) throw e_22.error; }
3976
4091
  }
3977
4092
  return entries;
3978
4093
  };
@@ -4007,12 +4122,12 @@ var serializeAws_queryUntagResourceInput = function (input, context) {
4007
4122
  return entries;
4008
4123
  };
4009
4124
  var serializeAws_queryValues = function (input, context) {
4010
- var e_20, _a;
4125
+ var e_23, _a;
4011
4126
  var entries = {};
4012
4127
  var counter = 1;
4013
4128
  try {
4014
- for (var input_20 = __values(input), input_20_1 = input_20.next(); !input_20_1.done; input_20_1 = input_20.next()) {
4015
- var entry = input_20_1.value;
4129
+ for (var input_23 = __values(input), input_23_1 = input_23.next(); !input_23_1.done; input_23_1 = input_23.next()) {
4130
+ var entry = input_23_1.value;
4016
4131
  if (entry === null) {
4017
4132
  continue;
4018
4133
  }
@@ -4020,12 +4135,12 @@ var serializeAws_queryValues = function (input, context) {
4020
4135
  counter++;
4021
4136
  }
4022
4137
  }
4023
- catch (e_20_1) { e_20 = { error: e_20_1 }; }
4138
+ catch (e_23_1) { e_23 = { error: e_23_1 }; }
4024
4139
  finally {
4025
4140
  try {
4026
- if (input_20_1 && !input_20_1.done && (_a = input_20.return)) _a.call(input_20);
4141
+ if (input_23_1 && !input_23_1.done && (_a = input_23.return)) _a.call(input_23);
4027
4142
  }
4028
- finally { if (e_20) throw e_20.error; }
4143
+ finally { if (e_23) throw e_23.error; }
4029
4144
  }
4030
4145
  return entries;
4031
4146
  };
@@ -4648,6 +4763,7 @@ var deserializeAws_queryGetMetricStreamOutput = function (output, context) {
4648
4763
  CreationDate: undefined,
4649
4764
  LastUpdateDate: undefined,
4650
4765
  OutputFormat: undefined,
4766
+ StatisticsConfigurations: undefined,
4651
4767
  };
4652
4768
  if (output["Arn"] !== undefined) {
4653
4769
  contents.Arn = __expectString(output["Arn"]);
@@ -4685,6 +4801,12 @@ var deserializeAws_queryGetMetricStreamOutput = function (output, context) {
4685
4801
  if (output["OutputFormat"] !== undefined) {
4686
4802
  contents.OutputFormat = __expectString(output["OutputFormat"]);
4687
4803
  }
4804
+ if (output.StatisticsConfigurations === "") {
4805
+ contents.StatisticsConfigurations = [];
4806
+ }
4807
+ if (output["StatisticsConfigurations"] !== undefined && output["StatisticsConfigurations"]["member"] !== undefined) {
4808
+ contents.StatisticsConfigurations = deserializeAws_queryMetricStreamStatisticsConfigurations(__getArrayIfSingleItem(output["StatisticsConfigurations"]["member"]), context);
4809
+ }
4688
4810
  return contents;
4689
4811
  };
4690
4812
  var deserializeAws_queryGetMetricWidgetImageOutput = function (output, context) {
@@ -5350,6 +5472,68 @@ var deserializeAws_queryMetricStreamFilters = function (output, context) {
5350
5472
  return deserializeAws_queryMetricStreamFilter(entry, context);
5351
5473
  });
5352
5474
  };
5475
+ var deserializeAws_queryMetricStreamStatisticsAdditionalStatistics = function (output, context) {
5476
+ return (output || [])
5477
+ .filter(function (e) { return e != null; })
5478
+ .map(function (entry) {
5479
+ if (entry === null) {
5480
+ return null;
5481
+ }
5482
+ return __expectString(entry);
5483
+ });
5484
+ };
5485
+ var deserializeAws_queryMetricStreamStatisticsConfiguration = function (output, context) {
5486
+ var contents = {
5487
+ IncludeMetrics: undefined,
5488
+ AdditionalStatistics: undefined,
5489
+ };
5490
+ if (output.IncludeMetrics === "") {
5491
+ contents.IncludeMetrics = [];
5492
+ }
5493
+ if (output["IncludeMetrics"] !== undefined && output["IncludeMetrics"]["member"] !== undefined) {
5494
+ contents.IncludeMetrics = deserializeAws_queryMetricStreamStatisticsIncludeMetrics(__getArrayIfSingleItem(output["IncludeMetrics"]["member"]), context);
5495
+ }
5496
+ if (output.AdditionalStatistics === "") {
5497
+ contents.AdditionalStatistics = [];
5498
+ }
5499
+ if (output["AdditionalStatistics"] !== undefined && output["AdditionalStatistics"]["member"] !== undefined) {
5500
+ contents.AdditionalStatistics = deserializeAws_queryMetricStreamStatisticsAdditionalStatistics(__getArrayIfSingleItem(output["AdditionalStatistics"]["member"]), context);
5501
+ }
5502
+ return contents;
5503
+ };
5504
+ var deserializeAws_queryMetricStreamStatisticsConfigurations = function (output, context) {
5505
+ return (output || [])
5506
+ .filter(function (e) { return e != null; })
5507
+ .map(function (entry) {
5508
+ if (entry === null) {
5509
+ return null;
5510
+ }
5511
+ return deserializeAws_queryMetricStreamStatisticsConfiguration(entry, context);
5512
+ });
5513
+ };
5514
+ var deserializeAws_queryMetricStreamStatisticsIncludeMetrics = function (output, context) {
5515
+ return (output || [])
5516
+ .filter(function (e) { return e != null; })
5517
+ .map(function (entry) {
5518
+ if (entry === null) {
5519
+ return null;
5520
+ }
5521
+ return deserializeAws_queryMetricStreamStatisticsMetric(entry, context);
5522
+ });
5523
+ };
5524
+ var deserializeAws_queryMetricStreamStatisticsMetric = function (output, context) {
5525
+ var contents = {
5526
+ Namespace: undefined,
5527
+ MetricName: undefined,
5528
+ };
5529
+ if (output["Namespace"] !== undefined) {
5530
+ contents.Namespace = __expectString(output["Namespace"]);
5531
+ }
5532
+ if (output["MetricName"] !== undefined) {
5533
+ contents.MetricName = __expectString(output["MetricName"]);
5534
+ }
5535
+ return contents;
5536
+ };
5353
5537
  var deserializeAws_queryMissingRequiredParameterException = function (output, context) {
5354
5538
  var contents = {
5355
5539
  message: undefined,
@@ -234,13 +234,21 @@ export declare class CloudWatch extends CloudWatchClient {
234
234
  getInsightRuleReport(args: GetInsightRuleReportCommandInput, cb: (err: any, data?: GetInsightRuleReportCommandOutput) => void): void;
235
235
  getInsightRuleReport(args: GetInsightRuleReportCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetInsightRuleReportCommandOutput) => void): void;
236
236
  /**
237
- * <p>You can use the <code>GetMetricData</code> API to retrieve as many as 500 different
237
+ * <p>You can use the <code>GetMetricData</code> API to retrieve CloudWatch metric values. The operation
238
+ * can also include a CloudWatch Metrics Insights query, and one or more metric math functions.</p>
239
+ * <p>A <code>GetMetricData</code> operation that does not include a query can retrieve as many as 500 different
238
240
  * metrics in a single request, with a total of as many as 100,800 data points. You can also
239
- * optionally perform math expressions on the values of the returned statistics, to create
241
+ * optionally perform metric math expressions on the values of the returned statistics, to create
240
242
  * new time series that represent new insights into your data. For example, using Lambda
241
243
  * metrics, you could divide the Errors metric by the Invocations metric to get an error
242
244
  * rate time series. For more information about metric math expressions, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html#metric-math-syntax">Metric Math Syntax and Functions</a> in the <i>Amazon CloudWatch User
243
- * Guide</i>.</p>
245
+ * Guide</i>.</p>
246
+ *
247
+ *
248
+ * <p>If you include a Metrics Insights query, each <code>GetMetricData</code> operation can include only one
249
+ * query. But the same <code>GetMetricData</code> operation can also retrieve other metrics. Metrics Insights queries
250
+ * can query only the most recent three hours of metric data. For more information about Metrics Insights,
251
+ * see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/query_with_cloudwatch-metrics-insights.html">Query your metrics with CloudWatch Metrics Insights</a>.</p>
244
252
  *
245
253
  * <p>Calls to the <code>GetMetricData</code> API have a different pricing structure than
246
254
  * calls to <code>GetMetricStatistics</code>. For more information about pricing, see
@@ -270,6 +278,16 @@ export declare class CloudWatch extends CloudWatchClient {
270
278
  * <p>If you omit <code>Unit</code> in your request, all data that was collected with any unit is returned, along with the corresponding units that were specified
271
279
  * when the data was reported to CloudWatch. If you specify a unit, the operation returns only data that was collected with that unit specified.
272
280
  * If you specify a unit that does not match the data collected, the results of the operation are null. CloudWatch does not perform unit conversions.</p>
281
+ *
282
+ * <p>
283
+ * <b>Using Metrics Insights queries with metric math</b>
284
+ * </p>
285
+ * <p>You can't mix a Metric Insights query and metric math syntax in the same expression, but
286
+ * you can reference results from a Metrics Insights query within other Metric math expressions. A Metrics Insights
287
+ * query without a <b>GROUP BY</b> clause returns a single time-series (TS),
288
+ * and can be used as input for a metric math expression that expects a single time series. A Metrics Insights
289
+ * query with a <b>GROUP BY</b> clause returns an array of time-series (TS[]),
290
+ * and can be used as input for a metric math expression that expects an array of time series. </p>
273
291
  */
274
292
  getMetricData(args: GetMetricDataCommandInput, options?: __HttpHandlerOptions): Promise<GetMetricDataCommandOutput>;
275
293
  getMetricData(args: GetMetricDataCommandInput, cb: (err: any, data?: GetMetricDataCommandOutput) => void): void;
@@ -420,7 +438,8 @@ export declare class CloudWatch extends CloudWatchClient {
420
438
  * states of other alarms that you have created. The composite alarm goes into ALARM state
421
439
  * only if all conditions of the rule are met.</p>
422
440
  * <p>The alarms specified in a composite alarm's rule expression can include metric alarms
423
- * and other composite alarms.</p>
441
+ * and other composite alarms. The rule expression of a composite alarm can include as many as 100 underlying alarms.
442
+ * Any single alarm can be included in the rule expressions of as many as 150 composite alarms.</p>
424
443
  * <p>Using composite alarms can reduce
425
444
  * alarm noise. You can create multiple metric alarms,
426
445
  * and also create a composite alarm and
@@ -633,6 +652,12 @@ export declare class CloudWatch extends CloudWatchClient {
633
652
  * </li>
634
653
  * </ul>
635
654
  *
655
+ * <p>By default, a metric stream always sends the <code>MAX</code>, <code>MIN</code>, <code>SUM</code>,
656
+ * and <code>SAMPLECOUNT</code> statistics for each metric that is streamed. You can use the
657
+ * <code>StatisticsConfigurations</code> parameter to have
658
+ * the metric stream also send additional statistics in the stream. Streaming additional statistics incurs
659
+ * additional costs. For more information, see <a href="https://aws.amazon.com/cloudwatch/pricing/">Amazon CloudWatch Pricing</a>. </p>
660
+ *
636
661
  * <p>When you use <code>PutMetricStream</code> to create a new metric stream, the stream
637
662
  * is created in the <code>running</code> state. If you use it to update an existing stream,
638
663
  * the state of the stream is not changed.</p>
@@ -7,13 +7,21 @@ export interface GetMetricDataCommandInput extends GetMetricDataInput {
7
7
  export interface GetMetricDataCommandOutput extends GetMetricDataOutput, __MetadataBearer {
8
8
  }
9
9
  /**
10
- * <p>You can use the <code>GetMetricData</code> API to retrieve as many as 500 different
10
+ * <p>You can use the <code>GetMetricData</code> API to retrieve CloudWatch metric values. The operation
11
+ * can also include a CloudWatch Metrics Insights query, and one or more metric math functions.</p>
12
+ * <p>A <code>GetMetricData</code> operation that does not include a query can retrieve as many as 500 different
11
13
  * metrics in a single request, with a total of as many as 100,800 data points. You can also
12
- * optionally perform math expressions on the values of the returned statistics, to create
14
+ * optionally perform metric math expressions on the values of the returned statistics, to create
13
15
  * new time series that represent new insights into your data. For example, using Lambda
14
16
  * metrics, you could divide the Errors metric by the Invocations metric to get an error
15
17
  * rate time series. For more information about metric math expressions, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html#metric-math-syntax">Metric Math Syntax and Functions</a> in the <i>Amazon CloudWatch User
16
- * Guide</i>.</p>
18
+ * Guide</i>.</p>
19
+ *
20
+ *
21
+ * <p>If you include a Metrics Insights query, each <code>GetMetricData</code> operation can include only one
22
+ * query. But the same <code>GetMetricData</code> operation can also retrieve other metrics. Metrics Insights queries
23
+ * can query only the most recent three hours of metric data. For more information about Metrics Insights,
24
+ * see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/query_with_cloudwatch-metrics-insights.html">Query your metrics with CloudWatch Metrics Insights</a>.</p>
17
25
  *
18
26
  * <p>Calls to the <code>GetMetricData</code> API have a different pricing structure than
19
27
  * calls to <code>GetMetricStatistics</code>. For more information about pricing, see
@@ -43,6 +51,16 @@ export interface GetMetricDataCommandOutput extends GetMetricDataOutput, __Metad
43
51
  * <p>If you omit <code>Unit</code> in your request, all data that was collected with any unit is returned, along with the corresponding units that were specified
44
52
  * when the data was reported to CloudWatch. If you specify a unit, the operation returns only data that was collected with that unit specified.
45
53
  * If you specify a unit that does not match the data collected, the results of the operation are null. CloudWatch does not perform unit conversions.</p>
54
+ *
55
+ * <p>
56
+ * <b>Using Metrics Insights queries with metric math</b>
57
+ * </p>
58
+ * <p>You can't mix a Metric Insights query and metric math syntax in the same expression, but
59
+ * you can reference results from a Metrics Insights query within other Metric math expressions. A Metrics Insights
60
+ * query without a <b>GROUP BY</b> clause returns a single time-series (TS),
61
+ * and can be used as input for a metric math expression that expects a single time series. A Metrics Insights
62
+ * query with a <b>GROUP BY</b> clause returns an array of time-series (TS[]),
63
+ * and can be used as input for a metric math expression that expects an array of time series. </p>
46
64
  * @example
47
65
  * Use a bare-bones client and the command you need to make an API call.
48
66
  * ```javascript
@@ -12,7 +12,8 @@ export interface PutCompositeAlarmCommandOutput extends __MetadataBearer {
12
12
  * states of other alarms that you have created. The composite alarm goes into ALARM state
13
13
  * only if all conditions of the rule are met.</p>
14
14
  * <p>The alarms specified in a composite alarm's rule expression can include metric alarms
15
- * and other composite alarms.</p>
15
+ * and other composite alarms. The rule expression of a composite alarm can include as many as 100 underlying alarms.
16
+ * Any single alarm can be included in the rule expressions of as many as 150 composite alarms.</p>
16
17
  * <p>Using composite alarms can reduce
17
18
  * alarm noise. You can create multiple metric alarms,
18
19
  * and also create a composite alarm and
@@ -32,6 +32,12 @@ export interface PutMetricStreamCommandOutput extends PutMetricStreamOutput, __M
32
32
  * </li>
33
33
  * </ul>
34
34
  *
35
+ * <p>By default, a metric stream always sends the <code>MAX</code>, <code>MIN</code>, <code>SUM</code>,
36
+ * and <code>SAMPLECOUNT</code> statistics for each metric that is streamed. You can use the
37
+ * <code>StatisticsConfigurations</code> parameter to have
38
+ * the metric stream also send additional statistics in the stream. Streaming additional statistics incurs
39
+ * additional costs. For more information, see <a href="https://aws.amazon.com/cloudwatch/pricing/">Amazon CloudWatch Pricing</a>. </p>
40
+ *
35
41
  * <p>When you use <code>PutMetricStream</code> to create a new metric stream, the stream
36
42
  * is created in the <code>running</code> state. If you use it to update an existing stream,
37
43
  * the state of the stream is not changed.</p>
@@ -87,15 +87,17 @@ export declare namespace AnomalyDetectorConfiguration {
87
87
  const filterSensitiveLog: (obj: AnomalyDetectorConfiguration) => any;
88
88
  }
89
89
  /**
90
- * <p>A dimension is a name/value pair that is part of the identity of a metric. You
91
- * can assign up to 10 dimensions to a metric. Because dimensions are part of the unique
90
+ * <p>A dimension is a name/value pair that is part of the identity of a metric. Because dimensions are part of the unique
92
91
  * identifier for a metric, whenever you add a unique name/value pair to one of
93
- * your metrics, you are creating a new variation of that metric. </p>
92
+ * your metrics, you are creating a new variation of that metric. For example, many Amazon EC2 metrics publish
93
+ * <code>InstanceId</code> as a dimension name, and the actual instance ID as the value for that dimension.</p>
94
+ * <p>You
95
+ * can assign up to 10 dimensions to a metric.</p>
94
96
  */
95
97
  export interface Dimension {
96
98
  /**
97
- * <p>The name of the dimension. Dimension names must contain only ASCII characters and must include
98
- * at least one non-whitespace character.</p>
99
+ * <p>The name of the dimension. Dimension names must contain only ASCII characters, must include
100
+ * at least one non-whitespace character, and cannot start with a colon (<code>:</code>).</p>
99
101
  */
100
102
  Name: string | undefined;
101
103
  /**
@@ -184,7 +186,7 @@ export declare namespace MetricStat {
184
186
  * <p>This structure is used in both <code>GetMetricData</code> and <code>PutMetricAlarm</code>. The supported
185
187
  * use of this structure is different for those two operations.</p>
186
188
  * <p>When used in <code>GetMetricData</code>, it indicates the metric data to return, and whether this call is just retrieving
187
- * a batch set of data for one metric, or is performing a math expression on metric data. A
189
+ * a batch set of data for one metric, or is performing a Metrics Insights query or a math expression. A
188
190
  * single <code>GetMetricData</code> call can include up to 500 <code>MetricDataQuery</code>
189
191
  * structures.</p>
190
192
  * <p>When used in <code>PutMetricAlarm</code>, it enables you to create an alarm based on a
@@ -221,8 +223,13 @@ export interface MetricDataQuery {
221
223
  */
222
224
  MetricStat?: MetricStat;
223
225
  /**
224
- * <p>The math expression to be performed on the returned data, if this object is performing a math expression. This expression
225
- * can use the <code>Id</code> of the other metrics to refer to those metrics, and can also use the <code>Id</code> of other
226
+ * <p>This field can contain either a Metrics Insights query, or a metric math expression to be performed on the
227
+ * returned data. For more information about Metrics Insights queries, see
228
+ * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-metrics-insights-querylanguage">Metrics Insights query components and syntax</a> in the
229
+ * <i>Amazon CloudWatch User Guide</i>.</p>
230
+ * <p>A math expression
231
+ * can use the <code>Id</code> of the other metrics or queries to refer to those metrics, and can also use
232
+ * the <code>Id</code> of other
226
233
  * expressions to use the result of those expressions. For more information about metric math expressions, see
227
234
  * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html#metric-math-syntax">Metric Math Syntax and Functions</a> in the
228
235
  * <i>Amazon CloudWatch User Guide</i>.</p>
@@ -1127,7 +1134,12 @@ export interface MetricAlarm {
1127
1134
  */
1128
1135
  ComparisonOperator?: ComparisonOperator | string;
1129
1136
  /**
1130
- * <p>Sets how this alarm is to handle missing data points. If this parameter is omitted, the default behavior of <code>missing</code> is used.</p>
1137
+ * <p>Sets how this alarm is to handle missing data points. The valid values
1138
+ * are <code>breaching</code>, <code>notBreaching</code>, <code>ignore</code>, and
1139
+ * <code>missing</code>. For more information, see
1140
+ * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data">Configuring how CloudWatch alarms treat missing data</a>.</p>
1141
+ * <p>If this parameter is omitted, the default
1142
+ * behavior of <code>missing</code> is used.</p>
1131
1143
  */
1132
1144
  TreatMissingData?: string;
1133
1145
  /**
@@ -1733,7 +1745,8 @@ export declare namespace LabelOptions {
1733
1745
  export interface GetMetricDataInput {
1734
1746
  /**
1735
1747
  * <p>The metric queries to be returned. A single <code>GetMetricData</code> call can include as many as 500 <code>MetricDataQuery</code>
1736
- * structures. Each of these structures can specify either a metric to retrieve, or a math expression to perform on retrieved data. </p>
1748
+ * structures. Each of these structures can specify either a metric to retrieve, a Metrics Insights query,
1749
+ * or a math expression to perform on retrieved data. </p>
1737
1750
  */
1738
1751
  MetricDataQueries: MetricDataQuery[] | undefined;
1739
1752
  /**
@@ -2055,6 +2068,64 @@ export declare enum MetricStreamOutputFormat {
2055
2068
  JSON = "json",
2056
2069
  OPEN_TELEMETRY_0_7 = "opentelemetry0.7"
2057
2070
  }
2071
+ /**
2072
+ * <p>This object contains the information for one metric that is to be streamed with
2073
+ * additional statistics.</p>
2074
+ */
2075
+ export interface MetricStreamStatisticsMetric {
2076
+ /**
2077
+ * <p>The namespace of the metric.</p>
2078
+ */
2079
+ Namespace: string | undefined;
2080
+ /**
2081
+ * <p>The name of the metric.</p>
2082
+ */
2083
+ MetricName: string | undefined;
2084
+ }
2085
+ export declare namespace MetricStreamStatisticsMetric {
2086
+ /**
2087
+ * @internal
2088
+ */
2089
+ const filterSensitiveLog: (obj: MetricStreamStatisticsMetric) => any;
2090
+ }
2091
+ /**
2092
+ * <p>By default, a metric stream always sends the <code>MAX</code>, <code>MIN</code>, <code>SUM</code>,
2093
+ * and <code>SAMPLECOUNT</code> statistics for each metric that is streamed. This structure contains information for
2094
+ * one metric that includes additional statistics in the stream. For more information about statistics,
2095
+ * see CloudWatch, listed in
2096
+ * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html">
2097
+ * CloudWatch statistics definitions</a>.</p>
2098
+ */
2099
+ export interface MetricStreamStatisticsConfiguration {
2100
+ /**
2101
+ * <p>An array of metric name and namespace pairs that stream the additional statistics listed
2102
+ * in the value of the <code>AdditionalStatistics</code> parameter. There can be as many as
2103
+ * 100 pairs in the array.</p>
2104
+ * <p>All metrics that match the combination of metric name and namespace will be streamed
2105
+ * with the additional statistics, no matter their dimensions.</p>
2106
+ */
2107
+ IncludeMetrics: MetricStreamStatisticsMetric[] | undefined;
2108
+ /**
2109
+ * <p>The list of additional statistics that are to be streamed for the metrics listed
2110
+ * in the <code>IncludeMetrics</code> array in this structure. This list can include as many as 20 statistics.</p>
2111
+ * <p>If the <code>OutputFormat</code> for the stream is <code>opentelemetry0.7</code>, the only
2112
+ * valid values are <code>p<i>??</i>
2113
+ * </code> percentile statistics such as <code>p90</code>, <code>p99</code> and so on.</p>
2114
+ * <p>If the <code>OutputFormat</code> for the stream is <code>json</code>,
2115
+ * the valid values include the abbreviations for all of the statistics listed in
2116
+ * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html">
2117
+ * CloudWatch statistics definitions</a>. For example, this includes
2118
+ * <code>tm98, </code>
2119
+ * <code>wm90</code>, <code>PR(:300)</code>, and so on.</p>
2120
+ */
2121
+ AdditionalStatistics: string[] | undefined;
2122
+ }
2123
+ export declare namespace MetricStreamStatisticsConfiguration {
2124
+ /**
2125
+ * @internal
2126
+ */
2127
+ const filterSensitiveLog: (obj: MetricStreamStatisticsConfiguration) => any;
2128
+ }
2058
2129
  export interface GetMetricStreamOutput {
2059
2130
  /**
2060
2131
  * <p>The ARN of the metric stream.</p>
@@ -2099,9 +2170,20 @@ export interface GetMetricStreamOutput {
2099
2170
  */
2100
2171
  LastUpdateDate?: Date;
2101
2172
  /**
2102
- * <p></p>
2173
+ * <p>The output format for the stream. Valid values are <code>json</code>
2174
+ * and <code>opentelemetry0.7</code>. For more information about metric stream
2175
+ * output formats, see
2176
+ * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-metric-streams-formats.html">
2177
+ * Metric streams output formats</a>.</p>
2103
2178
  */
2104
2179
  OutputFormat?: MetricStreamOutputFormat | string;
2180
+ /**
2181
+ * <p>Each entry in this array displays information about one or more metrics that include additional statistics
2182
+ * in the metric stream. For more information about the additional statistics, see
2183
+ * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html">
2184
+ * CloudWatch statistics definitions</a>. </p>
2185
+ */
2186
+ StatisticsConfigurations?: MetricStreamStatisticsConfiguration[];
2105
2187
  }
2106
2188
  export declare namespace GetMetricStreamOutput {
2107
2189
  /**
@@ -2930,6 +3012,11 @@ export interface PutMetricAlarmInput {
2930
3012
  * Alarms Treats Missing Data</a>.</p>
2931
3013
  * <p>Valid Values: <code>breaching | notBreaching | ignore | missing</code>
2932
3014
  * </p>
3015
+ * <note>
3016
+ * <p>Alarms that evaluate metrics in the <code>AWS/DynamoDB</code> namespace always <code>ignore</code>
3017
+ * missing data even if you choose a different option for <code>TreatMissingData</code>. When an
3018
+ * <code>AWS/DynamoDB</code> metric has missing data, alarms that evaluate that metric remain in their current state.</p>
3019
+ * </note>
2933
3020
  */
2934
3021
  TreatMissingData?: string;
2935
3022
  /**
@@ -3158,6 +3245,20 @@ export interface PutMetricStreamInput {
3158
3245
  * or <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_UntagResource.html">UntagResource</a>.</p>
3159
3246
  */
3160
3247
  Tags?: Tag[];
3248
+ /**
3249
+ * <p>By default, a metric stream always sends the <code>MAX</code>, <code>MIN</code>, <code>SUM</code>,
3250
+ * and <code>SAMPLECOUNT</code> statistics for each metric that is streamed. You can use this parameter to have
3251
+ * the metric stream also send additional statistics in the stream. This
3252
+ * array can have up to 100 members.</p>
3253
+ * <p>For each entry in this array, you specify one or more metrics and the list of additional statistics to stream
3254
+ * for those metrics. The additional statistics that you can stream depend on the stream's <code>OutputFormat</code>.
3255
+ * If the <code>OutputFormat</code> is <code>json</code>, you can stream any additional statistic that is supported
3256
+ * by CloudWatch, listed in
3257
+ * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html">
3258
+ * CloudWatch statistics definitions</a>. If the <code>OutputFormat</code> is
3259
+ * <code>opentelemetry0.7</code>, you can stream percentile statistics such as p95, p99.9 and so on.</p>
3260
+ */
3261
+ StatisticsConfigurations?: MetricStreamStatisticsConfiguration[];
3161
3262
  }
3162
3263
  export declare namespace PutMetricStreamInput {
3163
3264
  /**
@@ -938,6 +938,28 @@ export declare enum MetricStreamOutputFormat {
938
938
  JSON = "json",
939
939
  OPEN_TELEMETRY_0_7 = "opentelemetry0.7"
940
940
  }
941
+
942
+ export interface MetricStreamStatisticsMetric {
943
+
944
+ Namespace: string | undefined;
945
+
946
+ MetricName: string | undefined;
947
+ }
948
+ export declare namespace MetricStreamStatisticsMetric {
949
+
950
+ const filterSensitiveLog: (obj: MetricStreamStatisticsMetric) => any;
951
+ }
952
+
953
+ export interface MetricStreamStatisticsConfiguration {
954
+
955
+ IncludeMetrics: MetricStreamStatisticsMetric[] | undefined;
956
+
957
+ AdditionalStatistics: string[] | undefined;
958
+ }
959
+ export declare namespace MetricStreamStatisticsConfiguration {
960
+
961
+ const filterSensitiveLog: (obj: MetricStreamStatisticsConfiguration) => any;
962
+ }
941
963
  export interface GetMetricStreamOutput {
942
964
 
943
965
  Arn?: string;
@@ -959,6 +981,8 @@ export interface GetMetricStreamOutput {
959
981
  LastUpdateDate?: Date;
960
982
 
961
983
  OutputFormat?: MetricStreamOutputFormat | string;
984
+
985
+ StatisticsConfigurations?: MetricStreamStatisticsConfiguration[];
962
986
  }
963
987
  export declare namespace GetMetricStreamOutput {
964
988
 
@@ -1307,6 +1331,8 @@ export interface PutMetricStreamInput {
1307
1331
  OutputFormat: MetricStreamOutputFormat | string | undefined;
1308
1332
 
1309
1333
  Tags?: Tag[];
1334
+
1335
+ StatisticsConfigurations?: MetricStreamStatisticsConfiguration[];
1310
1336
  }
1311
1337
  export declare namespace PutMetricStreamInput {
1312
1338
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-cloudwatch",
3
3
  "description": "AWS SDK for JavaScript Cloudwatch Client for Node.js, Browser and React Native",
4
- "version": "3.67.0",
4
+ "version": "3.72.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -18,9 +18,9 @@
18
18
  "dependencies": {
19
19
  "@aws-crypto/sha256-browser": "2.0.0",
20
20
  "@aws-crypto/sha256-js": "2.0.0",
21
- "@aws-sdk/client-sts": "3.67.0",
21
+ "@aws-sdk/client-sts": "3.72.0",
22
22
  "@aws-sdk/config-resolver": "3.58.0",
23
- "@aws-sdk/credential-provider-node": "3.67.0",
23
+ "@aws-sdk/credential-provider-node": "3.72.0",
24
24
  "@aws-sdk/fetch-http-handler": "3.58.0",
25
25
  "@aws-sdk/hash-node": "3.55.0",
26
26
  "@aws-sdk/invalid-dependency": "3.55.0",
@@ -35,15 +35,15 @@
35
35
  "@aws-sdk/node-config-provider": "3.58.0",
36
36
  "@aws-sdk/node-http-handler": "3.58.0",
37
37
  "@aws-sdk/protocol-http": "3.58.0",
38
- "@aws-sdk/smithy-client": "3.55.0",
38
+ "@aws-sdk/smithy-client": "3.72.0",
39
39
  "@aws-sdk/types": "3.55.0",
40
40
  "@aws-sdk/url-parser": "3.55.0",
41
41
  "@aws-sdk/util-base64-browser": "3.58.0",
42
42
  "@aws-sdk/util-base64-node": "3.55.0",
43
43
  "@aws-sdk/util-body-length-browser": "3.55.0",
44
44
  "@aws-sdk/util-body-length-node": "3.55.0",
45
- "@aws-sdk/util-defaults-mode-browser": "3.55.0",
46
- "@aws-sdk/util-defaults-mode-node": "3.58.0",
45
+ "@aws-sdk/util-defaults-mode-browser": "3.72.0",
46
+ "@aws-sdk/util-defaults-mode-node": "3.72.0",
47
47
  "@aws-sdk/util-user-agent-browser": "3.58.0",
48
48
  "@aws-sdk/util-user-agent-node": "3.58.0",
49
49
  "@aws-sdk/util-utf8-browser": "3.55.0",