compute

POST `/v1/compute/servers/{serverId}/root-password`

Reset a server's root password. ⛔ Reboots the machine.

Аутентификација

Пошаљите API кључ као bearer токен. Кључ мора имати дозволу sites.delete; кључ без ње се одбија уз 403, а не 404.

Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

curl -X POST https://api.zinndigital.com/v1/compute/servers/{serverId}/root-password \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "password": <string>, "confirm": <string> }'

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли

Детаљи

⭐⭐ The other half of "I am locked out of my own server", and the half a console alone does not solve: the console gets you to a login prompt, and this is what you type into it when the password is the thing you lost. ⛔⛔ The machine reboots. The provider restarts the guest as part of applying the change, so everything running on it goes offline for a minute or two. A surface offering this must say so before the button, not in the result. ⛔ Requires sites.delete, not sites.restart: a root password is total control of the machine and everything on it, which is the same order of trust as destroying it. The server's name must be typed to confirm, and that is checked server-side — a dialog the client owns is a dialog an API caller never sees. ⛔ At least 16 characters, length only and no composition rules: this credential faces the public internet on port 22, and length is what makes it hard to guess. The value is never logged, never audited and never echoed back. 503 on a range whose provider publishes no reset (our own cloud installs an SSH key instead and mints no root password at all).

Параметри

Назив	Тип	Обавезно	Шта је ово
`serverId (path)`	`Uuid`	Да	The server's id, as `listComputeServers` reports it. Ours (UUIDv7), minted when the order row was written — never the provider's own identifier for the machine.

Тело захтева

Назив	Тип	Обавезно	Шта је ово
`password`	`string`	Да	The new root password. At least 16 characters.
`confirm`	`string`	Да	The server's name, typed exactly.

Грешке које ова крајња тачка може вратити

401 · 403 · 404 · 422 · 429 · 503

POST /v1/compute/servers/{serverId}/root-password