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	Environment	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} Can be `null`.
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). Can be `null`.
state	string	Indicates whether the environment is enabled or disabled. The default value is ENABLED. The element can hold these values `DISABLED` `ENABLED` Can be `null`.
tags	string[]	A set of tags that are assigned to this environment. Every tag can have a maximum length of 100 characters. Can be `null`.
creationDate	string	The creation date of the environment in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS'Z') Can be `null`.
quotas	EnvironmentQuotas	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. Can be `null`.
storage	EnvironmentStorage	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. Can be `null`.

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	HostUnitQuota	Host units consumption and quota information on environment level. If skipped when editing via PUT method then already set quota will remain. Can be `null`.
demUnits	DemUnitsQuota	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. Can be `null`.
userSessions	UserSessionsQuota	User sessions consumption and quota information on environment level. If skipped when editing via PUT method then already set quotas will remain. Can be `null`.
sessionProperties	SessionPropertiesQuota	User session properties consumption information on environment level. Can be `null`.
syntheticMonitors	SyntheticQuota	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. Can be `null`.
customMetrics	CustomMetricsQuota	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. Can be `null`.
davisDataUnits	DavisDataUnitsQuota	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. Can be `null`.
logMonitoring	LogMonitoringQuota	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. Can be `null`.

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

Element	Type	Description
currentUsage	number	Current environment usage. Can be `null`.
maxLimit	integer	Concurrent environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited. Can be `null`.

Current environment usage.

Can be null.

maxLimit

integer

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

Can be null.

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. Can be `null`.
consumedThisYear	number	Yearly environment consumption. Resets each year on license creation date anniversary. Can be `null`.
monthlyLimit	integer	Monthly environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited. Can be `null`.
annualLimit	integer	Annual environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited. Can be `null`.

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. Can be `null`.
consumedUserSessionsWithWebSessionReplayThisMonth	number	Monthly Web user sessions with replay environment consumption. Resets each calendar month. Can be `null`.
consumedUserSessionsWithMobileSessionReplayThisMonth	number	Monthly Mobile user sessions with replay environment consumption. Resets each calendar month. Can be `null`.
totalAnnualLimit	integer	Annual total User sessions environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited. Can be `null`.
totalConsumedThisMonth	number	Monthly total User sessions environment consumption. Resets each calendar month. Can be `null`.
totalConsumedThisYear	number	Yearly total User sessions environment consumption. Resets each year on license creation date anniversary. Can be `null`.
totalMonthlyLimit	integer	Monthly total User sessions environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited. Can be `null`.
consumedUserSessionsWithWebSessionReplayThisYear	number	Yearly Web user sessions with replay environment consumption. Resets each year on license creation date anniversary. Can be `null`.
consumedMobileSessionsThisMonth	number	Monthly Mobile user sessions environment consumption. Resets each calendar month. Can be `null`.
consumedMobileSessionsThisYear	number	Yearly Mobile user sessions environment consumption. Resets each year on license creation date anniversary. Can be `null`.

The `SessionPropertiesQuota` object

User session properties consumption information on environment level.

Element Type Description

consumedThisMonth

number

Monthly environment consumption. Resets each calendar month.

Can be null.

consumedThisYear

number

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

Can be null.

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. Can be `null`.
consumedThisYear	number	Yearly environment consumption. Resets each year on license creation date anniversary. Can be `null`.
monthlyLimit	integer	Monthly environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited. Can be `null`.
annualLimit	integer	Annual environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited. Can be `null`.

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

Element	Type	Description
currentUsage	number	Current environment usage. Can be `null`.
maxLimit	integer	Concurrent environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited. Can be `null`.

Current environment usage.

Can be null.

maxLimit

integer

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

Can be null.

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. Can be `null`.
consumedThisYear	number	Yearly environment consumption. Resets each year on license creation date anniversary. Can be `null`.
monthlyLimit	integer	Monthly environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited. Can be `null`.
annualLimit	integer	Annual environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited. Can be `null`.

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. Can be `null`.
consumedThisYear	number	Yearly environment consumption. Resets each year on license creation date anniversary. Can be `null`.
monthlyLimit	integer	Monthly environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited. Can be `null`.
annualLimit	integer	Annual environment quota. Not set if unlimited. When updating via PUT method, skipping this field will set quota unlimited. Can be `null`.

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	TransactionStorage	Transaction storage usage and limit information on environment level. If skipped when editing via PUT method then already set limit will remain. Can be `null`.
sessionReplayStorage	SessionReplayStorage	Session replay storage usage and limit information on environment level. If skipped when editing via PUT method then already set limit will remain. Can be `null`.
symbolFilesFromMobileApps	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. Can be `null`.
logMonitoringStorage	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. Can be `null`.
serviceRequestLevelRetention	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. Can be `null`.
serviceCodeLevelRetention	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. Can be `null`.
realUserMonitoringRetention	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. Can be `null`.
syntheticMonitoringRetention	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. Can be `null`.
sessionReplayRetention	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. Can be `null`.
logMonitoringRetention	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. Can be `null`.
userActionsPerMinute	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. Can be `null`.
transactionTrafficQuota	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. Can be `null`.

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. Can be `null`.
retentionReductionReason	string	Reason of truncation. Can be `null`.
maxLimit	integer	Maximum storage limit [bytes] Can be `null`.
currentlyUsed	integer	Currently used storage [bytes] Can be `null`.

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. Can be `null`.
retentionReductionReason	string	Reason of truncation. Can be `null`.
maxLimit	integer	Maximum storage limit [bytes] Can be `null`.
currentlyUsed	integer	Currently used storage [bytes] Can be `null`.

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

