dots.v2.insights.query.byRegion().prom.api.v1.label.byName().values.get()

Generated on 13 Nov 2026 from DoTs version v1.24.0

Usage

client.v2.insights.query.byRegion(region).prom.api.v1.label.byName(name).values.get(requestConfiguration?: RequestConfiguration<ValuesRequestBuilderGetQueryParameters>): Promise<undefined | Prom_string_list_response>

Description

To list values for a label name, send a GET request to /v2/insights/query/{region}/prom/api/v1/label/{name}/values.

Parameters

Path Parameters

region string required

Example: nyc3

The datacenter region slug for the query.

name string required

Example: __name__

The label name whose values should be listed.

Query Parameters

start string optional

Example: 1620683817

Optional start timestamp (inclusive). Accepts a RFC3339 string or a UNIX timestamp.

end string optional

Example: 1620705417

Optional end timestamp (inclusive). Accepts a RFC3339 string or a UNIX timestamp.

match array of strings optional

Example: ["{__name__=~\".+\"}"]

One or more series selectors. Repeat the parameter for multiple matchers.

Request Sample

Show Request Sample
import { FetchRequestAdapter } from "@microsoft/kiota-http-fetchlibrary";
import {
    createDigitalOceanClient,
    DigitalOceanApiKeyAuthenticationProvider,
} from "@digitalocean/dots";

const authProvider = new DigitalOceanApiKeyAuthenticationProvider(process.env.DIGITALOCEAN_TOKEN!);
const adapter = new FetchRequestAdapter(authProvider);
const client = createDigitalOceanClient(adapter);

const response = await client.v2.insights.query
    .byRegion("nyc3").prom.api.v1.label
    .byName("__name__").values.get();

Response Example

Show Response Example
{
  "status": "success",
  "data": [
    "do_droplets_cpu_time",
    "do_droplets_memory_free"
  ]
}

More Information

See /v2/insights/query/{region}/prom/api/v1/label/{name}/values in the API reference for additional detail on responses, headers, parameters, and more.

We can't find any results for your search.

Try using different keywords or simplifying your search terms.