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

Parameter
Type
Description
In
Required
accountUuid
string

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.

path
required
startTime
string

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

query
optional
endTime
string

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

query
optional
eventType
string

The type of the requested events: cost or forecast.

If not set, all events are returned.

  • cost
  • forecast
  • budget
query
optional

Response

Response codes

Code
Type
Description
200

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

Element
Type
Description
environmentUuid
string

The UUID of the environment that raised the event.

capability
string

The subscription capability that raised the event.

date
string

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

createdAt
string

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

severity
string

The severity of the event.

message
string

The message from the event.

eventType
string

The type of event: forecast or usage.

notificationLevel
string

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"
  }
]