List properties for specific environment

This API call gets the properties of a specified environment.

Authentication

To execute this request, you need the Service Provider API (ServiceProviderAPI) permission assigned to your API token. Generate your API token via Cluster Management Console (CMC). To learn how to obtain and use it, see Cluster API - Authentication.

Endpoint

/api/cluster/v2/environments

Parameter

Parameter
Type
Description
In
Required
id
string

The ID of the environment.

path
required
includeConsumptionInfo
boolean

If true, consumption information (limits, usage) is returned for this environment.

Returned usage is typically up to 1 hour old. To obtain fresher data, you can use includeUncachedConsumptionInfo parameter instead.

query
optional
includeStorageInfo
boolean

If true, storage information (limits, usage) is returned for this environment.

query
optional
includeUncachedConsumptionInfo
boolean

If true, uncached consumption information (limits, usage) is returned for this environment.

Up to date consumption will be calculated. If both this parameter and includeConsumptionInfo are set, includeUncachedConsumptionInfo will take priority.

query
optional

Response

Response codes

Code
Type
Description
200

Successful operation.

Response body objects

The Environment object

Basic configuration for an environment.

Element
Type
Description
name
string

The display name of the environment.

id
string

The ID of the environment. Has to match [a-zA-Z0-9_-]{1,70}

trial
boolean

Specifies whether the environment is a trial environment or a non-trial environment. Creating a trial environment is only possible if your license allows that. The default value is false (non-trial).

state
string

Indicates whether the environment is enabled or disabled. The default value is ENABLED.

  • DISABLED
  • ENABLED
tags
string[]

A set of tags that are assigned to this environment. Every tag can have a maximum length of 100 characters.

creationDate
string

The creation date of the environment in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

quotas

Environment level consumption and quotas information. Only returned if includeConsumptionInfo or includeUncachedConsumptionInfo param is true. If skipped when editing via PUT method then already set quotas will remain.

storage

Environment level storage usage and limit information. Not returned if includeStorageInfo param is not true. If skipped when editing via PUT method then already set limits will remain.

The EnvironmentQuotas object

Environment level consumption and quotas information. Only returned if includeConsumptionInfo or includeUncachedConsumptionInfo param is true. If skipped when editing via PUT method then already set quotas will remain.

Element
Type
Description
hostUnits

Host units consumption and quota information on environment level. If skipped when editing via PUT method then already set quota will remain.

demUnits

DEM units consumption and quota information on environment level. Not set (and not editable) if DEM units is not enabled. If skipped when editing via PUT method then already set quotas will remain.

userSessions

User sessions consumption and quota information on environment level. If skipped when editing via PUT method then already set quotas will remain.

sessionProperties

User session properties consumption information on environment level.

syntheticMonitors

Synthetic monitors consumption and quota information on environment level. Not set (and not editable) if neither Synthetic nor DEM units is enabled. If skipped when editing via PUT method then already set quotas will remain.

customMetrics

Custom metrics consumption and quota information on environment level. Not set (and not editable) if Custom metrics is not enabled. Not set (and not editable) if Davis data units is enabled. If skipped when editing via PUT method then already set quota will remain.

davisDataUnits

Davis data units consumption and quota information on environment level. Not set (and not editable) if Davis data units is not enabled. If skipped when editing via PUT method then already set quotas will remain.

logMonitoring

Log monitoring consumption and quota information on environment level. Not set (and not editable) if Log monitoring is not enabled. Not set (and not editable) if Log monitoring is migrated to Davis data on license level. If skipped when editing via PUT method then already set quotas will remain.

The HostUnitQuota object

Host units consumption and quota information on environment level. If skipped when editing via PUT method then already set quota will remain.

Element
Type
Description
currentUsage
number

Current environment usage.

maxLimit
integer

Concurrent environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited.

The DemUnitsQuota object

DEM units consumption and quota information on environment level. Not set (and not editable) if DEM units is not enabled. If skipped when editing via PUT method then already set quotas will remain.

Element
Type
Description
consumedThisMonth
number

Monthly environment consumption. Resets each calendar month.

consumedThisYear
number

Yearly environment consumption. Resets each year on license creation date anniversary.

monthlyLimit
integer

Monthly environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited.

