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

IP address mapping rules - GET configuration

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

The request produces an application/json payload.

GETManagedDynatrace 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 ReadConfig scope.

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

Parameters

The request doesn't provide any configurable parameters.

Response

Response codes

CodeTypeDescription
200IpAddressMappings

Success

Response body objects

The IpAddressMappings object

Configuration of the IP address mappings to geographic locations.

ElementTypeDescription
ipAddressMappingRulesIpAddressMappingRule[]

A list of IP address mapping rules.

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

The IpAddressMappingRule object

Configuration of the IP address mapping to the geographic location.

ElementTypeDescription
ipAddressMappingLocationIpAddressMappingLocation

The location for an IP address mapping.

ipAddressRangeIpAddressRange

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

The IpAddressMappingLocation object

The location for an IP address mapping.

ElementTypeDescription
countryCodestring

The country code of the location.

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

citystring

The city name of the location.

regionCodestring

The region code of the location.

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

latitudenumber

The latitude of the location in DDD.dddd format.

longitudenumber

The longitude of the location in DDD.dddd format.

The IpAddressRange object

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

ElementTypeDescription
subnetMaskinteger

The subnet mask of the IP address range.

addressstring

The IP address to be mapped.

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

addressTostring

The to address of the IP address range.

Response body JSON model

json
{ "ipAddressMappingRules": [ { "ipAddressMappingLocation": { "countryCode": "string", "city": "string", "regionCode": "string", "latitude": 1, "longitude": 1 }, "ipAddressRange": { "subnetMask": 1, "address": "string", "addressTo": "string" } } ] }
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.