Create

Create a new sysctl parameter on a target host. The value is written to /etc/sysctl.d/osapi-{key}.conf and applied immediately via sysctl -p. Fails if the key is already managed -- use update to change an existing parameter:

$ osapi client node sysctl create --target web-01 \
    --key net.ipv4.ip_forward --value 1

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

  KEY                   CHANGED
  net.ipv4.ip_forward   true

Broadcast to all hosts at once:

$ osapi client node sysctl create --target _all \
    --key vm.swappiness --value 10

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

  HOSTNAME  KEY           CHANGED
  web-01    vm.swappiness  true
  web-02    vm.swappiness  true

When some hosts are skipped (e.g., macOS agents), STATUS and ERROR columns are added:

$ osapi client node sysctl create --target _all \
    --key vm.swappiness --value 10

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

  HOSTNAME  STATUS   KEY           CHANGED  ERROR
  web-01    ok       vm.swappiness  true
  mac-01    skipped                          unsupported platform

JSON Output

Use --json to get the full API response:

$ osapi client node sysctl create --target web-01 \
    --key vm.swappiness --value 10 --json
{"results":[{"hostname":"web-01","key":"vm.swappiness","changed":true,"status":"ok"}],"job_id":"..."}

Flags

Flag	Description	Default
--key	Sysctl parameter key to create	required
--value	Value to assign to the parameter	required
-T, --target	Target: _any, _all, hostname, or label (group:web)	_any
-j, --json	Output raw JSON response