Table Options #

CloudwatchMetric #

• ListMetrics (CloudwatchListMetricsInput)
• GetMetricStatistics ([]CloudwatchGetMetricStatisticsInput) (nullable)

CloudwatchListMetricsInput

• Dimensions ([]DimensionFilter) (nullable)

  The dimensions to filter against. Only the dimensions that match exactly will be returned.
• IncludeLinkedAccounts (boolean) (nullable)

  If you are using this operation in a monitoring account, specify true to include metrics from source accounts in the returned data.

  The default is false .
• MetricName (string) (nullable)

  The name of the metric to filter against. Only the metrics with names that match exactly will be returned.
• Namespace (string) (nullable)

  The metric namespace to filter against. Only the namespace that matches exactly will be returned.
• OwningAccount (string) (nullable)

  When you use this operation in a monitoring account, use this field to return metrics only from one source account. To do so, specify that source account ID in this field, and also specify true for IncludeLinkedAccounts .
• RecentlyActive (string)

  To filter the results to show only metrics that have had data points published in the past three hours, specify this parameter with a value of PT3H . This is the only valid value for this parameter.

  The results that are returned are an approximation of the value you specify. There is a low probability that the returned results include metrics with last published data as much as 50 minutes more than the specified time interval.

DimensionFilter

• Name (string) (nullable)

  The dimension name to be matched.

  This member is required.
• Value (string) (nullable)

  The value of the dimension to be matched.

CloudwatchGetMetricStatisticsInput

• EndTime (string) (nullable) (format: date-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. In a raw HTTP query, the time stamp must be in ISO 8601 UTC format (for example, 2016-10-10T23:00:00Z).

  This member is required.
• Period (integer) (nullable)

  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).

  This member is required.
• StartTime (string) (nullable) (format: date-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. In a raw HTTP query, 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) 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.

  This member is required.
• ExtendedStatistics ([]string) (nullable)

  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.
• Statistics ([]string) (nullable)

  The metric statistics, other than percentile. For percentile statistics, use ExtendedStatistics . When calling GetMetricStatistics , you must specify either Statistics or ExtendedStatistics , but not both.
• Unit (string)

  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 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.