load-balancer

Get load balancer resolver

Returns backend resolver details by given {service-uuid} and {resolver-name}.

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

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.