Skip to main content
GET
Get CloudWatch metric data

Query Parameters

awsAccountId
string
required

AWS account database ID used to resolve credentials.

region
string
required

AWS region the metric lives in.

metricNamespace
string
required

CloudWatch namespace (e.g. AWS/ECS)

metricName
string
required

CloudWatch metric name (e.g. CPUUtilization)

statistic
string
required

CloudWatch statistic to apply (Average, Sum, Maximum, ...)

period
integer<int32>
required

Aggregation period in seconds (e.g. 300). Must obey CloudWatch's per-window granularity floor (60s ≤ 15d, 300s ≤ 63d, 3600s ≤ 455d).

startTime
string
required

Inclusive start of the query window (ISO 8601). Must be earlier than endTime and within CloudWatch's 455-day retention.

endTime
string
required

Inclusive end of the query window (ISO 8601). Must be after startTime and not in the future.

dimensions
string[] | null

Repeated dimensionName=dimensionValue pairs scoping the metric

Response

The request has succeeded.

Response payload for a CloudWatch metric query

datapoints
object[]
required

Time-series datapoints, ordered by timestamp ascending

unit
string
required

Display unit suffix for the metric, inferred server-side from the namespace + metric name (e.g. %, ``, B). Empty when unknown.