Settings API - Custom units schema table

Custom units (builtin:custom-unit)

Here you can create custom units.

Schema ID
Schema groups
Scope
builtin:custom-unit
  • group:metrics
environment
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:custom-unit
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:custom-unit
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:custom-unit

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Property
Type
Description
Required
Unit name
newUnitName
text

Unit name has to be unique and is used as identifier.

E.g: Byte, Second, BytePerMinute

required
Unit plural name
newUnitPluralName
text

Unit plural name represent the plural form of the unit name.

E.g: Bytes, Seconds

required
Unit symbol
newUnitSymbol
text

Unit symbol has to be unique.

E.g: s, m/s, B/min, bit/s

required
Unit description
newUnitDescription
text

Unit description should provide additional information about the new unit

E.g: Byte: 8 bits of information

required