ntp

POST /infrastructure/ntp/validate

Validate candidate NTP servers

Checks each candidate NTP server from the given node without storing anything and returns one result per server.

Request JSON Object:
  • node_ip (string) – (required)

  • nts (boolean) – NTS is off by default (opt-in): send “nts”: true only with NTS-capable servers. A pool such as pool.ntp.org must be left without NTS.

  • servers[] (string)

Status Codes:
GET /infrastructure/ntp/zones

List zones with NTP configuration

Returns every zone with its NTP configuration.

Status Codes:
POST /infrastructure/ntp/zones/{zoneid}/apply

Apply a zone’s NTP servers

Pushes the zone’s stored NTP server list to every node in the zone; the body is optional.

Parameters:
  • zoneid (string) – Zone ID

Status Codes:
GET /infrastructure/ntp/zones/{zoneid}/nodes

Get NTP state for a zone’s nodes

Returns the zone roll-up of worst clock offset, skew and sync state, with the per-node server breakdown when per_node is true or 1.

Parameters:
  • zoneid (string) – Zone ID

Query Parameters:
  • per_node (string) – true or 1 to include the per-node breakdown

Status Codes:
GET /infrastructure/ntp/zones/{zoneid}/servers

Get a zone’s NTP servers

Returns the zone’s effective NTP servers and whether they come from the zone, site or global default.

Parameters:
  • zoneid (string) – Zone ID

Status Codes:
POST /infrastructure/ntp/zones/{zoneid}/servers

Add an NTP server to a zone

Validates one server from a zone node, appends it to the zone list and applies the list to the zone nodes.

Parameters:
  • zoneid (string) – Zone ID

Status Codes:
PUT /infrastructure/ntp/zones/{zoneid}/servers/{server}

Replace an NTP server in a zone

Replaces the named server in the zone list with the new value after validating it, then applies the list to the zone nodes.

Parameters:
  • zoneid (string) – Zone ID

  • server (string) – Server being replaced

Status Codes:
GET /infrastructure/ntp/zones/{zoneid}/timezone

Get a zone’s timezone

Returns the zone’s configured timezone and each node’s current OS timezone.

Parameters:
  • zoneid (string) – Zone ID

Status Codes: