List a project's DNS latency targets.

GET

/v1/projects/{projectId}/dns/latency-targets

Code sample: Shell / cURL

curl --request GET \
  --url https://stratum.example.com/v1/projects/example/dns/latency-targets \
  --header 'Authorization: Bearer <token>'

• A Stratum cluster endpoint.

Latency targets (Slice D) drive the latency routing policy: the prober measures RTT to each and the policy answers with the lowest-RTT record. The list omits the result snapshot; GET one to see it.

Authorizations

• bearerAuth

Parameters

Path Parameters

projectId

required

string

/^p-[a-z0-9-]+$/

Responses

200

The project’s latency targets.

Media typeapplication/json

object

items

required

Array<object>

object

id

required

integer format: int64

projectId

required

string

region

string

name

required

string

address

required

IPv4/IPv6 literal or hostname to measure RTT to.

string

probeProtocol

required

string

Allowed values: icmp tcp http https

probePort

Required for tcp/http/https; absent for icmp.

integer

nullable

probePath

HTTP/HTTPS request path.

string

intervalSeconds

integer

timeoutSeconds

integer

ewmaAlpha

EWMA smoothing factor in (0,1]; smaller = smoother.

number format: double

enabled

required

boolean

createdAt

string format: date-time

updatedAt

string format: date-time

result

Latest prober snapshot; absent until the target has been probed.

object

rttMs

Last measured RTT in ms; null on a failed probe.

number format: double

nullable

rttMsEwma

EWMA-smoothed RTT the latency policy ranks on.

number format: double

nullable

lastProbeAt

required

string format: date-time

lastStatus

required

string

Allowed values: ok error

lastError

string

nullable

Example

{
  "items": [
    {
      "probeProtocol": "icmp",
      "result": {
        "lastStatus": "ok"
      }
    }
  ]
}