• Home
  • Dynatrace API
  • Configuration
  • RUM
  • IP address mapping rules
  • PUT configuration

IP address mapping rules - PUT configuration

Updates the configuration of mapping between IP addresses and geographic regions.

The request consumes an application/json payload.

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

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
bodyIpAddressMappings

The JSON body of the request. Contains the configuration of the IP address mapping.

bodyoptional

Request body objects

The IpAddressMappings object

Configuration of the IP address mappings to geographic locations.

ElementTypeDescriptionRequired
ipAddressMappingRulesIpAddressMappingRule[]

A list of IP address mapping rules.

Rules are evaluated from top to bottom; the first matching rule applies.

optional

The IpAddressMappingRule object

Configuration of the IP address mapping to the geographic location.

ElementTypeDescriptionRequired
ipAddressMappingLocationIpAddressMappingLocation

The location for an IP address mapping.

required
ipAddressRangeIpAddressRange

The IP address or the IP address range to be mapped to the location.

required

The IpAddressMappingLocation object

The location for an IP address mapping.

ElementTypeDescriptionRequired
countryCodestring

The country code of the location.

To fetch the list of available country codes, use the GET all countries request.

required
citystring

The city name of the location.

optional
regionCodestring

The region code of the location.

To fetch the list of available region codes, use the GET regions of the country request.

optional
latitudenumber

The latitude of the location in DDD.dddd format.

optional
longitudenumber

The longitude of the location in DDD.dddd format.

optional

The IpAddressRange object

The IP address or the IP address range to be mapped to the location.

ElementTypeDescriptionRequired
subnetMaskinteger

The subnet mask of the IP address range.

optional
addressstring

The IP address to be mapped.

For an IP address range, this is the from address.

required
addressTostring

The to address of the IP address range.

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
{ "ipAddressMappingRules": [ { "ipAddressMappingLocation": { "countryCode": "string", "city": "string", "regionCode": "string", "latitude": 1, "longitude": 1 }, "ipAddressRange": { "subnetMask": 1, "address": "string", "addressTo": "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/ipAddressMappings/validator
SaaShttps://{your-environment-id}.live.dynatrace.com/api/config/v1/geographicRegions/ipAddressMappings/validator
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/geographicRegions/ipAddressMappings/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
  • Map internal IP addresses to locations for web applications

    Configure Dynatrace to use local addresses to understand where the users of your web applications are.

  • Map internal IP addresses to locations for mobile applications

    Configure Dynatrace to use local addresses to understand where the users of your mobile applications are.

  • Map internal IP addresses to locations for custom applications

    Configure Dynatrace to use local addresses to understand where the users of your custom applications are.