All Products
Search
Document Center

Time Series Database:Query TagValue of a TagKey

Last Updated:Mar 28, 2026

Queries the TagValues associated with a specified TagKey, with optional prefix filtering on the returned results.

Endpoint

PathMethod
/api/dump_metaPOST

Request parameters

ParameterTypeRequiredDescriptionDefault value
tagkeyStringYesThe TagKey to query.None
tagvalueprefixStringYesA prefix filter applied to the returned TagValues. Only TagValues that begin with this string are returned.None
maxIntegerNoThe maximum number of results to return.1000

Example

The following example queries up to two TagValues for the TagKey host, returning only values that start with 127.0.0.

Request:

POST /api/dump_meta

Body:

{
  "tagkey": "host",
  "tagvalueprefix": "127.0.0",
  "max": 2
}

Response:

[{"host": "127.0.0.1"}, {"host": "127.0.0.2"}]

Response description

The response is an array of tag key-value pairs. Each element is a JSON object with the TagKey as the key and the matching TagValue as the value.