Extensions 2.0 API - POST environment configuration

Enables the specified Extensions 2.0 extension and simultaneously activates the specified environment configuration version.

The request consumes and produces an application/json payload.

POSTSaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/environmentConfiguration
Environment ActiveGateCluster ActiveGatehttps://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/extensions/{extensionName}/environmentConfiguration

Authentication

To execute this request, you need an access token with one of the following scopes:

  • extensionEnvironment.write
  • extensions.write

To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter
Type
Description
In
Required
extensionName
string

The name of the requested extension 2.0.

path
required
body

The version of the requested environment configuration.

body
required

Request body objects

The ExtensionEnvironmentConfigurationVersion object

Element
Type
Description
Required
version
string

Extension version

required

Request body JSON model

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

{
  "version": "1.2.3"
}

Response

Response codes

Code
Type
Description
200

Success. Environment configuration created.

400

Failed. The input is invalid.

404

Failed. The requested resource doesn't exist.

4XX

Client side error.

5XX

Server side error.

Response body objects

The ExtensionEnvironmentConfigurationVersion object

Element
Type
Description
version
string

Extension version

Response body JSON model

{
  "version": "1.2.3"
}

Related topics