Extensions 2.0 API - POST a monitoring configuration

Creates a new monitoring configuration for the specified Extensions 2.0 extension.

The request consumes and produces an application/json payload.

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

Authentication

To execute this request, you need an access token with extensionConfigurations.write scope.

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

JSON body of the request, containing monitoring configuration parameters.

body
required

Request body objects

The RequestBody object

The MonitoringConfigurationDto object

Element
Type
Description
Required
scope
string

The scope this monitoring configuration will be defined for

required
value

The monitoring configuration

optional

The JsonNode object

The monitoring configuration

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.

[
  {
    "scope": "HOST-D3A3C5A146830A79",
    "value": {}
  }
]

Response

Response codes

Code
Type
Description
200

Success

207

Multi-Status, if not all requests resulted in the same status

404

Failed. The requested resource doesn't exist.

4XX

Client side error.

5XX

Server side error.

Response body objects

The ResponseBody object

The MonitoringConfigurationResponse object

Element
Type
Description
code
integer

The HTTP Status code

objectId
string

The identifier of the new configuration

Response body JSON model

[
  {
    "code": 1,
    "objectId": "331e416f-9ab7-4694-8408-816026820645"
  }
]

Related topics