system.ntpserver.update ======================= Update NTP server of ``id``. .. raw:: html
Type: object

Type: array
No Additional Items

Tuple Validation

Parameter 1: id

id

Type: integer

ID of the NTP server to update.

Parameter 2: ntp_server_update

ntp_server_update

Type: object

Updated configuration for the NTP server.

No Additional Properties

Address

Type: string

Hostname or IP address of the NTP server.

Must match regular expression: ^\S+$

Must be at least 1 characters long

Burst

Type: boolean

Send a burst of packets when the server is reachable.

Iburst

Type: boolean

Send a burst of packets when the server is unreachable.

Prefer

Type: boolean

Mark this server as preferred for time synchronization.

Minpoll

Type: integer

Minimum polling interval (log2 seconds).

Maxpoll

Type: integer

Maximum polling interval (log2 seconds).

Nts

Type: boolean

Use Network Time Security (NTS) to authenticate this server.

The server must support NTS key establishment on TCP port 4460. This system must trust the TLS certificate of the server. The certificate must match address. If address is an IP address, the certificate must include that IP address. The system clock must be approximately correct for the certificate check.

When at least one NTS server is configured, the system ignores servers without NTS. This includes servers from DHCP. If no NTS server is reachable, the system does not adjust the clock.

Force

Type: boolean

Skip the connection checks before saving. Without this option, the server must be reachable. If nts is set, NTS key establishment with the server must also succeed.

NTPServerEntry

Type: object

The updated NTP server configuration.

No Additional Properties

Id

Type: integer

Unique identifier for the NTP server configuration.

Address

Type: string

Hostname or IP address of the NTP server.

Burst

Type: boolean Default: false

Send a burst of packets when the server is reachable.

Iburst

Type: boolean Default: true

Send a burst of packets when the server is unreachable.

Prefer

Type: boolean Default: false

Mark this server as preferred for time synchronization.

Minpoll

Type: integer Default: 6

Minimum polling interval (log2 seconds).

Maxpoll

Type: integer Default: 10

Maximum polling interval (log2 seconds).

Nts

Type: boolean Default: false

Use Network Time Security (NTS) to authenticate this server.

The server must support NTS key establishment on TCP port 4460. This system must trust the TLS certificate of the server. The certificate must match address. If address is an IP address, the certificate must include that IP address. The system clock must be approximately correct for the certificate check.

When at least one NTS server is configured, the system ignores servers without NTS. This includes servers from DHCP. If no NTS server is reachable, the system does not adjust the clock.



*Required roles:* NETWORK_GENERAL_WRITE