Dynatrace Platform Subscription API - GET events

Latest Dynatrace
Reference
Published Aug 30, 2023

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