load-balancer

Create load balancer resolver

Creates a new resolver by given {service-uuid}.

Resolver is a DNS server usually residing in a user's private network. It's used to resolve IPs for backend members of type dynamic.

post/1.3/load-balancer/{service-uuid}/resolvers

Request

  • Base URL: https://api.upcloud.com
  • URL: https://api.upcloud.com/1.3/load-balancer/{service-uuid}/resolvers
  • 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.

Request body

namestring required

Name of the resolver

nameserversstring[] required

Nameservers

retriesinteger required

Number of retries on failure

timeoutinteger required

Timeout for the query in seconds

timeout_retryinteger required

Timeout for the query retries in seconds

cache_validinteger required

Time in seconds to cache valid results

cache_invalidinteger required

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.