Dynatrace Platform Subscription API - GET usage

Gets the aggregated usage data for a Dynatrace Platform Subscription.

The request produces an application/json payload.

GET

https://api.dynatrace.com/sub/v2/accounts/{accountUuid}/subscriptions/{subscriptionUuid}/usage

Authentication

To execute this request, you need the Allow read access for usage and consumption resources (account-uac-read) scope assigned to your token. To learn how to obtain and use it, see OAuth clients.

Parameters

ParameterTypeDescriptionInRequired
accountUuidstring

The ID of the required account.

You can find the UUID on the Account Management > Identity & access management > OAuth clients page, during creation of an OAuth client.

pathrequired
subscriptionUuidstring

The UUID of the requested subscription.

Fetch the list of subscriptions via the GET all subscriptions request.

pathrequired
environmentIdsstring[]

A list of environments for which you want to read the usage data. To specify several environments, separate them with a comma (,).

queryoptional
capabilityKeysstring[]

A list of capabilities for which you want to read the usage data. To specify several capabilities, separate them with a comma (,).

To obtain capability keys, use the GET subscriptions call and look for the capabilities field of the response.

queryoptional
clusterIdsstring[]

A list of Managed clusters for which you want to read the usage data.

Not applicable to SaaS environments.

queryoptional

Response

Response codes

CodeTypeDescription
200SubscriptionUsageListDto

Success. The response contains the usage data of the subscription, split by date.

400-

Failed. The request was unacceptable, often due to missing a required parameter

401-

Failed. The bearer token is incorrect/expired or the requested account information does not match the bearer token

403-

Access denied

404-

Failed. The requested resource was not found

500-

Failed. Something went wrong in Account Management API

Response body objects

The SubscriptionUsageListDto object

ElementTypeDescription
dataSubscriptionUsageDto[]

Usage data of the subscription.

lastModifiedTimestring

The time the subscription data was last modified in 2021-05-01T15:11:00Z format.

The SubscriptionUsageDto object

ElementTypeDescription
capabilityKeystring

The key of the subscription capability.

capabilityNamestring

The display name of the subscription capability.

startTimestring

The start time of the capability usage in 2021-05-01T15:11:00Z format.

endTimestring

The end time of the capability usage in 2021-05-01T15:11:00Z format.

valuenumber

The subscription usage by the capability.

unitMeasurestring

The unit of the capability usage.

Response body JSON model

{
"data": [
{
"capabilityKey": "string",
"capabilityName": "string",
"startTime": "string",
"endTime": "string",
"value": 1,
"unitMeasure": "string"
}
],
"lastModifiedTime": "string"
}