• Home
  • Dynatrace API
  • Environment
  • Extensions 2.0
  • Monitoring configurations
  • POST a monitoring configuration

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.

POSTManagedDynatrace for Governmenthttps://{your-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/monitoringConfigurations
Environment ActiveGatehttps://{your-activegate-domain}/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

ParameterTypeDescriptionInRequired
extensionNamestring

The name of the requested extension 2.0.

pathrequired
bodyMonitoringConfigurationDto[]

JSON body of the request, containing monitoring configuration parameters.

bodyrequired

Request body objects

The RequestBody object

The object doesn't provide any parameters.

The MonitoringConfigurationDto object

ElementTypeDescriptionRequired
scopestring

The scope this monitoring configuration will be defined for

required
valueJsonNode

The monitoring configuration

optional

The JsonNode object

The monitoring configuration

The object doesn't provide any parameters.

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.

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

Response

Response codes

CodeTypeDescription
200MonitoringConfigurationResponse[]

Success

207MonitoringConfigurationResponse

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

404ErrorEnvelope

Failed. The requested resource doesn't exist.

Response body objects

The ResponseBody object

The object doesn't provide any parameters.

The MonitoringConfigurationResponse object

ElementTypeDescription
objectIdstring

The identifier of the new configuration

codeinteger

The HTTP Status code

Response body JSON model

json
[ { "objectId": "Y2ktaGdyb3VwLTEyMythZjhjOThlOS0wN2I0LTMyMGEtOTQzNi02NTEyMmVlNWY4NGQ=", "code": 1 } ]
Related topics
  • Extensions

    Learn about the extensions framework offered by Dynatrace.