Skip to main content

Get

Get NTP sync status and configuration from a target host:

$ osapi client node ntp get --target web-01

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

SYNCHRONIZED STRATUM OFFSET SOURCE SERVERS
yes 2 +0.000123 192.0.2.1 0.pool.ntp.org, 1.pool.ntp.org

When targeting all hosts:

$ osapi client node ntp get --target _all

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

HOSTNAME SYNCHRONIZED STRATUM OFFSET SOURCE SERVERS
web-01 yes 2 +0.000123 192.0.2.1 0.pool.ntp.org, 1.pool.ntp.org
web-02 yes 2 +0.000045 192.0.2.1 0.pool.ntp.org, 1.pool.ntp.org

When some hosts are skipped, STATUS and ERROR columns appear alongside data columns:

$ osapi client node ntp get --target _all

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

HOSTNAME STATUS ERROR SYNCHRONIZED STRATUM OFFSET SOURCE SERVERS
web-01 ok yes 2 +0.000123 192.0.2.1 0.pool.ntp.org
mac-01 skipped unsupported platform

JSON Output

Use --json to get the full API response:

$ osapi client node ntp get --target web-01 --json
{"results":[{"hostname":"web-01","synchronized":true,"stratum":2,
"offset":"+0.000123","current_source":"192.0.2.1",
"servers":["0.pool.ntp.org","1.pool.ntp.org"],"status":"ok"}],
"job_id":"..."}

Flags

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