dots.v2.insights.query.byRegion().prom.api.v1.query_range.get()
Generated on 5 Nov 2026
from DoTs version
v1.23.0
Usage
client.v2.insights.query.byRegion(region).prom.api.v1.query_range.get(requestConfiguration?: RequestConfiguration<Query_rangeRequestBuilderGetQueryParameters>): Promise<undefined | Prom_query_range_response>Description
To evaluate a PromQL expression over a time range, send a GET request to /v2/insights/query/{region}/prom/api/v1/query_range.
Parameters
Path Parameters
regionstring requiredExample:
nyc3The datacenter region slug for the query.
Query Parameters
querystring requiredExample:
do.droplets.cpu_timeA PromQL expression. This may be a metric selector (for example
do.droplets.cpu_time) or a fuller expression (for examplerate(do.droplets.cpu_time[5m])).startstring requiredExample:
1620683817Start timestamp (inclusive). Accepts a RFC3339 string or a UNIX timestamp.
endstring requiredExample:
1620705417End timestamp (inclusive). Accepts a RFC3339 string or a UNIX timestamp.
stepstring requiredExample:
15sQuery resolution step width as a Prometheus duration string (for example
15s,1m,1h).timeoutstring optionalExample:
30sOptional evaluation timeout as a Prometheus duration string.
Request Sample
Response Example
More Information
See /v2/insights/query/{region}/prom/api/v1/query_range in the API reference for additional detail on responses, headers, parameters, and more.