Extensions 2.0 API - PUT a monitoring configuration

Updates the specified monitoring configuration 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}/monitoringConfigurations/{configurationId}`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}`

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	optional
configurationId	string	The ID of the requested monitoring configuration.	path	optional
body	MonitoringConfigurationUpdateDto	JSON body of the request, containing monitoring configuration parameters.	body	required

Request body objects

The `MonitoringConfigurationUpdateDto` object

Element	Type	Description	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
{
  "value": {}
}

Response

Response codes

Code	Type	Description
200	MonitoringConfigurationResponse	Success
400	ErrorEnvelope	Failed. The input is invalid.
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
}