Skip to main content

Create

Create NTP configuration on a target host. The server list is written to /etc/chrony/conf.d/osapi-ntp.conf and chrony is reloaded immediately. Fails if NTP configuration is already managed -- use update to change the server list:

$ osapi client node ntp create --target web-01 \
--servers 0.pool.ntp.org --servers 1.pool.ntp.org

Job ID: 550e8400-e29b-41d4-a716-446655440000

STATUS CHANGED ERROR
ok true

Broadcast to all hosts at once:

$ osapi client node ntp create --target _all \
--servers 0.pool.ntp.org --servers 1.pool.ntp.org

Job ID: 550e8400-e29b-41d4-a716-446655440000

HOSTNAME STATUS CHANGED ERROR
web-01 ok true
web-02 ok true

When some hosts are skipped (e.g., macOS agents):

$ osapi client node ntp create --target _all \
--servers 0.pool.ntp.org

Job ID: 550e8400-e29b-41d4-a716-446655440000

HOSTNAME STATUS CHANGED ERROR
web-01 ok true
mac-01 skipped unsupported platform

JSON Output

Use --json to get the full API response:

$ osapi client node ntp create --target web-01 \
--servers 0.pool.ntp.org --json
{"results":[{"hostname":"web-01","changed":true,"status":"ok"}],"job_id":"..."}

Flags

FlagDescriptionDefault
--serversNTP server addresses (repeatable)required
-T, --targetTarget: _any, _all, hostname, or label (group:web)_any
-j, --jsonOutput raw JSON response