annualLimit
integer

Annual environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited.

The UserSessionsQuota object

User sessions consumption and quota information on environment level. If skipped when editing via PUT method then already set quotas will remain.

Element
Type
Description
consumedUserSessionsWithMobileSessionReplayThisYear
number

Yearly Mobile user sessions with replay environment consumption. Resets each year on license creation date anniversary.

consumedUserSessionsWithWebSessionReplayThisMonth
number

Monthly Web user sessions with replay environment consumption. Resets each calendar month.

consumedUserSessionsWithMobileSessionReplayThisMonth
number

Monthly Mobile user sessions with replay environment consumption. Resets each calendar month.

totalAnnualLimit
integer

Annual total User sessions environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited.

totalConsumedThisMonth
number

Monthly total User sessions environment consumption. Resets each calendar month.

totalConsumedThisYear
number

Yearly total User sessions environment consumption. Resets each year on license creation date anniversary.

totalMonthlyLimit
integer

Monthly total User sessions environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited.

consumedUserSessionsWithWebSessionReplayThisYear
number

Yearly Web user sessions with replay environment consumption. Resets each year on license creation date anniversary.

consumedMobileSessionsThisMonth
number

Monthly Mobile user sessions environment consumption. Resets each calendar month.

consumedMobileSessionsThisYear
number

Yearly Mobile user sessions environment consumption. Resets each year on license creation date anniversary.

The SessionPropertiesQuota object

User session properties consumption information on environment level.

Element
Type
Description
consumedThisMonth
number

Monthly environment consumption. Resets each calendar month.

consumedThisYear
number

Yearly environment consumption. Resets each year on license creation date anniversary.

The SyntheticQuota object

Synthetic monitors consumption and quota information on environment level. Not set (and not editable) if neither Synthetic nor DEM units is enabled. If skipped when editing via PUT method then already set quotas will remain.

Element
Type
Description
consumedThisMonth
number

Monthly environment consumption. Resets each calendar month.

consumedThisYear
number

Yearly environment consumption. Resets each year on license creation date anniversary.

monthlyLimit
integer

Monthly environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited.

annualLimit
integer

Annual environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited.

The CustomMetricsQuota object

Custom metrics consumption and quota information on environment level. Not set (and not editable) if Custom metrics is not enabled. Not set (and not editable) if Davis data units is enabled. If skipped when editing via PUT method then already set quota will remain.

Element
Type
Description
currentUsage
number

Current environment usage.

maxLimit
integer

Concurrent environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited.

The DavisDataUnitsQuota object

Davis data units consumption and quota information on environment level. Not set (and not editable) if Davis data units is not enabled. If skipped when editing via PUT method then already set quotas will remain.

Element
Type
Description
consumedThisMonth
number

Monthly environment consumption. Resets each calendar month.

consumedThisYear
number

Yearly environment consumption. Resets each year on license creation date anniversary.

monthlyLimit
integer

Monthly environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited.

annualLimit
integer

Annual environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited.

The LogMonitoringQuota object

Log monitoring consumption and quota information on environment level. Not set (and not editable) if Log monitoring is not enabled. Not set (and not editable) if Log monitoring is migrated to Davis data on license level. If skipped when editing via PUT method then already set quotas will remain.

Element
Type
Description
consumedThisMonth
number

Monthly environment consumption. Resets each calendar month.

consumedThisYear
number

Yearly environment consumption. Resets each year on license creation date anniversary.

monthlyLimit
integer

Monthly environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited.

annualLimit
integer

Annual environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited.

The EnvironmentStorage object

Environment level storage usage and limit information. Not returned if includeStorageInfo param is not true. If skipped when editing via PUT method then already set limits will remain.

Element
Type
Description
transactionStorage

Transaction storage usage and limit information on environment level. If skipped when editing via PUT method then already set limit will remain.

sessionReplayStorage

Session replay storage usage and limit information on environment level. If skipped when editing via PUT method then already set limit will remain.

symbolFilesFromMobileApps

Symbol files from mobile apps storage usage and limit information on environment level. If skipped when editing via PUT method then already set limit will remain.

logMonitoringStorage

