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`

Retrieve schema via Settings API

GET	Managed	`https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:custom-unit`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:custom-unit`
	Environment ActiveGate	`https://{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	Label	Type	Description	Required
newUnitName	Unit name	text	Unit name has to be unique and is used as identifier. E.g: Byte, Second, BytePerMinute	required
newUnitPluralName	Unit plural name	text	Unit plural name represent the plural form of the unit name. E.g: Bytes, Seconds	required
newUnitSymbol	Unit symbol	text	Unit symbol has to be unique. E.g: s, m/s, B/min, bit/s	required
newUnitDescription	Unit description	text	Unit description should provide additional information about the new unit E.g: Byte: 8 bits of information	required