• Home
  • Dynatrace API
  • Configuration
  • RUM
  • IP mapping headers
  • PUT configuration

IP mapping header rules - PUT configuration

Updates the list of IP detection headers.

The request consumes an application/json payload.

PUTManagedDynatrace for Governmenthttps://{your-domain}/e/{your-environment-id}/api/config/v1/geographicRegions/ipDetectionHeaders
SaaShttps://{your-environment-id}.live.dynatrace.com/api/config/v1/geographicRegions/ipDetectionHeaders
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/geographicRegions/ipDetectionHeaders

Authentication

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

To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
bodyIpDetectionHeaders

The JSON body of the request. Contains the configuration of the custom client IP headers.

bodyoptional

Request body objects

The IpDetectionHeaders object

Configuration of the custom client IP headers.

ElementTypeDescriptionRequired
ipDetectionHeadersstring[]

A list of custom client IP headers.

Headers are evaluated from top to bottom; the first matching header applies.

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
{ "ipDetectionHeaders": [ "string" ] }

Response

Response codes

CodeTypeDescription
204

Success. The configuration has been updated. Response doesn't have a body.

400ErrorEnvelope

Failed. The input is invalid

Validate payload

We recommend that you validate the payload before submitting it with an actual request. A response code of 204 indicates a valid payload.

The request consumes an application/json payload.

POSTManagedDynatrace for Governmenthttps://{your-domain}/e/{your-environment-id}/api/config/v1/geographicRegions/ipDetectionHeaders/validator
SaaShttps://{your-environment-id}.live.dynatrace.com/api/config/v1/geographicRegions/ipDetectionHeaders/validator
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/geographicRegions/ipDetectionHeaders/validator

Authentication

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

To learn how to obtain and use it, see Tokens and authentication.

Response

Response codes

CodeTypeDescription
204

Success. The submitted configuration is valid. Response doesn't have a body.

400ErrorEnvelope

Failed. The input is invalid

Related topics
  • Customize IP address detection for web applications

    Learn about the options offered by Dynatrace for customizing IP detection for your web applications.

  • Customize IP address detection for mobile applications

    Learn about the options offered by Dynatrace for customizing IP detection for your mobile applications.

  • Customize IP address detection for custom applications

    Learn about the options offered by Dynatrace for customizing IP detection for your custom applications.