Dynatrace Platform Subscription API - GET events

Lists cost and forecast events of a Dynatrace Platform Subscription detected by Account Management.

The request produces an application/json payload.

GET

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

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
startTimestring

The start of the requested timeframe in 2021-05-01T15:11:00Z format.

queryoptional
endTimestring

The end of the requested timeframe in 2021-05-01T15:11:00Z format.

queryoptional
eventTypestring

The type of the requested events: cost or forecast.

If not set, all events are returned.

  • cost
  • forecast
  • budget
queryoptional

Response

Response codes

CodeTypeDescription
200Event[]

Success. The response contains a list of the account's notifications.

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 ResponseBody object

The Event object

ElementTypeDescription
environmentUuidstring

The UUID of the environment that raised the event.

capabilitystring

The subscription capability that raised the event.

datestring

The time when the event was raised, in 2021-05-01T15:11:00Z format.

createdAtstring

The time when the notification was created, in 2021-05-01T15:11:00Z format.

severitystring

The severity of the event.

messagestring

The message from the event.

eventTypestring

The type of event: forecast or usage.

notificationLevelstring

The notification level of the event.

Response body JSON model

[
{
"environmentUuid": "string",
"capability": "string",
"date": "string",
"createdAt": "string",
"severity": "string",
"message": "string",
"eventType": "string",
"notificationLevel": "string"
}
]