YaST REST Service Documentation

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or (at your option) version 1.3; with the Invariant Section being this copyright notice and license. A copy of the license version 1.2 is included in the section entitled "GNU Free Documentation License".

Ntp Service

Only authenticated users are allowed to access the API. Authentication is done by sending a Basic HTTP Authorisation header.

All names aren't allowed to contain spaces, slashes or colons.

System Actions

GET /ntp
PUT /ntp

Formats

The Ntp REST service supports only XML and JSON input/output formats.

Overview

This module provides access to the Ntp synchronization. Curretly it provides only synchronize again predefined server. Predefined servers is stored in /etc/sysconfig/network/config - key NETCONFIG_NTP_STATIC_SERVERS

PolicyKit Access Rights

The following PolicyKit permissions are needed to execute synchronize:

Synchronize: org.opensuse.yast.modules.yapi.ntp.synchronize

System Actions

GET /ntp

Get the list of supported system actions. The list contains actions for ntp. Nowadays, it is like synchronize.

CURL Example: curl -u <user> http://localhost:4984/ntp.xml

Result: Example

PUT /ntp

Trigger a action. Set active flag to true for the action which should be started - see the XML example file.

CURL example: curl -u <user> -X PUT -H 'Content-type: text/xml' -d @sync_request.xml http://localhost:4984/ntp.xml

Body: Example