IP address mapping rules - PUT configuration

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

The request consumes an application/json payload.

Early Adopter

This request is an Early Adopter release and may be changed in non-compatible way.

PUT
  • Managed https://{your-domain}/e/{your-environment-id}/api/config/v1/geographicRegions/ipAddressMappings
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/config/v1/geographicRegions/ipAddressMappings

Authentication

To execute this request, you need the Write configuration (WriteConfig) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter Type Description In Required
body IpAddressMappings

JSON body of the request containing definition of the ip address mapping.

body optional

The IpAddressMappings object

Settings for creating Ip address mapping rules (location information and ip address range)

Element Type Description Required
ipAddressMappingRules IpAddressMappingRule[]

A list of ip address mapping rules.

optional

The IpAddressMappingRule object

Settings for creating ip address mapping rule (location information and ip address range)

Element Type Description Required
ipAddressMappingLocation IpAddressMappingLocation required
ipAddressRange IpAddressRange required

The IpAddressRange object

Ip address range that can be specified as single ip address, addresses (from) and address to or address and subnet mask.

Element Type Description Required
subnetMask integer

The subnet of the ip address range settings

optional
address string

The ip address

required
addressTo string

The ip address to

optional

The IpAddressMappingLocation object

The location for an ip address mapping

Element Type Description Required
countryCode string

The country code of the location

required
city string

The city name of the location

optional
regionCode string

The region code of the location

optional
latitude number

The latitude for the ip address mapping rules

optional
longitude number

The latitude for the ip address mapping rules

optional

Response codes

Code Description
204 The submitted configuration has been updated. Existing mappings will be overridden.
400 Failed. The input is invalid

Response format

A successful request doesn't return any content.

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.

Early Adopter

This request is an Early Adopter release and may be changed in non-compatible way.

POST
  • Managed https://{your-domain}/e/{your-environment-id}/api/config/v1/geographicRegions/ipAddressMappings/validator
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/config/v1/geographicRegions/ipAddressMappings/validator

Authentication

To execute this request, you need the Write configuration (WriteConfig) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Response codes

Code Description
204 Validated. The submitted configuration is valid. Response does not have a body.
400 Failed. The input is invalid