Metric units API - GET all units

Lists all available metric units of your environment.

The request produces an application/json payload.

GETSaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/units
Environment ActiveGateCluster ActiveGatehttps://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/units

Authentication

To execute this request, you need an access token with metrics.read scope.

To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
unitSelectorstring

Selects units to be included to the response. Available criteria:

  • Compatibility: compatibleTo("unit","display-format"). Returns units that can be converted to the specified unit. The optional display format (binary or decimal) argument is supported by bit- and byte-based units and returns only units for the specified format.
queryoptional
fieldsstring

Defines the list of properties to be included in the response. The ID of the unit is always included. The following additional properties are available:

  • displayName: The display name of the unit.
  • symbol: The symbol of the unit.
  • description: A short description of the unit.

By default, the ID, the display name, and the symbol are included.

To add properties, list them with leading plus +. To exclude default properties, list them with leading minus -.

To specify several properties, join them with a comma (for example fields=+description,-symbol).

If you specify just one property, the response contains the unitId and the specified property. To return unit IDs only, specify unitId here.

queryoptional

Response

Response codes

CodeTypeDescription
200UnitList

Success

4XXErrorEnvelope

Client side error.

5XXErrorEnvelope

Server side error.

Response body objects

The UnitList object

A list of units along with their properties.

ElementTypeDescription
totalCountinteger

The total number of units in the result.

unitsUnit[]

A list of units.

The Unit object

The metadata of a unit.

ElementTypeDescription
descriptionstring

A short description of the unit.

displayNamestring

The display name of the unit.

displayNamePluralstring

The plural display name of the unit.

symbolstring

The symbol of the unit.

unitIdstring

The ID of the unit.

Response body JSON model

{
"totalCount": 2,
"units": [
{
"description": "byte per second",
"displayName": "byte per second",
"displayNamePlural": "bytes per second",
"symbol": "B/s",
"unitId": "BytePerSecond"
},
{
"description": "byte per minute",
"displayName": "byte per minute",
"displayNamePlural": "bytes per minute",
"symbol": "B/min",
"unitId": "BytePerMinute"
}
]
}

Example

In this example, the request lists all metric units available for the mySampleEnv environment.

The API token is passed in the Authorization header.

The result is truncated to three entries.

Curl

curl --request GET \
--url https://mySampleEnv.live.dynatrace.com/api/v2/units \
--header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

Request URL

https://mySampleEnv.live.dynatrace.com/api/v2/units

Response body

{
"totalCount": 3,
"activeGateTokens": [
{
"unitId": "Second",
"displayName": "second",
"symbol": "s"
},
{
"unitId": "GigaBit",
"displayName": "gigabit",
"symbol": "Gbit"
},
{
"unitId": "KiloBytePerSecond",
"displayName": "kilobyte per second",
"symbol": "kB/s"
}
]
}

Response code

200