Log monitoring storage usage and limit information on environment level. Not editable when Log monitoring is not allowed by license or not configured on cluster level. If skipped when editing via PUT method then already set limit will remain.

serviceRequestLevelRetention

Service request level retention settings on environment level. Service code level retention time can't be greater than service request level retention time and both can't exceed one year.If skipped when editing via PUT method then already set limit will remain.

serviceCodeLevelRetention

Service code level retention settings on environment level. Service code level retention time can't be greater than service request level retention time and both can't exceed one year.If skipped when editing via PUT method then already set limit will remain.

realUserMonitoringRetention

Real user monitoring retention settings on environment level. Can be set to any value from 1 to 35 days. If skipped when editing via PUT method then already set limit will remain.

syntheticMonitoringRetention

Synthetic monitoring retention settings on environment level. Can be set to any value from 1 to 35 days. If skipped when editing via PUT method then already set limit will remain.

sessionReplayRetention

Session replay retention settings on environment level. Can be set to any value from 1 to 35 days. If skipped when editing via PUT method then already set limit will remain.

logMonitoringRetention

Log monitoring retention settings on environment level. Not editable when Log monitoring is not allowed by license or not configured on cluster level. Can be set to any value from 5 to 90 days. If skipped when editing via PUT method then already set limit will remain.

userActionsPerMinute

Maximum number of user actions generated per minute on environment level. Can be set to any value from 1 to 2147483646 or left unlimited. If skipped when editing via PUT method then already set limit will remain.

transactionTrafficQuota

Maximum number of newly monitored entry point PurePaths captured per process/minute on environment level. Can be set to any value from 100 to 100000. If skipped when editing via PUT method then already set limit will remain.

The TransactionStorage object

Transaction storage usage and limit information on environment level. If skipped when editing via PUT method then already set limit will remain.

Element
Type
Description
retentionReductionPercentage
string

Percentage of truncation for new data.

retentionReductionReason
string

Reason of truncation.

maxLimit
integer

Maximum storage limit [bytes]

currentlyUsed
integer

Currently used storage [bytes]

The SessionReplayStorage object

Session replay storage usage and limit information on environment level. If skipped when editing via PUT method then already set limit will remain.

Element
Type
Description
retentionReductionPercentage
string

Percentage of truncation for new data.

retentionReductionReason
string

Reason of truncation.

maxLimit
integer

Maximum storage limit [bytes]

currentlyUsed
integer

Currently used storage [bytes]

The SymbolFilesFromMobileApps object

Symbol files from mobile apps storage usage and limit information on environment level. If skipped when editing via PUT method then already set limit will remain.

Element
Type
Description
maxLimit
integer

Maximum storage limit [bytes]

currentlyUsed
integer

Currently used storage [bytes]

The LogMonitoringStorage object

Log monitoring storage usage and limit information on environment level. Not editable when Log monitoring is not allowed by license or not configured on cluster level. If skipped when editing via PUT method then already set limit will remain.

Element
Type
Description
maxLimit
integer

Maximum storage limit [bytes]

currentlyUsed
integer

Currently used storage [bytes]

The ServiceRequestLevelRetention object

Service request level retention settings on environment level. Service code level retention time can't be greater than service request level retention time and both can't exceed one year.If skipped when editing via PUT method then already set limit will remain.

Element
Type
Description
maxLimitInDays
integer

Maximum retention limit [days]

currentlyUsedInMillis
integer

Current data age [milliseconds]

currentlyUsedInDays
integer

Current data age [days]

The ServiceCodeLevelRetention object

Service code level retention settings on environment level. Service code level retention time can't be greater than service request level retention time and both can't exceed one year.If skipped when editing via PUT method then already set limit will remain.

Element
Type
Description
maxLimitInDays
integer

Maximum retention limit [days]

currentlyUsedInMillis
integer

Current data age [milliseconds]

currentlyUsedInDays
integer

Current data age [days]

The RealUserMonitoringRetention object

Real user monitoring retention settings on environment level. Can be set to any value from 1 to 35 days. If skipped when editing via PUT method then already set limit will remain.

Element
Type
Description
maxLimitInDays
integer

Maximum retention limit [days]

currentlyUsedInMillis
integer

Current data age [milliseconds]

currentlyUsedInDays
integer

Current data age [days]

