DELETE
/vault/hyok/hosts/{host_id}Delete Host
Deregisters a host.
It is refused while the host is in a cluster: remove it from the cluster first.
The host's record is kept with the status deregistered.
Deregistering it again returns 204.
Needs ORG_ADMIN.
Parameters
| orgId * | query | The organisation's id. |
| host_id * | path | The host's id: |
Responses
| HTTP | K9O Code | Description |
|---|---|---|
| 204 | The host is deregistered. | |
| 404 | No such host. | |
| 409 | `HYOK_HOST_IN_CLUSTER`: the host is in a cluster. | |
| 500 | An internal error. Retry later. |
cURL
curl -X DELETE 'https://<org>.api-<region>.k9o.io/@storefront/vault/hyok/hosts/<hostId>' \
-H 'Authorization: Bearer $K9O_TOKEN'Showing example in cURL