Client library for Amazon CloudWatch
npm install --save @datafire/amazonaws_monitoring
let amazonaws_monitoring = require('@datafire/amazonaws_monitoring').create({
accessKeyId: "",
secretAccessKey: "",
region: ""
});
.then(data => {
console.log(data);
});
Amazon CloudWatch monitors your Amazon Web Services (AWS) resources and the applications you run on AWS in real time. You can use CloudWatch to collect and track metrics, which are the variables you want to measure for your resources and applications.
CloudWatch alarms send notifications or automatically change the resources you are monitoring based on rules that you define. For example, you can monitor the CPU usage and disk reads and writes of your Amazon EC2 instances. Then, use this data to determine whether you should launch additional instances to handle increased load. You can also use this data to stop under-used instances to save money.
In addition to monitoring the built-in metrics that come with AWS, you can monitor your own custom metrics. With CloudWatch, you gain system-wide visibility into resource utilization, application performance, and operational health.
amazonaws_monitoring.DeleteAlarms({
"AlarmNames": []
}, context)
- input
object
- AlarmNames required
array
- AlarmNames required
Output schema unknown
amazonaws_monitoring.DeleteAlarms({
"AlarmNames": null
}, context)
- input
object
- AlarmNames required
- items AlarmName
- AlarmNames required
Output schema unknown
amazonaws_monitoring.DeleteAnomalyDetector({
"Namespace": "",
"MetricName": "",
"Stat": ""
}, context)
- input
object
- Namespace required
string
- MetricName required
string
- Dimensions
array
- Stat required
string
- Namespace required
- output DeleteAnomalyDetectorOutput
amazonaws_monitoring.DeleteAnomalyDetector({
"Namespace": null,
"MetricName": null,
"Stat": null
}, context)
- input
object
- Dimensions
- items Dimension
- MetricName required
- Namespace required
- Stat required
- Dimensions
- output DeleteAnomalyDetectorOutput
amazonaws_monitoring.DeleteDashboards({
"DashboardNames": []
}, context)
- input
object
- DashboardNames required
array
- DashboardNames required
- output DeleteDashboardsOutput
amazonaws_monitoring.DeleteDashboards({
"DashboardNames": null
}, context)
- input
object
- DashboardNames required
- items DashboardName
- DashboardNames required
- output DeleteDashboardsOutput
amazonaws_monitoring.DeleteInsightRules({
"RuleNames": []
}, context)
- input
object
- RuleNames required
array
- RuleNames required
- output DeleteInsightRulesOutput
amazonaws_monitoring.DeleteInsightRules({
"RuleNames": null
}, context)
- input
object
- RuleNames required
- items InsightRuleName
- RuleNames required
- output DeleteInsightRulesOutput
amazonaws_monitoring.DescribeAlarmHistory({}, context)
- input
object
- AlarmName
string
- AlarmTypes
array
- HistoryItemType
string
- StartDate
string
- EndDate
string
- MaxRecords
integer
- NextToken
string
- ScanBy
string
- AlarmName
- output DescribeAlarmHistoryOutput
amazonaws_monitoring.DescribeAlarmHistory({}, context)
- input
object
- MaxRecords
string
- NextToken
string
- AlarmName
- AlarmTypes
- items AlarmType
- EndDate
- HistoryItemType
- MaxRecords
- NextToken
- ScanBy
- StartDate
- MaxRecords
- output DescribeAlarmHistoryOutput
amazonaws_monitoring.DescribeAlarms({}, context)
- input
object
- AlarmNames
array
- AlarmNamePrefix
string
- AlarmTypes
array
- ChildrenOfAlarmName
string
- ParentsOfAlarmName
string
- StateValue
string
- ActionPrefix
string
- MaxRecords
integer
- NextToken
string
- AlarmNames
- output DescribeAlarmsOutput
amazonaws_monitoring.DescribeAlarms({}, context)
- input
object
- output DescribeAlarmsOutput
amazonaws_monitoring.DescribeAlarmsForMetric({
"MetricName": "",
"Namespace": ""
}, context)
- input
object
- MetricName required
string
- Namespace required
string
- Statistic
string
- ExtendedStatistic
string
- Dimensions
array
- Period
integer
- Unit
string
- MetricName required
amazonaws_monitoring.DescribeAlarmsForMetric({
"MetricName": null,
"Namespace": null
}, context)
- input
object
- Dimensions
- items Dimension
- ExtendedStatistic
- MetricName required
- Namespace required
- Period
- Statistic
- Unit
- Dimensions
amazonaws_monitoring.DescribeAnomalyDetectors({}, context)
- input
object
- NextToken
string
- MaxResults
integer
- Namespace
string
- MetricName
string
- Dimensions
array
- NextToken
amazonaws_monitoring.DescribeAnomalyDetectors({}, context)
- input
object
- Dimensions
- items Dimension
- MaxResults
- MetricName
- Namespace
- NextToken
- Dimensions
amazonaws_monitoring.DescribeInsightRules({}, context)
- input
object
- NextToken
string
- MaxResults
integer
- NextToken
- output DescribeInsightRulesOutput
amazonaws_monitoring.DescribeInsightRules({}, context)
- input
object
- MaxResults
string
- NextToken
string
- MaxResults
- NextToken
- MaxResults
- output DescribeInsightRulesOutput
amazonaws_monitoring.DisableAlarmActions({
"AlarmNames": []
}, context)
- input
object
- AlarmNames required
array
- AlarmNames required
Output schema unknown
amazonaws_monitoring.DisableAlarmActions({
"AlarmNames": null
}, context)
- input
object
- AlarmNames required
- items AlarmName
- AlarmNames required
Output schema unknown
amazonaws_monitoring.DisableInsightRules({
"RuleNames": []
}, context)
- input
object
- RuleNames required
array
- RuleNames required
- output DisableInsightRulesOutput
amazonaws_monitoring.DisableInsightRules({
"RuleNames": null
}, context)
- input
object
- RuleNames required
- items InsightRuleName
- RuleNames required
- output DisableInsightRulesOutput
amazonaws_monitoring.EnableAlarmActions({
"AlarmNames": []
}, context)
- input
object
- AlarmNames required
array
- AlarmNames required
Output schema unknown
amazonaws_monitoring.EnableAlarmActions({
"AlarmNames": null
}, context)
- input
object
- AlarmNames required
- items AlarmName
- AlarmNames required
Output schema unknown
amazonaws_monitoring.EnableInsightRules({
"RuleNames": []
}, context)
- input
object
- RuleNames required
array
- RuleNames required
- output EnableInsightRulesOutput
amazonaws_monitoring.EnableInsightRules({
"RuleNames": null
}, context)
- input
object
- RuleNames required
- items InsightRuleName
- RuleNames required
- output EnableInsightRulesOutput
amazonaws_monitoring.GetDashboard({
"DashboardName": ""
}, context)
- input
object
- DashboardName required
string
- DashboardName required
- output GetDashboardOutput
amazonaws_monitoring.GetDashboard({
"DashboardName": null
}, context)
- input
object
- DashboardName required
- output GetDashboardOutput
amazonaws_monitoring.GetInsightRuleReport({
"RuleName": "",
"StartTime": "",
"EndTime": "",
"Period": 0
}, context)
- input
object
- RuleName required
string
- StartTime required
string
- EndTime required
string
- Period required
integer
- MaxContributorCount
integer
- Metrics
array
- OrderBy
string
- RuleName required
- output GetInsightRuleReportOutput
amazonaws_monitoring.GetInsightRuleReport({
"RuleName": null,
"StartTime": null,
"EndTime": null,
"Period": null
}, context)
- input
object
- EndTime required
- MaxContributorCount
- Metrics
- items InsightRuleMetricName
- OrderBy
- Period required
- RuleName required
- StartTime required
- output GetInsightRuleReportOutput
amazonaws_monitoring.GetMetricData({
"MetricDataQueries": [],
"StartTime": "",
"EndTime": ""
}, context)
- input
object
- MetricDataQueries required
array
- StartTime required
string
- EndTime required
string
- NextToken
string
- ScanBy
string
- MaxDatapoints
integer
- MetricDataQueries required
- output GetMetricDataOutput
amazonaws_monitoring.GetMetricData({
"MetricDataQueries": null,
"StartTime": null,
"EndTime": null
}, context)
- input
object
- MaxDatapoints
string
- NextToken
string
- EndTime required
- MaxDatapoints
- MetricDataQueries required
- items MetricDataQuery
- NextToken
- ScanBy
- StartTime required
- MaxDatapoints
- output GetMetricDataOutput
amazonaws_monitoring.GetMetricStatistics({
"Namespace": "",
"MetricName": "",
"StartTime": "",
"EndTime": "",
"Period": 0
}, context)
- input
object
- Namespace required
string
- MetricName required
string
- Dimensions
array
- StartTime required
string
- EndTime required
string
- Period required
integer
- Statistics
array
- ExtendedStatistics
array
- Unit
string
- Namespace required
- output GetMetricStatisticsOutput
amazonaws_monitoring.GetMetricStatistics({
"Namespace": null,
"MetricName": null,
"StartTime": null,
"EndTime": null,
"Period": null
}, context)
- input
object
- Dimensions
- items Dimension
- EndTime required
- ExtendedStatistics
- items ExtendedStatistic
- MetricName required
- Namespace required
- Period required
- StartTime required
- Statistics
- items Statistic
- Unit
- Dimensions
- output GetMetricStatisticsOutput
amazonaws_monitoring.GetMetricWidgetImage({
"MetricWidget": ""
}, context)
- input
object
- MetricWidget required
string
- OutputFormat
string
- MetricWidget required
- output GetMetricWidgetImageOutput
amazonaws_monitoring.GetMetricWidgetImage({
"MetricWidget": null
}, context)
- input
object
- MetricWidget required
- OutputFormat
- output GetMetricWidgetImageOutput
amazonaws_monitoring.ListDashboards({}, context)
- input
object
- DashboardNamePrefix
string
- NextToken
string
- DashboardNamePrefix
- output ListDashboardsOutput
amazonaws_monitoring.ListDashboards({}, context)
- input
object
- NextToken
string
- DashboardNamePrefix
- NextToken
- NextToken
- output ListDashboardsOutput
amazonaws_monitoring.ListMetrics({}, context)
- input
object
- Namespace
string
- MetricName
string
- Dimensions
array
- NextToken
string
- RecentlyActive
string
- Namespace
- output ListMetricsOutput
amazonaws_monitoring.ListMetrics({}, context)
- input
object
- NextToken
string
- Dimensions
- items DimensionFilter
- MetricName
- Namespace
- NextToken
- RecentlyActive
- NextToken
- output ListMetricsOutput
amazonaws_monitoring.ListTagsForResource({
"ResourceARN": ""
}, context)
- input
object
- ResourceARN required
string
- ResourceARN required
- output ListTagsForResourceOutput
amazonaws_monitoring.ListTagsForResource({
"ResourceARN": null
}, context)
- input
object
- ResourceARN required
- output ListTagsForResourceOutput
amazonaws_monitoring.PutAnomalyDetector({
"Namespace": "",
"MetricName": "",
"Stat": ""
}, context)
- input
object
- Namespace required
string
- MetricName required
string
- Dimensions
array
- Stat required
string
- Configuration
object
- Namespace required
- output PutAnomalyDetectorOutput
amazonaws_monitoring.PutAnomalyDetector({
"Namespace": null,
"MetricName": null,
"Stat": null
}, context)
- input
object
- output PutAnomalyDetectorOutput
amazonaws_monitoring.PutCompositeAlarm({
"AlarmName": "",
"AlarmRule": ""
}, context)
- input
object
- ActionsEnabled
boolean
- AlarmActions
array
- AlarmDescription
string
- AlarmName required
string
- AlarmRule required
string
- InsufficientDataActions
array
- OKActions
array
- Tags
array
- ActionsEnabled
Output schema unknown
amazonaws_monitoring.PutCompositeAlarm({
"AlarmName": null,
"AlarmRule": null
}, context)
- input
object
- ActionsEnabled
- AlarmActions
- items ResourceName
- AlarmDescription
- AlarmName required
- AlarmRule required
- InsufficientDataActions
- items ResourceName
- OKActions
- items ResourceName
- Tags
- items Tag
Output schema unknown
amazonaws_monitoring.PutDashboard({
"DashboardName": "",
"DashboardBody": ""
}, context)
- input
object
- DashboardName required
string
- DashboardBody required
string
- DashboardName required
- output PutDashboardOutput
amazonaws_monitoring.PutDashboard({
"DashboardName": null,
"DashboardBody": null
}, context)
- input
object
- DashboardBody required
- DashboardName required
- output PutDashboardOutput
amazonaws_monitoring.PutInsightRule({
"RuleName": "",
"RuleDefinition": ""
}, context)
- input
object
- RuleName required
string
- RuleState
string
- RuleDefinition required
string
- Tags
array
- RuleName required
- output PutInsightRuleOutput
amazonaws_monitoring.PutInsightRule({
"RuleName": null,
"RuleDefinition": null
}, context)
- input
object
- RuleDefinition required
- RuleName required
- RuleState
- Tags
- items Tag
- output PutInsightRuleOutput
amazonaws_monitoring.PutMetricAlarm({
"AlarmName": "",
"EvaluationPeriods": 0,
"ComparisonOperator": ""
}, context)
- input
object
- AlarmName required
string
- AlarmDescription
string
- ActionsEnabled
boolean
- OKActions
array
- AlarmActions
array
- InsufficientDataActions
array
- MetricName
string
- Namespace
string
- Statistic
string
- ExtendedStatistic
string
- Dimensions
array
- Period
integer
- Unit
string
- EvaluationPeriods required
integer
- DatapointsToAlarm
integer
- Threshold
number
- ComparisonOperator required
string
- TreatMissingData
string
- EvaluateLowSampleCountPercentile
string
- Metrics
array
- Tags
array
- ThresholdMetricId
string
- AlarmName required
Output schema unknown
amazonaws_monitoring.PutMetricAlarm({
"AlarmName": null,
"EvaluationPeriods": null,
"ComparisonOperator": null
}, context)
- input
object
- ActionsEnabled
- AlarmActions
- items ResourceName
- AlarmDescription
- AlarmName required
- ComparisonOperator required
- DatapointsToAlarm
- Dimensions
- items Dimension
- EvaluateLowSampleCountPercentile
- EvaluationPeriods required
- ExtendedStatistic
- InsufficientDataActions
- items ResourceName
- MetricName
- Metrics
- items MetricDataQuery
- Namespace
- OKActions
- items ResourceName
- Period
- Statistic
- Tags
- items Tag
- Threshold
- ThresholdMetricId
- TreatMissingData
- Unit
Output schema unknown
amazonaws_monitoring.PutMetricData({
"Namespace": "",
"MetricData": []
}, context)
- input
object
- Namespace required
string
- MetricData required
array
- Namespace required
Output schema unknown
amazonaws_monitoring.PutMetricData({
"Namespace": null,
"MetricData": null
}, context)
- input
object
- MetricData required
- items MetricDatum
- Namespace required
- MetricData required
Output schema unknown
amazonaws_monitoring.SetAlarmState({
"AlarmName": "",
"StateValue": "",
"StateReason": ""
}, context)
- input
object
- AlarmName required
string
- StateValue required
string
- StateReason required
string
- StateReasonData
string
- AlarmName required
Output schema unknown
amazonaws_monitoring.SetAlarmState({
"AlarmName": null,
"StateValue": null,
"StateReason": null
}, context)
- input
object
- AlarmName required
- StateReason required
- StateReasonData
- StateValue required
Output schema unknown
amazonaws_monitoring.TagResource({
"ResourceARN": "",
"Tags": []
}, context)
- input
object
- ResourceARN required
string
- Tags required
array
- ResourceARN required
- output TagResourceOutput
amazonaws_monitoring.TagResource({
"ResourceARN": null,
"Tags": null
}, context)
- input
object
- ResourceARN required
- Tags required
- items Tag
- output TagResourceOutput
amazonaws_monitoring.UntagResource({
"ResourceARN": "",
"TagKeys": []
}, context)
- input
object
- ResourceARN required
string
- TagKeys required
array
- ResourceARN required
- output UntagResourceOutput
amazonaws_monitoring.UntagResource({
"ResourceARN": null,
"TagKeys": null
}, context)
- input
object
- ResourceARN required
- TagKeys required
- items TagKey
- output UntagResourceOutput
- ActionPrefix
string
- ActionsEnabled
boolean
- AlarmArn
string
- AlarmDescription
string
- AlarmHistoryItem
object
: Represents the history of a specific alarm.- AlarmName
- AlarmType
- HistoryData
- HistoryItemType
- HistorySummary
- Timestamp
- AlarmHistoryItems
array
- items AlarmHistoryItem
- AlarmName
string
- AlarmNamePrefix
string
- AlarmNames
array
- items AlarmName
- AlarmRule
string
- AlarmType
string
(values: CompositeAlarm, MetricAlarm)
- AlarmTypes
array
- items AlarmType
- AmazonResourceName
string
- AnomalyDetector
object
: An anomaly detection model associated with a particular CloudWatch metric and statistic. You can use the model to display a band of expected normal values when the metric is graphed.
- AnomalyDetectorConfiguration
object
: The configuration specifies details about how the anomaly detection model is to be trained, including time ranges to exclude from use for training the model and the time zone to use for the metric.- ExcludedTimeRanges
- items Range
- MetricTimezone
- ExcludedTimeRanges
- AnomalyDetectorExcludedTimeRanges
array
- items Range
- AnomalyDetectorMetricStat
string
- AnomalyDetectorMetricTimezone
string
- AnomalyDetectorStateValue
string
(values: PENDING_TRAINING, TRAINED_INSUFFICIENT_DATA, TRAINED)
- AnomalyDetectors
array
- items AnomalyDetector
- BatchFailures
array
- items PartialFailure
- ComparisonOperator
string
(values: GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, LessThanOrEqualToThreshold, LessThanLowerOrGreaterThanUpperThreshold, LessThanLowerThreshold, GreaterThanUpperThreshold)
- CompositeAlarm
object
: The details about a composite alarm.- ActionsEnabled
- AlarmActions
- items ResourceName
- AlarmArn
- AlarmConfigurationUpdatedTimestamp
- AlarmDescription
- AlarmName
- AlarmRule
- InsufficientDataActions
- items ResourceName
- OKActions
- items ResourceName
- StateReason
- StateReasonData
- StateUpdatedTimestamp
- StateValue
- CompositeAlarms
array
- items CompositeAlarm
- Counts
array
- items DatapointValue
- DashboardArn
string
- DashboardBody
string
- DashboardEntries
array
- items DashboardEntry
- DashboardEntry
object
: Represents a specific dashboard.- DashboardArn
- DashboardName
- LastModified
- Size
- DashboardName
string
- DashboardNamePrefix
string
- DashboardNames
array
- items DashboardName
- DashboardValidationMessage
object
: An error or warning for the operation.- DataPath
- Message
- DashboardValidationMessages
array
- DataPath
string
- Datapoint
object
: Encapsulates the statistical data that CloudWatch computes from metric data.- Average
- ExtendedStatistics
- Maximum
- Minimum
- SampleCount
- Sum
- Timestamp
- Unit
- DatapointValue
number
- DatapointValueMap
object
- DatapointValues
array
- items DatapointValue
- Datapoints
array
- items Datapoint
- DatapointsToAlarm
integer
- DeleteAlarmsInput
object
- AlarmNames required
- items AlarmName
- AlarmNames required
- DeleteAnomalyDetectorInput
object
- Dimensions
- items Dimension
- MetricName required
- Namespace required
- Stat required
- Dimensions
- DeleteAnomalyDetectorOutput
object
- DeleteDashboardsInput
object
- DashboardNames required
- items DashboardName
- DashboardNames required
- DeleteDashboardsOutput
object
- DeleteInsightRulesInput
object
- RuleNames required
- items InsightRuleName
- RuleNames required
- DeleteInsightRulesOutput
object
- Failures
- items PartialFailure
- Failures
- DescribeAlarmHistoryInput
object
- AlarmName
- AlarmTypes
- items AlarmType
- EndDate
- HistoryItemType
- MaxRecords
- NextToken
- ScanBy
- StartDate
- DescribeAlarmHistoryOutput
object
- AlarmHistoryItems
- items AlarmHistoryItem
- NextToken
- AlarmHistoryItems
- DescribeAlarmsForMetricInput
object
- Dimensions
- items Dimension
- ExtendedStatistic
- MetricName required
- Namespace required
- Period
- Statistic
- Unit
- Dimensions
- DescribeAlarmsForMetricOutput
object
- MetricAlarms
- items MetricAlarm
- MetricAlarms
- DescribeAlarmsInput
object
- DescribeAlarmsOutput
object
- CompositeAlarms
- items CompositeAlarm
- MetricAlarms
- items MetricAlarm
- NextToken
- CompositeAlarms
- DescribeAnomalyDetectorsInput
object
- Dimensions
- items Dimension
- MaxResults
- MetricName
- Namespace
- NextToken
- Dimensions
- DescribeAnomalyDetectorsOutput
object
- AnomalyDetectors
- items AnomalyDetector
- NextToken
- AnomalyDetectors
- DescribeInsightRulesInput
object
- MaxResults
- NextToken
- DescribeInsightRulesOutput
object
- InsightRules
- items InsightRule
- NextToken
- InsightRules
- Dimension
object
: A dimension is a name/value pair that is part of the identity of a metric. You can assign up to 10 dimensions to a metric. Because dimensions are part of the unique identifier for a metric, whenever you add a unique name/value pair to one of your metrics, you are creating a new variation of that metric.- Name required
- Value required
- DimensionFilter
object
: Represents filters for a dimension.- Name required
- Value
- DimensionFilters
array
- items DimensionFilter
- DimensionName
string
- DimensionValue
string
- Dimensions
array
- items Dimension
- DisableAlarmActionsInput
object
- AlarmNames required
- items AlarmName
- AlarmNames required
- DisableInsightRulesInput
object
- RuleNames required
- items InsightRuleName
- RuleNames required
- DisableInsightRulesOutput
object
- Failures
- items PartialFailure
- Failures
- EnableAlarmActionsInput
object
- AlarmNames required
- items AlarmName
- AlarmNames required
- EnableInsightRulesInput
object
- RuleNames required
- items InsightRuleName
- RuleNames required
- EnableInsightRulesOutput
object
- Failures
- items PartialFailure
- Failures
- EvaluateLowSampleCountPercentile
string
- EvaluationPeriods
integer
- ExceptionType
string
- ExtendedStatistic
string
- ExtendedStatistics
array
- items ExtendedStatistic
- FailureCode
string
- FailureDescription
string
- FailureResource
string
- GetDashboardInput
object
- DashboardName required
- GetDashboardOutput
object
- DashboardArn
- DashboardBody
- DashboardName
- GetInsightRuleReportInput
object
- EndTime required
- MaxContributorCount
- Metrics
- items InsightRuleMetricName
- OrderBy
- Period required
- RuleName required
- StartTime required
- GetInsightRuleReportOutput
object
- AggregateValue
- AggregationStatistic
- ApproximateUniqueCount
- Contributors
- items InsightRuleContributor
- KeyLabels
- MetricDatapoints
- GetMetricDataInput
object
- EndTime required
- MaxDatapoints
- MetricDataQueries required
- items MetricDataQuery
- NextToken
- ScanBy
- StartTime required
- GetMetricDataMaxDatapoints
integer
- GetMetricDataOutput
object
- Messages
- items MessageData
- MetricDataResults
- items MetricDataResult
- NextToken
- Messages
- GetMetricStatisticsInput
object
- Dimensions
- items Dimension
- EndTime required
- ExtendedStatistics
- items ExtendedStatistic
- MetricName required
- Namespace required
- Period required
- StartTime required
- Statistics
- items Statistic
- Unit
- Dimensions
- GetMetricStatisticsOutput
object
- Datapoints
- items Datapoint
- Label
- Datapoints
- GetMetricWidgetImageInput
object
- MetricWidget required
- OutputFormat
- GetMetricWidgetImageOutput
object
- MetricWidgetImage
- HistoryData
string
- HistoryItemType
string
(values: ConfigurationUpdate, StateUpdate, Action)
- HistorySummary
string
- InsightRule
object
: This structure contains the definition for a Contributor Insights rule.- Definition required
- Name required
- Schema required
- State required
- InsightRuleAggregationStatistic
string
- InsightRuleContributor
object
:One of the unique contributors found by a Contributor Insights rule. If the rule contains multiple keys, then a unique contributor is a unique combination of values from all the keys in the rule.
If the rule contains a single key, then each unique contributor is each unique value for this key.
For more information, see GetInsightRuleReport.
- ApproximateAggregateValue required
- Datapoints required
- Keys required
- InsightRuleContributorDatapoint
object
:One data point related to one contributor.
For more information, see GetInsightRuleReport and InsightRuleContributor.
- ApproximateValue required
- Timestamp required
- InsightRuleContributorDatapoints
array
- InsightRuleContributorKey
string
- InsightRuleContributorKeyLabel
string
- InsightRuleContributorKeyLabels
array
- InsightRuleContributorKeys
array
- InsightRuleContributors
array
- items InsightRuleContributor
- InsightRuleDefinition
string
- InsightRuleMaxResults
integer
- InsightRuleMetricDatapoint
object
:One data point from the metric time series returned in a Contributor Insights rule report.
For more information, see GetInsightRuleReport.
- Average
- MaxContributorValue
- Maximum
- Minimum
- SampleCount
- Sum
- Timestamp required
- UniqueContributors
- InsightRuleMetricDatapoints
array
- InsightRuleMetricList
array
- items InsightRuleMetricName
- InsightRuleMetricName
string
- InsightRuleName
string
- InsightRuleNames
array
- items InsightRuleName
- InsightRuleOrderBy
string
- InsightRuleSchema
string
- InsightRuleState
string
- InsightRuleUnboundDouble
number
- InsightRuleUnboundInteger
integer
- InsightRuleUnboundLong
integer
- InsightRules
array
- items InsightRule
- LastModified
string
- ListDashboardsInput
object
- DashboardNamePrefix
- NextToken
- ListDashboardsOutput
object
- DashboardEntries
- items DashboardEntry
- NextToken
- DashboardEntries
- ListMetricsInput
object
- Dimensions
- items DimensionFilter
- MetricName
- Namespace
- NextToken
- RecentlyActive
- Dimensions
- ListMetricsOutput
object
- Metrics
- items Metric
- NextToken
- Metrics
- ListTagsForResourceInput
object
- ResourceARN required
- ListTagsForResourceOutput
object
- Tags
- items Tag
- Tags
- MaxRecords
integer
- MaxReturnedResultsCount
integer
- Message
string
- MessageData
object
: A message returned by theGetMetricData
API, including a code and a description.- Code
- Value
- MessageDataCode
string
- MessageDataValue
string
- Metric
object
: Represents a specific metric.- Dimensions
- items Dimension
- MetricName
- Namespace
- Dimensions
- MetricAlarm
object
: The details about a metric alarm.- ActionsEnabled
- AlarmActions
- items ResourceName
- AlarmArn
- AlarmConfigurationUpdatedTimestamp
- AlarmDescription
- AlarmName
- ComparisonOperator
- DatapointsToAlarm
- Dimensions
- items Dimension
- EvaluateLowSampleCountPercentile
- EvaluationPeriods
- ExtendedStatistic
- InsufficientDataActions
- items ResourceName
- MetricName
- Metrics
- items MetricDataQuery
- Namespace
- OKActions
- items ResourceName
- Period
- StateReason
- StateReasonData
- StateUpdatedTimestamp
- StateValue
- Statistic
- Threshold
- ThresholdMetricId
- TreatMissingData
- Unit
- MetricAlarms
array
- items MetricAlarm
- MetricData
array
- items MetricDatum
- MetricDataQueries
array
- items MetricDataQuery
- MetricDataQuery
object
:This structure is used in both
GetMetricData
andPutMetricAlarm
. The supported use of this structure is different for those two operations.When used in
GetMetricData
, it indicates the metric data to return, and whether this call is just retrieving a batch set of data for one metric, or is performing a math expression on metric data. A singleGetMetricData
call can include up to 500MetricDataQuery
structures.When used in
PutMetricAlarm
, it enables you to create an alarm based on a metric math expression. EachMetricDataQuery
in the array specifies either a metric to retrieve, or a math expression to be performed on retrieved metrics. A singlePutMetricAlarm
call can include up to 20MetricDataQuery
structures in the array. The 20 structures can include as many as 10 structures that contain aMetricStat
parameter to retrieve a metric, and as many as 10 structures that contain theExpression
parameter to perform a math expression. Of thoseExpression
structures, one must haveTrue
as the value forReturnData
. The result of this expression is the value the alarm watches.Any expression used in a
PutMetricAlarm
operation must return a single time series. For more information, see Metric Math Syntax and Functions in the Amazon CloudWatch User Guide.Some of the parameters of this structure also have different uses whether you are using this structure in a
GetMetricData
operation or aPutMetricAlarm
operation. These differences are explained in the following parameter list.- Expression
- Id required
- Label
- MetricStat
- Metric required
- Dimensions
- items Dimension
- MetricName
- Namespace
- Dimensions
- Period required
- Stat required
- Unit
- Metric required
- Period
- ReturnData
- MetricDataResult
object
: AGetMetricData
call returns an array ofMetricDataResult
structures. Each of these structures includes the data points for that metric, along with the timestamps of those data points and other identifying information.- Id
- Label
- Messages
- items MessageData
- StatusCode
- Timestamps
- items Timestamp
- Values
- items DatapointValue
- MetricDataResultMessages
array
- items MessageData
- MetricDataResults
array
- items MetricDataResult
- MetricDatum
object
: Encapsulates the information sent to either create a metric or add new values to be aggregated into an existing metric.- Counts
- items DatapointValue
- Dimensions
- items Dimension
- MetricName required
- StatisticValues
- Maximum required
- Minimum required
- SampleCount required
- Sum required
- StorageResolution
- Timestamp
- Unit
- Value
- Values
- items DatapointValue
- Counts
- MetricExpression
string
- MetricId
string
- MetricLabel
string
- MetricName
string
- MetricStat
object
: This structure defines the metric to be returned, along with the statistics, period, and units.- Metric required
- Dimensions
- items Dimension
- MetricName
- Namespace
- Dimensions
- Period required
- Stat required
- Unit
- Metric required
- MetricWidget
string
- MetricWidgetImage
string
- Metrics
array
- items Metric
- Namespace
string
- NextToken
string
- OutputFormat
string
- PartialFailure
object
: This array is empty if the API operation was successful for all the rules specified in the request. If the operation could not process one of the rules, the following data is returned for each of those rules.- ExceptionType
- FailureCode
- FailureDescription
- FailureResource
- Period
integer
- PutAnomalyDetectorInput
object
- PutAnomalyDetectorOutput
object
- PutCompositeAlarmInput
object
- ActionsEnabled
- AlarmActions
- items ResourceName
- AlarmDescription
- AlarmName required
- AlarmRule required
- InsufficientDataActions
- items ResourceName
- OKActions
- items ResourceName
- Tags
- items Tag
- PutDashboardInput
object
- DashboardBody required
- DashboardName required
- PutDashboardOutput
object
- DashboardValidationMessages
- PutInsightRuleInput
object
- RuleDefinition required
- RuleName required
- RuleState
- Tags
- items Tag
- PutInsightRuleOutput
object
- PutMetricAlarmInput
object
- ActionsEnabled
- AlarmActions
- items ResourceName
- AlarmDescription
- AlarmName required
- ComparisonOperator required
- DatapointsToAlarm
- Dimensions
- items Dimension
- EvaluateLowSampleCountPercentile
- EvaluationPeriods required
- ExtendedStatistic
- InsufficientDataActions
- items ResourceName
- MetricName
- Metrics
- items MetricDataQuery
- Namespace
- OKActions
- items ResourceName
- Period
- Statistic
- Tags
- items Tag
- Threshold
- ThresholdMetricId
- TreatMissingData
- Unit
- PutMetricDataInput
object
- MetricData required
- items MetricDatum
- Namespace required
- MetricData required
- Range
object
: Specifies one range of days or times to exclude from use for training an anomaly detection model.- EndTime required
- StartTime required
- RecentlyActive
string
(values: PT3H)
- ResourceList
array
- items ResourceName
- ResourceName
string
- ReturnData
boolean
- ScanBy
string
(values: TimestampDescending, TimestampAscending)
- SetAlarmStateInput
object
- AlarmName required
- StateReason required
- StateReasonData
- StateValue required
- Size
integer
- StandardUnit
string
(values: Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None)
- Stat
string
- StateReason
string
- StateReasonData
string
- StateValue
string
(values: OK, ALARM, INSUFFICIENT_DATA)
- Statistic
string
(values: SampleCount, Average, Sum, Minimum, Maximum)
- StatisticSet
object
: Represents a set of statistics that describes a specific metric.- Maximum required
- Minimum required
- SampleCount required
- Sum required
- Statistics
array
- items Statistic
- StatusCode
string
(values: Complete, InternalError, PartialData)
- StorageResolution
integer
- Tag
object
: A key-value pair associated with a CloudWatch resource.- Key required
- Value required
- TagKey
string
- TagKeyList
array
- items TagKey
- TagList
array
- items Tag
- TagResourceInput
object
- ResourceARN required
- Tags required
- items Tag
- TagResourceOutput
object
- TagValue
string
- Threshold
number
- Timestamp
string
- Timestamps
array
- items Timestamp
- TreatMissingData
string
- UntagResourceInput
object
- ResourceARN required
- TagKeys required
- items TagKey
- UntagResourceOutput
object
- Values
array
- items DatapointValue