Skip to main content

Get

Get details for a specific package by name:

$ osapi client node package get --target web-01 --name nginx

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

HOSTNAME STATUS NAME VERSION PKG STATUS
web-01 ok nginx 1.24.0-2 installed

1 host: 1 ok

Broadcast to see the package across all hosts:

$ osapi client node package get --target _all --name nginx

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

HOSTNAME STATUS NAME VERSION PKG STATUS
web-01 ok nginx 1.24.0-2 installed
web-02 ok nginx 1.24.0-2 installed

2 hosts: 2 ok

When some hosts are skipped:

$ osapi client node package get --target _all --name nginx

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

HOSTNAME STATUS NAME VERSION PKG STATUS
web-01 ok nginx 1.24.0-2 installed
mac-01 skip

2 hosts: 1 ok, 1 skipped

Details:
mac-01 unsupported platform

JSON Output

Use --json to get the full API response:

$ osapi client node package get --target web-01 --name nginx --json
{"results":[{"hostname":"web-01","packages":[{"name":"nginx","version":
"1.24.0-2","status":"installed","size":1258291}],"status":"ok"}],
"job_id":"..."}

Flags

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