Retrieve the active environment configuration version for an Extension 2.0 in Dynatrace with the Extensions API by extension name.
| GET | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/extensions/v2/extensions/{extension-name}/environment-configuration |
You provide the extension-name path parameter to identify the Extension 2.0, and you can use add-fields to include additional response fields. Dynatrace returns the active environment configuration version for that extension.
To execute this request, you need a platform token or OAuth access token with extensions:definitions:read scope. To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| extension-name | string | The name of the requested Extension 2.0. | path | Required |
| add-fields | string | Comma separated list of additional fields to include in the response. Available fields:
| query | Optional |
| Code | Type | Description |
|---|---|---|
| 200 | Environment | Success. |
| 4XX | Error | Client error. |
| 5XX | Error | Server error. |
EnvironmentConfiguration objectList of assets imported with the active extension environment configuration.
| Element | Type | Description |
|---|---|---|
| assets | Asset | The list of the imported assets. |
| errors | string[] | List of errors during asset import |
| status | string | The status of the assets list. The element can hold these values
|
| version | string | Version of the active extension environment configuration. |
AssetInfo objectMetadata for an extension asset.
| Element | Type | Description |
|---|---|---|
| assetSchemaDetails | Asset | Settings schema details for asset |
| displayName | string | User-friendly name of the asset. |
| id | string | ID of the asset. Identifies the asset in REST API and/or UI (where applicable). |
| type | string | The type of the asset. The element can hold these values
|
AssetSchemaDetails objectSettings schema details for asset
| Element | Type | Description |
|---|---|---|
| key | string | Asset key |
| schemaId | string | Asset schema id |
| scope | string | Asset configuration scope |
ErrorEnvelope object| Element | Type | Description |
|---|---|---|
| error | Error | - |
Error object| Element | Type | Description |
|---|---|---|
| code | integer | The HTTP status code. |
| details | Error | The error details. |
| message | string | The error message. |
ErrorDetails objectThe error details.
| Element | Type | Description |
|---|---|---|
| constraintViolations | Constraint | A list of constraint violations. |
ConstraintViolation objectA list of constraint violations.
| Element | Type | Description |
|---|---|---|
| location | string | - |
| message | string | - |
| parameterLocation | string | -The element can hold these values
|
| path | string | - |
{"assets": [{"assetSchemaDetails": {"key": "string","schemaId": "string","scope": "string"},"displayName": "string","id": "string","type": "ALERT"}],"errors": ["string"],"status": "PENDING","version": "1.2.3"}
{"error": {"code": 1,"details": {"constraintViolations": [{"location": "string","message": "string","parameterLocation": "HEADER","path": "string"}]},"message": "string"}}