Skip to main content
GET
Run a PromQL range query

Query Parameters

awsAccountId
string
required

AWS account database ID (or the account's givenId) used to resolve credentials.

region
string
required

AWS region the Amazon Managed Prometheus workspace lives in.

workspaceId
string
required

Amazon Managed Prometheus workspace id (e.g. ws-1234abcd-...).

query
string
required

PromQL expression. Occurrences of $__interval are replaced server-side with the normalized step, so range-vector windows always match the resolution actually queried.

step
integer<int32>
required

Requested step in seconds. Widened server-side to Amazon Managed Prometheus's 15s floor and to whatever keeps the window under the 11,000-samples-per-series cap; the effective value is echoed as stepSeconds.

startTime
string
required

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

endTime
string
required

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

Response

The request has succeeded.

Response payload for a PromQL range query. Always a list of series, even while charts render only the first one — that keeps multi-series charts from being a breaking change later.

series
object[]
required

Result series, in the order Amazon Managed Prometheus returned them

stepSeconds
integer<int32>
required

The step in seconds actually used, after normalization to Amazon Managed Prometheus's floor and per-series sample cap. May be coarser than the requested step.