global

Test upstream configuration

post/test_upstream_dns

Request

  • Base URL
    /control (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    HTTP basic

Request body

bootstrap_dnsstring[] required

Bootstrap servers, port is optional after colon. Empty value will reset it to default values.

upstream_dnsstring[] required

Upstream servers, port is optional after colon. Empty value will reset it to default values.

private_upstreamstring[]

Local PTR resolvers, port is optional after colon. Empty value will reset it to default values.

Example request

{
  "bootstrap_dns": [
    "8.8.8.8:53",
    "1.1.1.1:53"
  ],
  "upstream_dns": [
    "tls://1.1.1.1",
    "tls://1.0.0.1"
  ],
  "private_upstream": [
    "tls://1.1.1.1",
    "tls://1.0.0.1"
  ]
}

Response

Status of testing each requested server, with "OK" meaning that server works, any other text means an error.

UpstreamsConfigResponse required

Upstreams configuration response

Changes

No recorded changes to this operation across all 2 revisions of this API.