# WARNING ABOUT GENERATED CODE # # This file is generated. See the contributing guide for more information: # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md # # WARNING ABOUT GENERATED CODE module Aws::CloudWatch module Types # Represents the history of a specific alarm. # # @!attribute [rw] alarm_name # The descriptive name for the alarm. # @return [String] # # @!attribute [rw] timestamp # The time stamp for the alarm history item. # @return [Time] # # @!attribute [rw] history_item_type # The type of alarm history item. # @return [String] # # @!attribute [rw] history_summary # A summary of the alarm history, in text format. # @return [String] # # @!attribute [rw] history_data # Data about the alarm, in JSON format. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/AlarmHistoryItem AWS API Documentation # class AlarmHistoryItem < Struct.new( :alarm_name, :timestamp, :history_item_type, :history_summary, :history_data) include Aws::Structure end # An anomaly detection model associated with a particular CloudWatch # metric athresnd statistic. You can use the model to display a band of # expected normal values when the metric is graphed. # # @!attribute [rw] namespace # The namespace of the metric associated with the anomaly detection # model. # @return [String] # # @!attribute [rw] metric_name # The name of the metric associated with the anomaly detection model. # @return [String] # # @!attribute [rw] dimensions # The metric dimensions associated with the anomaly detection model. # @return [Array] # # @!attribute [rw] stat # The statistic associated with the anomaly detection model. # @return [String] # # @!attribute [rw] configuration # 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. # @return [Types::AnomalyDetectorConfiguration] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/AnomalyDetector AWS API Documentation # class AnomalyDetector < Struct.new( :namespace, :metric_name, :dimensions, :stat, :configuration) include Aws::Structure end # 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. # # @note When making an API call, you may pass AnomalyDetectorConfiguration # data as a hash: # # { # excluded_time_ranges: [ # { # start_time: Time.now, # required # end_time: Time.now, # required # }, # ], # metric_timezone: "AnomalyDetectorMetricTimezone", # } # # @!attribute [rw] excluded_time_ranges # An array of time ranges to exclude from use when the anomaly # detection model is trained. Use this to make sure that events that # could cause unusual values for the metric, such as deployments, # aren't used when CloudWatch creates the model. # @return [Array] # # @!attribute [rw] metric_timezone # The time zone to use for the metric. This is useful to enable the # model to automatically account for daylight savings time changes if # the metric is sensitive to such time changes. # # To specify a time zone, use the name of the time zone as specified # in the standard tz database. For more information, see [tz # database][1]. # # # # [1]: https://en.wikipedia.org/wiki/Tz_database # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/AnomalyDetectorConfiguration AWS API Documentation # class AnomalyDetectorConfiguration < Struct.new( :excluded_time_ranges, :metric_timezone) include Aws::Structure end # Represents a specific dashboard. # # @!attribute [rw] dashboard_name # The name of the dashboard. # @return [String] # # @!attribute [rw] dashboard_arn # The Amazon Resource Name (ARN) of the dashboard. # @return [String] # # @!attribute [rw] last_modified # The time stamp of when the dashboard was last modified, either by an # API call or through the console. This number is expressed as the # number of milliseconds since Jan 1, 1970 00:00:00 UTC. # @return [Time] # # @!attribute [rw] size # The size of the dashboard, in bytes. # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DashboardEntry AWS API Documentation # class DashboardEntry < Struct.new( :dashboard_name, :dashboard_arn, :last_modified, :size) include Aws::Structure end # Some part of the dashboard data is invalid. # # @!attribute [rw] message # @return [String] # # @!attribute [rw] dashboard_validation_messages # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DashboardInvalidInputError AWS API Documentation # class DashboardInvalidInputError < Struct.new( :message, :dashboard_validation_messages) include Aws::Structure end # The specified dashboard does not exist. # # @!attribute [rw] message # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DashboardNotFoundError AWS API Documentation # class DashboardNotFoundError < Struct.new( :message) include Aws::Structure end # An error or warning for the operation. # # @!attribute [rw] data_path # The data path related to the message. # @return [String] # # @!attribute [rw] message # A message describing the error or warning. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DashboardValidationMessage AWS API Documentation # class DashboardValidationMessage < Struct.new( :data_path, :message) include Aws::Structure end # Encapsulates the statistical data that CloudWatch computes from metric # data. # # @!attribute [rw] timestamp # The time stamp used for the data point. # @return [Time] # # @!attribute [rw] sample_count # The number of metric values that contributed to the aggregate value # of this data point. # @return [Float] # # @!attribute [rw] average # The average of the metric values that correspond to the data point. # @return [Float] # # @!attribute [rw] sum # The sum of the metric values for the data point. # @return [Float] # # @!attribute [rw] minimum # The minimum metric value for the data point. # @return [Float] # # @!attribute [rw] maximum # The maximum metric value for the data point. # @return [Float] # # @!attribute [rw] unit # The standard unit for the data point. # @return [String] # # @!attribute [rw] extended_statistics # The percentile statistic for the data point. # @return [Hash] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/Datapoint AWS API Documentation # class Datapoint < Struct.new( :timestamp, :sample_count, :average, :sum, :minimum, :maximum, :unit, :extended_statistics) include Aws::Structure end # @note When making an API call, you may pass DeleteAlarmsInput # data as a hash: # # { # alarm_names: ["AlarmName"], # required # } # # @!attribute [rw] alarm_names # The alarms to be deleted. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DeleteAlarmsInput AWS API Documentation # class DeleteAlarmsInput < Struct.new( :alarm_names) include Aws::Structure end # @note When making an API call, you may pass DeleteAnomalyDetectorInput # data as a hash: # # { # namespace: "Namespace", # required # metric_name: "MetricName", # required # dimensions: [ # { # name: "DimensionName", # required # value: "DimensionValue", # required # }, # ], # stat: "Stat", # required # } # # @!attribute [rw] namespace # The namespace associated with the anomaly detection model to delete. # @return [String] # # @!attribute [rw] metric_name # The metric name associated with the anomaly detection model to # delete. # @return [String] # # @!attribute [rw] dimensions # The metric dimensions associated with the anomaly detection model to # delete. # @return [Array] # # @!attribute [rw] stat # The statistic associated with the anomaly detection model to delete. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DeleteAnomalyDetectorInput AWS API Documentation # class DeleteAnomalyDetectorInput < Struct.new( :namespace, :metric_name, :dimensions, :stat) include Aws::Structure end # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DeleteAnomalyDetectorOutput AWS API Documentation # class DeleteAnomalyDetectorOutput < Aws::EmptyStructure; end # @note When making an API call, you may pass DeleteDashboardsInput # data as a hash: # # { # dashboard_names: ["DashboardName"], # required # } # # @!attribute [rw] dashboard_names # The dashboards to be deleted. This parameter is required. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DeleteDashboardsInput AWS API Documentation # class DeleteDashboardsInput < Struct.new( :dashboard_names) include Aws::Structure end # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DeleteDashboardsOutput AWS API Documentation # class DeleteDashboardsOutput < Aws::EmptyStructure; end # @note When making an API call, you may pass DescribeAlarmHistoryInput # data as a hash: # # { # alarm_name: "AlarmName", # history_item_type: "ConfigurationUpdate", # accepts ConfigurationUpdate, StateUpdate, Action # start_date: Time.now, # end_date: Time.now, # max_records: 1, # next_token: "NextToken", # } # # @!attribute [rw] alarm_name # The name of the alarm. # @return [String] # # @!attribute [rw] history_item_type # The type of alarm histories to retrieve. # @return [String] # # @!attribute [rw] start_date # The starting date to retrieve alarm history. # @return [Time] # # @!attribute [rw] end_date # The ending date to retrieve alarm history. # @return [Time] # # @!attribute [rw] max_records # The maximum number of alarm history records to retrieve. # @return [Integer] # # @!attribute [rw] next_token # The token returned by a previous call to indicate that there is more # data available. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAlarmHistoryInput AWS API Documentation # class DescribeAlarmHistoryInput < Struct.new( :alarm_name, :history_item_type, :start_date, :end_date, :max_records, :next_token) include Aws::Structure end # @!attribute [rw] alarm_history_items # The alarm histories, in JSON format. # @return [Array] # # @!attribute [rw] next_token # The token that marks the start of the next batch of returned # results. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAlarmHistoryOutput AWS API Documentation # class DescribeAlarmHistoryOutput < Struct.new( :alarm_history_items, :next_token) include Aws::Structure end # @note When making an API call, you may pass DescribeAlarmsForMetricInput # data as a hash: # # { # metric_name: "MetricName", # required # namespace: "Namespace", # required # statistic: "SampleCount", # accepts SampleCount, Average, Sum, Minimum, Maximum # extended_statistic: "ExtendedStatistic", # dimensions: [ # { # name: "DimensionName", # required # value: "DimensionValue", # required # }, # ], # period: 1, # unit: "Seconds", # accepts 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 # } # # @!attribute [rw] metric_name # The name of the metric. # @return [String] # # @!attribute [rw] namespace # The namespace of the metric. # @return [String] # # @!attribute [rw] statistic # The statistic for the metric, other than percentiles. For percentile # statistics, use `ExtendedStatistics`. # @return [String] # # @!attribute [rw] extended_statistic # The percentile statistic for the metric. Specify a value between # p0.0 and p100. # @return [String] # # @!attribute [rw] dimensions # The dimensions associated with the metric. If the metric has any # associated dimensions, you must specify them in order for the call # to succeed. # @return [Array] # # @!attribute [rw] period # The period, in seconds, over which the statistic is applied. # @return [Integer] # # @!attribute [rw] unit # The unit for the metric. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAlarmsForMetricInput AWS API Documentation # class DescribeAlarmsForMetricInput < Struct.new( :metric_name, :namespace, :statistic, :extended_statistic, :dimensions, :period, :unit) include Aws::Structure end # @!attribute [rw] metric_alarms # The information for each alarm with the specified metric. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAlarmsForMetricOutput AWS API Documentation # class DescribeAlarmsForMetricOutput < Struct.new( :metric_alarms) include Aws::Structure end # @note When making an API call, you may pass DescribeAlarmsInput # data as a hash: # # { # alarm_names: ["AlarmName"], # alarm_name_prefix: "AlarmNamePrefix", # state_value: "OK", # accepts OK, ALARM, INSUFFICIENT_DATA # action_prefix: "ActionPrefix", # max_records: 1, # next_token: "NextToken", # } # # @!attribute [rw] alarm_names # The names of the alarms. # @return [Array] # # @!attribute [rw] alarm_name_prefix # The alarm name prefix. If this parameter is specified, you cannot # specify `AlarmNames`. # @return [String] # # @!attribute [rw] state_value # The state value to be used in matching alarms. # @return [String] # # @!attribute [rw] action_prefix # The action name prefix. # @return [String] # # @!attribute [rw] max_records # The maximum number of alarm descriptions to retrieve. # @return [Integer] # # @!attribute [rw] next_token # The token returned by a previous call to indicate that there is more # data available. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAlarmsInput AWS API Documentation # class DescribeAlarmsInput < Struct.new( :alarm_names, :alarm_name_prefix, :state_value, :action_prefix, :max_records, :next_token) include Aws::Structure end # @!attribute [rw] metric_alarms # The information for the specified alarms. # @return [Array] # # @!attribute [rw] next_token # The token that marks the start of the next batch of returned # results. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAlarmsOutput AWS API Documentation # class DescribeAlarmsOutput < Struct.new( :metric_alarms, :next_token) include Aws::Structure end # @note When making an API call, you may pass DescribeAnomalyDetectorsInput # data as a hash: # # { # next_token: "NextToken", # max_results: 1, # namespace: "Namespace", # metric_name: "MetricName", # dimensions: [ # { # name: "DimensionName", # required # value: "DimensionValue", # required # }, # ], # } # # @!attribute [rw] next_token # Use the token returned by the previous operation to request the next # page of results. # @return [String] # # @!attribute [rw] max_results # The maximum number of results to return in one operation. The # maximum value you can specify is 10. # # To retrieve the remaining results, make another call with the # returned `NextToken` value. # @return [Integer] # # @!attribute [rw] namespace # Limits the results to only the anomaly detection models that are # associated with the specified namespace. # @return [String] # # @!attribute [rw] metric_name # Limits the results to only the anomaly detection models that are # associated with the specified metric name. If there are multiple # metrics with this name in different namespaces that have anomaly # detection models, they're all returned. # @return [String] # # @!attribute [rw] dimensions # Limits the results to only the anomaly detection models that are # associated with the specified metric dimensions. If there are # multiple metrics that have these dimensions and have anomaly # detection models associated, they're all returned. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAnomalyDetectorsInput AWS API Documentation # class DescribeAnomalyDetectorsInput < Struct.new( :next_token, :max_results, :namespace, :metric_name, :dimensions) include Aws::Structure end # @!attribute [rw] anomaly_detectors # The list of anomaly detection models returned by the operation. # @return [Array] # # @!attribute [rw] next_token # A token that you can use in a subsequent operation to retrieve the # next set of results. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAnomalyDetectorsOutput AWS API Documentation # class DescribeAnomalyDetectorsOutput < Struct.new( :anomaly_detectors, :next_token) include Aws::Structure end # Expands the identity of a metric. # # @note When making an API call, you may pass Dimension # data as a hash: # # { # name: "DimensionName", # required # value: "DimensionValue", # required # } # # @!attribute [rw] name # The name of the dimension. # @return [String] # # @!attribute [rw] value # The value representing the dimension measurement. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/Dimension AWS API Documentation # class Dimension < Struct.new( :name, :value) include Aws::Structure end # Represents filters for a dimension. # # @note When making an API call, you may pass DimensionFilter # data as a hash: # # { # name: "DimensionName", # required # value: "DimensionValue", # } # # @!attribute [rw] name # The dimension name to be matched. # @return [String] # # @!attribute [rw] value # The value of the dimension to be matched. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DimensionFilter AWS API Documentation # class DimensionFilter < Struct.new( :name, :value) include Aws::Structure end # @note When making an API call, you may pass DisableAlarmActionsInput # data as a hash: # # { # alarm_names: ["AlarmName"], # required # } # # @!attribute [rw] alarm_names # The names of the alarms. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DisableAlarmActionsInput AWS API Documentation # class DisableAlarmActionsInput < Struct.new( :alarm_names) include Aws::Structure end # @note When making an API call, you may pass EnableAlarmActionsInput # data as a hash: # # { # alarm_names: ["AlarmName"], # required # } # # @!attribute [rw] alarm_names # The names of the alarms. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/EnableAlarmActionsInput AWS API Documentation # class EnableAlarmActionsInput < Struct.new( :alarm_names) include Aws::Structure end # @note When making an API call, you may pass GetDashboardInput # data as a hash: # # { # dashboard_name: "DashboardName", # required # } # # @!attribute [rw] dashboard_name # The name of the dashboard to be described. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetDashboardInput AWS API Documentation # class GetDashboardInput < Struct.new( :dashboard_name) include Aws::Structure end # @!attribute [rw] dashboard_arn # The Amazon Resource Name (ARN) of the dashboard. # @return [String] # # @!attribute [rw] dashboard_body # The detailed information about the dashboard, including what widgets # are included and their location on the dashboard. For more # information about the `DashboardBody` syntax, see # CloudWatch-Dashboard-Body-Structure. # @return [String] # # @!attribute [rw] dashboard_name # The name of the dashboard. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetDashboardOutput AWS API Documentation # class GetDashboardOutput < Struct.new( :dashboard_arn, :dashboard_body, :dashboard_name) include Aws::Structure end # @note When making an API call, you may pass GetMetricDataInput # data as a hash: # # { # metric_data_queries: [ # required # { # id: "MetricId", # required # metric_stat: { # metric: { # required # namespace: "Namespace", # metric_name: "MetricName", # dimensions: [ # { # name: "DimensionName", # required # value: "DimensionValue", # required # }, # ], # }, # period: 1, # required # stat: "Stat", # required # unit: "Seconds", # accepts 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 # }, # expression: "MetricExpression", # label: "MetricLabel", # return_data: false, # period: 1, # }, # ], # start_time: Time.now, # required # end_time: Time.now, # required # next_token: "NextToken", # scan_by: "TimestampDescending", # accepts TimestampDescending, TimestampAscending # max_datapoints: 1, # } # # @!attribute [rw] metric_data_queries # The metric queries to be returned. A single `GetMetricData` call can # include as many as 100 `MetricDataQuery` structures. Each of these # structures can specify either a metric to retrieve, or a math # expression to perform on retrieved data. # @return [Array] # # @!attribute [rw] start_time # The time stamp indicating the earliest data to be returned. # # The value specified is inclusive; results include data points with # the specified time stamp. # # CloudWatch rounds the specified time stamp as follows: # # * Start time less than 15 days ago - Round down to the nearest whole # minute. For example, 12:32:34 is rounded down to 12:32:00. # # * Start time between 15 and 63 days ago - Round down to the nearest # 5-minute clock interval. For example, 12:32:34 is rounded down to # 12:30:00. # # * Start time greater than 63 days ago - Round down to the nearest # 1-hour clock interval. For example, 12:32:34 is rounded down to # 12:00:00. # # If you set `Period` to 5, 10, or 30, the start time of your request # is rounded down to the nearest time that corresponds to even 5-, # 10-, or 30-second divisions of a minute. For example, if you make a # query at (HH:mm:ss) 01:05:23 for the previous 10-second period, the # start time of your request is rounded down and you receive data from # 01:05:10 to 01:05:20. If you make a query at 15:07:17 for the # previous 5 minutes of data, using a period of 5 seconds, you receive # data timestamped between 15:02:15 and 15:07:15. # # For better performance, specify `StartTime` and `EndTime` values # that align with the value of the metric's `Period` and sync up with # the beginning and end of an hour. For example, if the `Period` of a # metric is 5 minutes, specifying 12:05 or 12:30 as `StartTime` can # get a faster response from CloudWatch than setting 12:07 or 12:29 as # the `StartTime`. # @return [Time] # # @!attribute [rw] end_time # The time stamp indicating the latest data to be returned. # # The value specified is exclusive; results include data points up to # the specified time stamp. # # For better performance, specify `StartTime` and `EndTime` values # that align with the value of the metric's `Period` and sync up with # the beginning and end of an hour. For example, if the `Period` of a # metric is 5 minutes, specifying 12:05 or 12:30 as `EndTime` can get # a faster response from CloudWatch than setting 12:07 or 12:29 as the # `EndTime`. # @return [Time] # # @!attribute [rw] next_token # Include this value, if it was returned by the previous call, to get # the next set of data points. # @return [String] # # @!attribute [rw] scan_by # The order in which data points should be returned. # `TimestampDescending` returns the newest data first and paginates # when the `MaxDatapoints` limit is reached. `TimestampAscending` # returns the oldest data first and paginates when the `MaxDatapoints` # limit is reached. # @return [String] # # @!attribute [rw] max_datapoints # The maximum number of data points the request should return before # paginating. If you omit this, the default of 100,800 is used. # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetMetricDataInput AWS API Documentation # class GetMetricDataInput < Struct.new( :metric_data_queries, :start_time, :end_time, :next_token, :scan_by, :max_datapoints) include Aws::Structure end # @!attribute [rw] metric_data_results # The metrics that are returned, including the metric name, namespace, # and dimensions. # @return [Array] # # @!attribute [rw] next_token # A token that marks the next batch of returned results. # @return [String] # # @!attribute [rw] messages # Contains a message about this `GetMetricData` operation, if the # operation results in such a message. An example of a message that # may be returned is `Maximum number of allowed metrics exceeded`. If # there is a message, as much of the operation as possible is still # executed. # # A message appears here only if it is related to the global # `GetMetricData` operation. Any message about a specific metric # returned by the operation appears in the `MetricDataResult` object # returned for that metric. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetMetricDataOutput AWS API Documentation # class GetMetricDataOutput < Struct.new( :metric_data_results, :next_token, :messages) include Aws::Structure end # @note When making an API call, you may pass GetMetricStatisticsInput # data as a hash: # # { # namespace: "Namespace", # required # metric_name: "MetricName", # required # dimensions: [ # { # name: "DimensionName", # required # value: "DimensionValue", # required # }, # ], # start_time: Time.now, # required # end_time: Time.now, # required # period: 1, # required # statistics: ["SampleCount"], # accepts SampleCount, Average, Sum, Minimum, Maximum # extended_statistics: ["ExtendedStatistic"], # unit: "Seconds", # accepts 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 # } # # @!attribute [rw] namespace # The namespace of the metric, with or without spaces. # @return [String] # # @!attribute [rw] metric_name # The name of the metric, with or without spaces. # @return [String] # # @!attribute [rw] dimensions # The dimensions. If the metric contains multiple dimensions, you must # include a value for each dimension. CloudWatch treats each unique # combination of dimensions as a separate metric. If a specific # combination of dimensions was not published, you can't retrieve # statistics for it. You must specify the same dimensions that were # used when the metrics were created. For an example, see [Dimension # Combinations][1] in the *Amazon CloudWatch User Guide*. For more # information about specifying dimensions, see [Publishing Metrics][2] # in the *Amazon CloudWatch User Guide*. # # # # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#dimension-combinations # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/publishingMetrics.html # @return [Array] # # @!attribute [rw] start_time # The time stamp that determines the first data point to return. Start # times are evaluated relative to the time that CloudWatch receives # the request. # # The value specified is inclusive; results include data points with # the specified time stamp. The time stamp must be in ISO 8601 UTC # format (for example, 2016-10-03T23:00:00Z). # # CloudWatch rounds the specified time stamp as follows: # # * Start time less than 15 days ago - Round down to the nearest whole # minute. For example, 12:32:34 is rounded down to 12:32:00. # # * Start time between 15 and 63 days ago - Round down to the nearest # 5-minute clock interval. For example, 12:32:34 is rounded down to # 12:30:00. # # * Start time greater than 63 days ago - Round down to the nearest # 1-hour clock interval. For example, 12:32:34 is rounded down to # 12:00:00. # # If you set `Period` to 5, 10, or 30, the start time of your request # is rounded down to the nearest time that corresponds to even 5-, # 10-, or 30-second divisions of a minute. For example, if you make a # query at (HH:mm:ss) 01:05:23 for the previous 10-second period, the # start time of your request is rounded down and you receive data from # 01:05:10 to 01:05:20. If you make a query at 15:07:17 for the # previous 5 minutes of data, using a period of 5 seconds, you receive # data timestamped between 15:02:15 and 15:07:15. # @return [Time] # # @!attribute [rw] end_time # The time stamp that determines the last data point to return. # # The value specified is exclusive; results include data points up to # the specified time stamp. The time stamp must be in ISO 8601 UTC # format (for example, 2016-10-10T23:00:00Z). # @return [Time] # # @!attribute [rw] period # The granularity, in seconds, of the returned data points. For # metrics with regular resolution, a period can be as short as one # minute (60 seconds) and must be a multiple of 60. For # high-resolution metrics that are collected at intervals of less than # one minute, the period can be 1, 5, 10, 30, 60, or any multiple of # 60. High-resolution metrics are those metrics stored by a # `PutMetricData` call that includes a `StorageResolution` of 1 # second. # # If the `StartTime` parameter specifies a time stamp that is greater # than 3 hours ago, you must specify the period as follows or no data # points in that time range is returned: # # * Start time between 3 hours and 15 days ago - Use a multiple of 60 # seconds (1 minute). # # * Start time between 15 and 63 days ago - Use a multiple of 300 # seconds (5 minutes). # # * Start time greater than 63 days ago - Use a multiple of 3600 # seconds (1 hour). # @return [Integer] # # @!attribute [rw] statistics # The metric statistics, other than percentile. For percentile # statistics, use `ExtendedStatistics`. When calling # `GetMetricStatistics`, you must specify either `Statistics` or # `ExtendedStatistics`, but not both. # @return [Array] # # @!attribute [rw] extended_statistics # The percentile statistics. Specify values between p0.0 and p100. # When calling `GetMetricStatistics`, you must specify either # `Statistics` or `ExtendedStatistics`, but not both. Percentile # statistics are not available for metrics when any of the metric # values are negative numbers. # @return [Array] # # @!attribute [rw] unit # The unit for a given metric. If you omit `Unit`, all data that was # collected with any unit is returned, along with the corresponding # units that were specified when the data was reported to CloudWatch. # If you specify a unit, the operation returns only data data that was # collected with that unit specified. 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. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetMetricStatisticsInput AWS API Documentation # class GetMetricStatisticsInput < Struct.new( :namespace, :metric_name, :dimensions, :start_time, :end_time, :period, :statistics, :extended_statistics, :unit) include Aws::Structure end # @!attribute [rw] label # A label for the specified metric. # @return [String] # # @!attribute [rw] datapoints # The data points for the specified metric. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetMetricStatisticsOutput AWS API Documentation # class GetMetricStatisticsOutput < Struct.new( :label, :datapoints) include Aws::Structure end # @note When making an API call, you may pass GetMetricWidgetImageInput # data as a hash: # # { # metric_widget: "MetricWidget", # required # output_format: "OutputFormat", # } # # @!attribute [rw] metric_widget # A JSON string that defines the bitmap graph to be retrieved. The # string includes the metrics to include in the graph, statistics, # annotations, title, axis limits, and so on. You can include only one # `MetricWidget` parameter in each `GetMetricWidgetImage` call. # # For more information about the syntax of `MetricWidget` see # CloudWatch-Metric-Widget-Structure. # # If any metric on the graph could not load all the requested data # points, an orange triangle with an exclamation point appears next to # the graph legend. # @return [String] # # @!attribute [rw] output_format # The format of the resulting image. Only PNG images are supported. # # The default is `png`. If you specify `png`, the API returns an HTTP # response with the content-type set to `text/xml`. The image data is # in a `MetricWidgetImage` field. For example: # # ` >` # # ` ` # # ` ` # # ` iVBORw0KGgoAAAANSUhEUgAAAlgAAAGQEAYAAAAip...` # # ` ` # # ` ` # # ` ` # # ` 6f0d4192-4d42-11e8-82c1-f539a07e0e3b` # # ` ` # # `` # # The `image/png` setting is intended only for custom HTTP requests. # For most use cases, and all actions using an AWS SDK, you should use # `png`. If you specify `image/png`, the HTTP response has a # content-type set to `image/png`, and the body of the response is a # PNG image. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetMetricWidgetImageInput AWS API Documentation # class GetMetricWidgetImageInput < Struct.new( :metric_widget, :output_format) include Aws::Structure end # @!attribute [rw] metric_widget_image # The image of the graph, in the output format specified. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetMetricWidgetImageOutput AWS API Documentation # class GetMetricWidgetImageOutput < Struct.new( :metric_widget_image) include Aws::Structure end # Request processing has failed due to some unknown error, exception, or # failure. # # @!attribute [rw] message # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/InternalServiceFault AWS API Documentation # class InternalServiceFault < Struct.new( :message) include Aws::Structure end # Data was not syntactically valid JSON. # # @!attribute [rw] message # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/InvalidFormatFault AWS API Documentation # class InvalidFormatFault < Struct.new( :message) include Aws::Structure end # The next token specified is invalid. # # @!attribute [rw] message # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/InvalidNextToken AWS API Documentation # class InvalidNextToken < Struct.new( :message) include Aws::Structure end # Parameters were used together that cannot be used together. # # @!attribute [rw] message # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/InvalidParameterCombinationException AWS API Documentation # class InvalidParameterCombinationException < Struct.new( :message) include Aws::Structure end # The value of an input parameter is bad or out-of-range. # # @!attribute [rw] message # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/InvalidParameterValueException AWS API Documentation # class InvalidParameterValueException < Struct.new( :message) include Aws::Structure end # The quota for alarms for this customer has already been reached. # # @!attribute [rw] message # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/LimitExceededFault AWS API Documentation # class LimitExceededFault < Struct.new( :message) include Aws::Structure end # @note When making an API call, you may pass ListDashboardsInput # data as a hash: # # { # dashboard_name_prefix: "DashboardNamePrefix", # next_token: "NextToken", # } # # @!attribute [rw] dashboard_name_prefix # If you specify this parameter, only the dashboards with names # starting with the specified string are listed. The maximum length is # 255, and valid characters are A-Z, a-z, 0-9, ".", "-", and # "\_". # @return [String] # # @!attribute [rw] next_token # The token returned by a previous call to indicate that there is more # data available. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/ListDashboardsInput AWS API Documentation # class ListDashboardsInput < Struct.new( :dashboard_name_prefix, :next_token) include Aws::Structure end # @!attribute [rw] dashboard_entries # The list of matching dashboards. # @return [Array] # # @!attribute [rw] next_token # The token that marks the start of the next batch of returned # results. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/ListDashboardsOutput AWS API Documentation # class ListDashboardsOutput < Struct.new( :dashboard_entries, :next_token) include Aws::Structure end # @note When making an API call, you may pass ListMetricsInput # data as a hash: # # { # namespace: "Namespace", # metric_name: "MetricName", # dimensions: [ # { # name: "DimensionName", # required # value: "DimensionValue", # }, # ], # next_token: "NextToken", # } # # @!attribute [rw] namespace # The namespace to filter against. # @return [String] # # @!attribute [rw] metric_name # The name of the metric to filter against. # @return [String] # # @!attribute [rw] dimensions # The dimensions to filter against. # @return [Array] # # @!attribute [rw] next_token # The token returned by a previous call to indicate that there is more # data available. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/ListMetricsInput AWS API Documentation # class ListMetricsInput < Struct.new( :namespace, :metric_name, :dimensions, :next_token) include Aws::Structure end # @!attribute [rw] metrics # The metrics. # @return [Array] # # @!attribute [rw] next_token # The token that marks the start of the next batch of returned # results. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/ListMetricsOutput AWS API Documentation # class ListMetricsOutput < Struct.new( :metrics, :next_token) include Aws::Structure end # @note When making an API call, you may pass ListTagsForResourceInput # data as a hash: # # { # resource_arn: "AmazonResourceName", # required # } # # @!attribute [rw] resource_arn # The ARN of the CloudWatch resource that you want to view tags for. # For more information on ARN format, see [Example ARNs][1] in the # *Amazon Web Services General Reference*. # # # # [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-cloudwatch # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/ListTagsForResourceInput AWS API Documentation # class ListTagsForResourceInput < Struct.new( :resource_arn) include Aws::Structure end # @!attribute [rw] tags # The list of tag keys and values associated with the resource you # specified. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/ListTagsForResourceOutput AWS API Documentation # class ListTagsForResourceOutput < Struct.new( :tags) include Aws::Structure end # A message returned by the `GetMetricData`API, including a code and a # description. # # @!attribute [rw] code # The error code or status code associated with the message. # @return [String] # # @!attribute [rw] value # The message text. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/MessageData AWS API Documentation # class MessageData < Struct.new( :code, :value) include Aws::Structure end # Represents a specific metric. # # @note When making an API call, you may pass Metric # data as a hash: # # { # namespace: "Namespace", # metric_name: "MetricName", # dimensions: [ # { # name: "DimensionName", # required # value: "DimensionValue", # required # }, # ], # } # # @!attribute [rw] namespace # The namespace of the metric. # @return [String] # # @!attribute [rw] metric_name # The name of the metric. This is a required field. # @return [String] # # @!attribute [rw] dimensions # The dimensions for the metric. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/Metric AWS API Documentation # class Metric < Struct.new( :namespace, :metric_name, :dimensions) include Aws::Structure end # Represents an alarm. # # @!attribute [rw] alarm_name # The name of the alarm. # @return [String] # # @!attribute [rw] alarm_arn # The Amazon Resource Name (ARN) of the alarm. # @return [String] # # @!attribute [rw] alarm_description # The description of the alarm. # @return [String] # # @!attribute [rw] alarm_configuration_updated_timestamp # The time stamp of the last update to the alarm configuration. # @return [Time] # # @!attribute [rw] actions_enabled # Indicates whether actions should be executed during any changes to # the alarm state. # @return [Boolean] # # @!attribute [rw] ok_actions # The actions to execute when this alarm transitions to the `OK` state # from any other state. Each action is specified as an Amazon Resource # Name (ARN). # @return [Array] # # @!attribute [rw] alarm_actions # The actions to execute when this alarm transitions to the `ALARM` # state from any other state. Each action is specified as an Amazon # Resource Name (ARN). # @return [Array] # # @!attribute [rw] insufficient_data_actions # The actions to execute when this alarm transitions to the # `INSUFFICIENT_DATA` state from any other state. Each action is # specified as an Amazon Resource Name (ARN). # @return [Array] # # @!attribute [rw] state_value # The state value for the alarm. # @return [String] # # @!attribute [rw] state_reason # An explanation for the alarm state, in text format. # @return [String] # # @!attribute [rw] state_reason_data # An explanation for the alarm state, in JSON format. # @return [String] # # @!attribute [rw] state_updated_timestamp # The time stamp of the last update to the alarm state. # @return [Time] # # @!attribute [rw] metric_name # The name of the metric associated with the alarm, if this is an # alarm based on a single metric. # @return [String] # # @!attribute [rw] namespace # The namespace of the metric associated with the alarm. # @return [String] # # @!attribute [rw] statistic # The statistic for the metric associated with the alarm, other than # percentile. For percentile statistics, use `ExtendedStatistic`. # @return [String] # # @!attribute [rw] extended_statistic # The percentile statistic for the metric associated with the alarm. # Specify a value between p0.0 and p100. # @return [String] # # @!attribute [rw] dimensions # The dimensions for the metric associated with the alarm. # @return [Array] # # @!attribute [rw] period # The period, in seconds, over which the statistic is applied. # @return [Integer] # # @!attribute [rw] unit # The unit of the metric associated with the alarm. # @return [String] # # @!attribute [rw] evaluation_periods # The number of periods over which data is compared to the specified # threshold. # @return [Integer] # # @!attribute [rw] datapoints_to_alarm # The number of datapoints that must be breaching to trigger the # alarm. # @return [Integer] # # @!attribute [rw] threshold # The value to compare with the specified statistic. # @return [Float] # # @!attribute [rw] comparison_operator # The arithmetic operation to use when comparing the specified # statistic and threshold. The specified statistic value is used as # the first operand. # @return [String] # # @!attribute [rw] treat_missing_data # Sets how this alarm is to handle missing data points. If this # parameter is omitted, the default behavior of `missing` is used. # @return [String] # # @!attribute [rw] evaluate_low_sample_count_percentile # Used only for alarms based on percentiles. If `ignore`, the alarm # state does not change during periods with too few data points to be # statistically significant. If `evaluate` or this parameter is not # used, the alarm is always evaluated and possibly changes state no # matter how many data points are available. # @return [String] # # @!attribute [rw] metrics # An array of MetricDataQuery structures, used in an alarm based on a # metric math expression. Each structure either retrieves a metric or # performs a math expression. One item in the Metrics array is the # math expression that the alarm watches. This expression by # designated by having `ReturnValue` set to true. # @return [Array] # # @!attribute [rw] threshold_metric_id # In an alarm based on an anomaly detection model, this is the ID of # the `ANOMALY_DETECTION_BAND` function used as the threshold for the # alarm. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/MetricAlarm AWS API Documentation # class MetricAlarm < Struct.new( :alarm_name, :alarm_arn, :alarm_description, :alarm_configuration_updated_timestamp, :actions_enabled, :ok_actions, :alarm_actions, :insufficient_data_actions, :state_value, :state_reason, :state_reason_data, :state_updated_timestamp, :metric_name, :namespace, :statistic, :extended_statistic, :dimensions, :period, :unit, :evaluation_periods, :datapoints_to_alarm, :threshold, :comparison_operator, :treat_missing_data, :evaluate_low_sample_count_percentile, :metrics, :threshold_metric_id) include Aws::Structure end # This structure is used in both `GetMetricData` and `PutMetricAlarm`. # 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 single # `GetMetricData` call can include up to 100 `MetricDataQuery` # structures. # # When used in `PutMetricAlarm`, it enables you to create an alarm based # on a metric math expression. Each `MetricDataQuery` in the array # specifies either a metric to retrieve, or a math expression to be # performed on retrieved metrics. A single `PutMetricAlarm` call can # include up to 20 `MetricDataQuery` structures in the array. The 20 # structures can include as many as 10 structures that contain a # `MetricStat` parameter to retrieve a metric, and as many as 10 # structures that contain the `Expression` parameter to perform a math # expression. Of those `Expression` structures, one must have `True` as # the value for `ReturnData`. 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][1] 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 # a `PutMetricAlarm` operation. These differences are explained in the # following parameter list. # # # # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html#metric-math-syntax # # @note When making an API call, you may pass MetricDataQuery # data as a hash: # # { # id: "MetricId", # required # metric_stat: { # metric: { # required # namespace: "Namespace", # metric_name: "MetricName", # dimensions: [ # { # name: "DimensionName", # required # value: "DimensionValue", # required # }, # ], # }, # period: 1, # required # stat: "Stat", # required # unit: "Seconds", # accepts 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 # }, # expression: "MetricExpression", # label: "MetricLabel", # return_data: false, # period: 1, # } # # @!attribute [rw] id # A short name used to tie this object to the results in the response. # This name must be unique within a single call to `GetMetricData`. If # you are performing math expressions on this set of data, this name # represents that data and can serve as a variable in the mathematical # expression. The valid characters are letters, numbers, and # underscore. The first character must be a lowercase letter. # @return [String] # # @!attribute [rw] metric_stat # The metric to be returned, along with statistics, period, and units. # Use this parameter only if this object is retrieving a metric and # not performing a math expression on returned data. # # Within one MetricDataQuery object, you must specify either # `Expression` or `MetricStat` but not both. # @return [Types::MetricStat] # # @!attribute [rw] expression # The math expression to be performed on the returned data, if this # object is performing a math expression. This expression can use the # `Id` of the other metrics to refer to those metrics, and can also # use the `Id` of other expressions to use the result of those # expressions. For more information about metric math expressions, see # [Metric Math Syntax and Functions][1] in the *Amazon CloudWatch User # Guide*. # # Within each MetricDataQuery object, you must specify either # `Expression` or `MetricStat` but not both. # # # # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html#metric-math-syntax # @return [String] # # @!attribute [rw] label # A human-readable label for this metric or expression. This is # especially useful if this is an expression, so that you know what # the value represents. If the metric or expression is shown in a # CloudWatch dashboard widget, the label is shown. If Label is # omitted, CloudWatch generates a default. # @return [String] # # @!attribute [rw] return_data # When used in `GetMetricData`, this option indicates whether to # return the timestamps and raw data values of this metric. If you are # performing this call just to do math expressions and do not also # need the raw data returned, you can specify `False`. If you omit # this, the default of `True` is used. # # When used in `PutMetricAlarm`, specify `True` for the one expression # result to use as the alarm. For all other metrics and expressions in # the same `PutMetricAlarm` operation, specify `ReturnData` as False. # @return [Boolean] # # @!attribute [rw] period # The granularity, in seconds, of the returned data points. For # metrics with regular resolution, a period can be as short as one # minute (60 seconds) and must be a multiple of 60. For # high-resolution metrics that are collected at intervals of less than # one minute, the period can be 1, 5, 10, 30, 60, or any multiple of # 60. High-resolution metrics are those metrics stored by a # `PutMetricData` operation that includes a `StorageResolution of 1 # second`. # # Use this field only when you are performing a `GetMetricData` # operation, and only when you are specifying the `Expression` field. # Do not use this field with a `PutMetricAlarm` operation or when you # are specifying a `MetricStat` in a `GetMetricData` operation. # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/MetricDataQuery AWS API Documentation # class MetricDataQuery < Struct.new( :id, :metric_stat, :expression, :label, :return_data, :period) include Aws::Structure end # A `GetMetricData` call returns an array of `MetricDataResult` # structures. Each of these structures includes the data points for that # metric, along with the timestamps of those data points and other # identifying information. # # @!attribute [rw] id # The short name you specified to represent this metric. # @return [String] # # @!attribute [rw] label # The human-readable label associated with the data. # @return [String] # # @!attribute [rw] timestamps # The timestamps for the data points, formatted in Unix timestamp # format. The number of timestamps always matches the number of values # and the value for Timestamps\[x\] is Values\[x\]. # @return [Array