Element	Type	Description
maxLimit	integer	Maximum storage limit [bytes] Can be `null`.
currentlyUsed	integer	Currently used storage [bytes] Can be `null`.

Maximum storage limit [bytes]

Can be null.

currentlyUsed

integer

Currently used storage [bytes]

Can be null.

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

Element	Type	Description
maxLimit	integer	Maximum storage limit [bytes] Can be `null`.
currentlyUsed	integer	Currently used storage [bytes] Can be `null`.

Maximum storage limit [bytes]

Can be null.

currentlyUsed

integer

Currently used storage [bytes]

Can be null.

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

Element	Type	Description
maxLimitInDays	integer	Maximum retention limit [days] Can be `null`.
currentlyUsedInMillis	integer	Current data age [milliseconds] Can be `null`.
currentlyUsedInDays	integer	Current data age [days] Can be `null`.

Maximum retention limit [days]

Can be null.

currentlyUsedInMillis

integer

Current data age [milliseconds]

Can be null.

currentlyUsedInDays

integer

Current data age [days]

Can be null.

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

Element	Type	Description
maxLimitInDays	integer	Maximum retention limit [days] Can be `null`.
currentlyUsedInMillis	integer	Current data age [milliseconds] Can be `null`.
currentlyUsedInDays	integer	Current data age [days] Can be `null`.

Maximum retention limit [days]

Can be null.

currentlyUsedInMillis

integer

Current data age [milliseconds]

Can be null.

currentlyUsedInDays

integer

Current data age [days]

Can be null.

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

Element	Type	Description
maxLimitInDays	integer	Maximum retention limit [days] Can be `null`.
currentlyUsedInMillis	integer	Current data age [milliseconds] Can be `null`.
currentlyUsedInDays	integer	Current data age [days] Can be `null`.

Maximum retention limit [days]

Can be null.

currentlyUsedInMillis

integer

Current data age [milliseconds]

Can be null.

currentlyUsedInDays

integer

Current data age [days]

Can be null.

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

Element	Type	Description
maxLimitInDays	integer	Maximum retention limit [days] Can be `null`.
currentlyUsedInMillis	integer	Current data age [milliseconds] Can be `null`.
currentlyUsedInDays	integer	Current data age [days] Can be `null`.

Maximum retention limit [days]

Can be null.

currentlyUsedInMillis

integer

Current data age [milliseconds]

Can be null.

currentlyUsedInDays

integer

Current data age [days]

Can be null.

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

Element	Type	Description
maxLimitInDays	integer	Maximum retention limit [days] Can be `null`.
currentlyUsedInMillis	integer	Current data age [milliseconds] Can be `null`.
currentlyUsedInDays	integer	Current data age [days] Can be `null`.

Maximum retention limit [days]

Can be null.

currentlyUsedInMillis

integer

Current data age [milliseconds]

Can be null.

currentlyUsedInDays

integer

Current data age [days]

Can be null.

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

Element	Type	Description
maxLimitInDays	integer	Maximum retention limit [days] Can be `null`.
currentlyUsedInMillis	integer	Current data age [milliseconds] Can be `null`.
currentlyUsedInDays	integer	Current data age [days] Can be `null`.

Maximum retention limit [days]

Can be null.

currentlyUsedInMillis

integer

Current data age [milliseconds]

Can be null.

currentlyUsedInDays

integer

Current data age [days]

Can be null.

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

Element	Type	Description
maxLimit	integer	Maximum traffic [units per minute] Can be `null`.

Maximum traffic [units per minute]

Can be null.

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

Element	Type	Description
maxLimit	integer	Maximum traffic [units per minute] Can be `null`.

Maximum traffic [units per minute]

Can be null.

Response body JSON model

json
{
  "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

shell
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

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

Response body

json
{
  "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

List properties for specific environment

Authentication

Endpoint

Parameter

Response

Response codes

Response body objects

The Environment object

The EnvironmentQuotas object

The HostUnitQuota object

The DemUnitsQuota object

The UserSessionsQuota object

The SessionPropertiesQuota object

The SyntheticQuota object

The CustomMetricsQuota object

The DavisDataUnitsQuota object

The LogMonitoringQuota object

The EnvironmentStorage object

The TransactionStorage object

The SessionReplayStorage object

The SymbolFilesFromMobileApps object

The LogMonitoringStorage object

The ServiceRequestLevelRetention object

The ServiceCodeLevelRetention object

The RealUserMonitoringRetention object

The SyntheticMonitoringRetention object

The SessionReplayRetention object

The LogMonitoringRetention object

The UserActionsPerMinute object

The TransactionTrafficQuota object

Response body JSON model

Example

Curl

Request URL

Response body

Response code

The `Environment` object

The `EnvironmentQuotas` object

The `HostUnitQuota` object

The `DemUnitsQuota` object

The `UserSessionsQuota` object

The `SessionPropertiesQuota` object

The `SyntheticQuota` object

The `CustomMetricsQuota` object

The `DavisDataUnitsQuota` object

The `LogMonitoringQuota` object

The `EnvironmentStorage` object

The `TransactionStorage` object

The `SessionReplayStorage` object

The `SymbolFilesFromMobileApps` object

The `LogMonitoringStorage` object

The `ServiceRequestLevelRetention` object

The `ServiceCodeLevelRetention` object

The `RealUserMonitoringRetention` object

The `SyntheticMonitoringRetention` object

The `SessionReplayRetention` object

The `LogMonitoringRetention` object

The `UserActionsPerMinute` object

The `TransactionTrafficQuota` object