The SyntheticMonitoringRetention object

Synthetic monitoring retention settings on environment level. Can be set to any value from 1 to 35 days. If skipped when editing via PUT method then already set limit will remain.

Element
Type
Description
maxLimitInDays
integer

Maximum retention limit [days]

currentlyUsedInMillis
integer

Current data age [milliseconds]

currentlyUsedInDays
integer

Current data age [days]

The SessionReplayRetention object

Session replay retention settings on environment level. Can be set to any value from 1 to 35 days. If skipped when editing via PUT method then already set limit will remain.

Element
Type
Description
maxLimitInDays
integer

Maximum retention limit [days]

currentlyUsedInMillis
integer

Current data age [milliseconds]

currentlyUsedInDays
integer

Current data age [days]

The LogMonitoringRetention object

Log monitoring retention settings on environment level. Not editable when Log monitoring is not allowed by license or not configured on cluster level. Can be set to any value from 5 to 90 days. If skipped when editing via PUT method then already set limit will remain.

Element
Type
Description
maxLimitInDays
integer

Maximum retention limit [days]

currentlyUsedInMillis
integer

Current data age [milliseconds]

currentlyUsedInDays
integer

Current data age [days]

The UserActionsPerMinute object

Maximum number of user actions generated per minute on environment level. Can be set to any value from 1 to 2147483646 or left unlimited. If skipped when editing via PUT method then already set limit will remain.

Element
Type
Description
maxLimit
integer

Maximum traffic [units per minute]

The TransactionTrafficQuota object

Maximum number of newly monitored entry point PurePaths captured per process/minute on environment level. Can be set to any value from 100 to 100000. If skipped when editing via PUT method then already set limit will remain.

Element
Type
Description
maxLimit
integer

Maximum traffic [units per minute]

Response body JSON model

{
  "name": "example environment",
  "state": "ENABLED",
  "tags": [
    "tag1",
    "tag2"
  ],
  "trial": false
}

Example

Finds the environment with identifier be22c776-1414-43f3-b39b-32e7bddcb0a3 and includes consumption data.

Curl

curl -X GET "https://myManaged.cluster.com/api/cluster/v2/environments/19a963a7-b19f-4382-964a-4df674c8eb8e?includeConsumptionInfo=true" -H "accept: application/json; charset=utf-8" -H "Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890"

Request URL

https://myManaged.cluster.com/api/cluster/v2/environments/19a963a7-b19f-4382-964a-4df674c8eb8e?includeConsumptionInfo=true

Response body

{
  "name": "MyNewTeam",
  "id": "19a963a7-b19f-4382-964a-4df674c8eb8e",
  "trial": false,
  "state": "ENABLED",
  "tags": [
    "owner:john.wicked@dynatrace.com",
    "department:finance"
  ],
  "creationDate": "2021-03-09T08:43:32.496Z",
  "quotas": {
    "hostUnits": {
      "maxLimit": null,
      "currentUsage": 0
    },
    "demUnits": {
      "monthlyLimit": null,
      "annualLimit": null,
      "consumedThisMonth": 0,
      "consumedThisYear": 0
    },
    "userSessions": {
      "totalMonthlyLimit": null,
      "totalAnnualLimit": null,
      "totalConsumedThisMonth": 0,
      "totalConsumedThisYear": 0,
      "consumedMobileSessionsThisMonth": 0,
      "consumedMobileSessionsThisYear": 0,
      "consumedUserSessionsWithWebSessionReplayThisMonth": 0,
      "consumedUserSessionsWithWebSessionReplayThisYear": 0,
      "consumedUserSessionsWithMobileSessionReplayThisMonth": 0,
      "consumedUserSessionsWithMobileSessionReplayThisYear": 0
    },
    "sessionProperties": {
      "consumedThisMonth": 0,
      "consumedThisYear": 0
    },
    "syntheticMonitors": {
      "monthlyLimit": null,
      "annualLimit": null,
      "consumedThisMonth": 0,
      "consumedThisYear": 0
    },
    "customMetrics": null,
    "davisDataUnits": {
      "monthlyLimit": null,
      "annualLimit": null,
      "consumedThisMonth": 0,
      "consumedThisYear": 0
    },
    "logMonitoring": null
  }
}

Response code

200