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

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.

PUTManaged 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 an access token with Write extension monitoring configurations (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
configurationIdstring

The ID of the requested monitoring configuration.

pathrequired
bodyMonitoringConfigurationUpdateDto

JSON body of the request, containing monitoring configuration parameters.

bodyrequired

Request body objects

The MonitoringConfigurationUpdateDto object

ElementTypeDescription
valueJsonNode

The monitoring configuration

Can be null.

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

CodeTypeDescription
200MonitoringConfigurationResponse

Success

400ErrorEnvelope

Failed. The input is invalid.

404ErrorEnvelope

Failed. The requested resource doesn't exist.

Response body objects

The MonitoringConfigurationResponse object

ElementTypeDescription
objectIdstring

The identifier of the new configuration

Can be null.

codeinteger

The HTTP Status code

Can be null.

Response body JSON model

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

    Learn about the extensions framework offered by Dynatrace.