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

The InternetProxyChangeRequest object

Configuration of proxy server for Internet connection

Element Type Description Required
scheme string

Protocol which proxy server uses

 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

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