Skip to main content

Delete

Delete a custom CA certificate from a target host. The certificate file is removed from /usr/local/share/ca-certificates/ and update-ca-certificates is run to rebuild the trust store:

$ osapi client node certificate delete --target web-01 \
--name internal-ca

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

HOSTNAME STATUS NAME CHANGED
web-01 changed internal-ca true

1 host: 1 changed

If the certificate does not exist, changed: false is returned:

$ osapi client node certificate delete --target web-01 \
--name internal-ca

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

HOSTNAME STATUS NAME CHANGED
web-01 ok internal-ca false

1 host: 1 ok

Broadcast to all hosts:

$ osapi client node certificate delete --target _all \
--name internal-ca

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

HOSTNAME STATUS NAME CHANGED
web-01 changed internal-ca true
web-02 changed internal-ca true

2 hosts: 2 changed

JSON Output

Use --json to get the full API response:

$ osapi client node certificate delete --target web-01 \
--name internal-ca --json
{"results":[{"hostname":"web-01","name":"internal-ca","changed":true,"status":"ok"}],"job_id":"..."}

Flags

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