HA - Set or update proxy configuration for specific data center

The ServiceProviderAPI (Service Provider API) Api-Token scope is required to set or update proxy configuration for specific data center using Dynatrace API.

Endpoint

/api/v1.0/onpremise/proxy/configurations

Parameter

Parameter	Type	Description	In	Required
dc	string	Data Center	path	required
body	InternetProxyChangeRequest		body	optional

Body format

Request parametersJSON model

The InternetProxyChangeRequest object

Configuration of proxy server for Internet connection

Element	Type	Description	Required
scheme	string	Protocol which proxy server uses The element can hold these values http https	required
server	string	Address (either IP or Hostname) of proxy server	required
port	integer	Port of proxy server	required
user	string	User of proxy server, null means do not change previous value	optional
password	string	Password of proxy server, null means do not change previous value	optional
nonProxyHosts	string[]	Definition of hosts for which proxy won't be used. You can define multiple hosts. Each host can start or end with wildcard '*' for instance to match whole domain.	optional

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

      {
  "scheme": "http",
  "server": "string",
  "port": 1,
  "user": "string",
  "password": "string",
  "nonProxyHosts": [
    "string"
  ]
}

Response

Response codes

Code	Description
201	Successful, new configuration created
204	Successful, configuration updated
400	Given proxy configuration is invalid

Response body

A successful request doesn't return any content.

Example

In this example, you add a proxy server (outbound-proxy.dynatrace.com) that uses port 8080 and requires a password to a data center eu-west-1, at the same time excluding an internal lab host (*.internal.lab.company.com).

Curl

curl -X PUT "https://myManaged.cluster.com/api/v1.0/onpremise/proxy/configurations/eu-west-1" -H  "accept: */*" -H  "Content-Type: application/json" -d "{\"scheme\":\"http\",\"server\":\"outbound-proxy-dc1.dynatrace.com\",\"port\":8080,\"nonProxyHosts\":[\"https://mycompany.com/proxy/*\",\"*.internal.lab.company.com\"],\"userOrPasswordDefined\":true}"

Request URL

https://myManaged.cluster.com/api/v1.0/onpremise/proxy/configurations/eu-west-1

Response body

{
  "code": 201,
  "message": "Successful, new configuration created."
}

Response code

201