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.

POST	Managed	`https://{your-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/monitoringConfigurations`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations`

Authentication

To execute this request, you need Write extension monitoring configurations (extensionConfigurations.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	required
body	MonitoringConfigurationDto[]	JSON body of the request, containing monitoring configuration parameters.	body	required

Request body objects

The `MonitoringConfigurationDto` object

Element	Type	Description	Required
scope	string	The scope this monitoring configuration will be defined for	required
value	JsonNode	The monitoring configuration	optional

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

Code	Type	Description
200	MonitoringConfigurationResponse[]	Success
207	string[]	Multi-Status, if not all requests resulted in the same status
404	ErrorEnvelope	Failed. The requested resource doesn't exist.

Response body objects

The `MonitoringConfigurationResponse` object

Element	Type	Description	Required
objectId	string	The identifier of the new configuration	optional
code	integer	The HTTP Status code	optional

Response body JSON model

json
[
  {
    "objectId": "Y2ktaGdyb3VwLTEyMythZjhjOThlOS0wN2I0LTMyMGEtOTQzNi02NTEyMmVlNWY4NGQ=",
    "code": 1
  }
]