load-balancer

List load balancer resolvers

Returns a list of available service domain name resolvers by given {service-uuid}.

get/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.

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.