load-balancer

Modify load balancer resolver

Modifies existing resolver by given {service-uuid} and {resolver-name}.

patch/1.3/load-balancer/{service-uuid}/resolvers/{resolver-name}

Request

  • Base URL: https://api.upcloud.com
  • URL: https://api.upcloud.com/1.3/load-balancer/{service-uuid}/resolvers/{resolver-name}
  • Auth: HTTP bearer

Path parameters

service-uuidstring uuid required

The UUID of the service.

Example:01234567-89ab-cdef-0123-456789abcdef

The unique identifier for the service.

resolver-namestring required

The name of the resolver.

Example:example-resolver-1

The unique identifier for the resolver.

Request body

namestring

Name of the resolver

nameserversstring[]

Nameservers

retriesinteger

Number of retries on failure

timeoutinteger

Timeout for the query in seconds

timeout_retryinteger

Timeout for the query retries in seconds

cache_validinteger

Time in seconds to cache valid results

cache_invalidinteger

Time in seconds to cache invalid results

Example request

{
  "name": "default-resolver",
  "nameservers": [
    "1.1.1.1:53",
    "8.8.8.8:53"
  ],
  "retries": 3,
  "timeout": 5,
  "timeout_retry": 3,
  "cache_valid": 300,
  "cache_invalid": 60
}

Response

Created

namestring required

Human-readable name assigned to the DNS resolver.

nameserversstring[] required

List of DNS nameserver addresses (with optional port) used to resolve backend member hostnames.

retriesinteger required

Number of retry attempts for failed DNS queries.

timeoutinteger required

Initial timeout in milliseconds for DNS query responses.

timeout_retryinteger required

Timeout in milliseconds for DNS query retry attempts.

cache_validinteger required

Time in seconds to cache valid (successful) DNS responses.

cache_invalidinteger required

Time in seconds to cache invalid (failed) DNS responses.

created_atstring date-time required

Timestamp when the DNS resolver was created (RFC 3339 format).

updated_atstring date-time required

Timestamp when the DNS resolver was last updated (RFC 3339 format).

Example response

{
  "name": "default-resolver",
  "nameservers": [
    "94.237.127.9",
    "94.237.40.9"
  ],
  "retries": 3,
  "timeout": 1000,
  "timeout_retry": 1500,
  "cache_valid": 86400,
  "cache_invalid": 60,
  "created_at": "2025-11-06T09:00:00.000Z",
  "updated_at": "2025-11-06T09:30:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.