Extensions 2.0 API - PUT environment configuration
Activates the specified version of an Extensions 2.0 extension.
The request consumes and produces an application/json payload.
| PUT | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/environmentConfiguration |
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/environmentConfiguration | |
| Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/environmentConfiguration |
Authentication
To execute this request, you need Write extension environment configurations (extensionEnvironment.write) permission assigned to your API token. 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 | optional |
| body | Extension | 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 | Extension | Success. Environment configuration updated. |
| 400 | Error | Failed. The input is invalid. |
| 404 | Error | Failed. The requested resource doesn't exist. |
Response body objects
The ExtensionEnvironmentConfigurationVersion object
| Element | Type | Description | Required |
|---|---|---|---|
| version | string | Extension version | required |
Response body JSON model
{
"version": "1.2.3"
}