databases

DELETE `/v1/databases/{databaseId}`

Delete a managed database and its backups.

Uwierzytelnianie

Wyślij klucz API jako token bearer. Ten punkt końcowy nie określa konkretnego uprawnienia w specyfikacji, więc nadaj swojemu kluczowi minimum potrzebnych uprawnień i sprawdź odpowiedź zamiast zakładać.

Ten punkt końcowy nie wymaga identyfikatora organizacji. Twój klucz już identyfikuje organizację, do której należy, a odpowiedź jest do niej ograniczona.

Wypróbuj

Zastąp wszystko w nawiasach ostrych własnymi wartościami, a zastępczy znacznik klucza kluczem ze swojego pulpitu nawigacyjnego.

curl -X DELETE https://api.zinndigital.com/v1/databases/{databaseId} \
  -H "Authorization: Bearer zdk_live_…"

Zalogowany? Konsola API w Twoim panelu uzupełnia rzeczywiste identyfikator organizacji oraz Twój własny klucz i wykonuje żądanie względem aktywnego API, dzięki czemu możesz zobaczyć rzeczywistą odpowiedź. Otwórz ten punkt końcowy w konsoli API

Szczegóły

Gated on `databases.manage`. Returns `202` — the instance moves to `deleting` and **stops accruing charges at that moment**, not when the last volume detaches; teardown latency is ours, not the customer's. ⛔ Irreversible: the cluster, its volumes and its backup chain all go.

Parametry

Nazwa	Typ	Wymagane	Co to jest
`databaseId (path)`	`string`	Tak	—

Odpowiedź

Nazwa	Typ	Wymagane	Co to jest
`id`	`string`	Tak	—
`label`	`string`	Tak	The customer's own name for it. Never sent to the infrastructure.
`engine`	`string<postgres, mysql>`	Tak	Which engine this database runs (`docs/497`). Modelled as a field from the start, which is why MySQL was additive rather than a migration of every row.
`engine_version`	`string`	Tak	The engine's major — `"18"`, `"8.4"`. The patch level is ours to keep current and is deliberately not customer-selectable: choosing your own patch level means choosing to ru…
`engine_label`	`string`	Nie	The engine and version as a customer sees them — "PostgreSQL 18", "MySQL 8.4". Assembled by the API so three frontends cannot disagree about a product name.
`size`	`string`	Tak	A code from `GET /v1/databases/catalogue`.
`status`	`string<provisioning, available, failed, suspended, deleting, deleted>`	Tak	—
`status_detail`	`string`	Nie	Why a `failed` instance failed. Empty otherwise.
`host`	`string`	Nie	Empty until the instance is `available`.
`port`	`integer`	Tak	—
`database_name`	`string`	Tak	—
`username`	`string`	Tak	—
`high_availability`	`boolean`	Tak	Whether a standby replica is held with automatic failover. The property customers actually choose on — stated rather than inferred from the size, because an inference goes w…
`vcpu`	`integer`	Nie	—
`ram_gb`	`integer`	Nie	—
`storage_gb`	`integer`	Nie	—
`tls_required`	`boolean`	Tak	Always true. TLS is a precondition of selling a publicly reachable database, not a feature that can be turned off.
`created_at`	`string`	Tak	—
`last_backup_at`	`string`	Nie	When a backup last completed. `null` means none has ever run.
`order_line_id`	`object`	Nie	The paid basket line this database fulfils, or `null` for one that predates the purchase path or that staff tooling created. The subscription that bills it carries the same id.
`billing`	`ManagedDatabaseBilling`	Nie	The subscription paying for this database — what it costs, and when it next renews. ⛔ `null` means no subscription pays for it, which is a real state (a row created before d…
`restore_verified_at`	`string`	Nie	When a backup of this database was last proved restorable by restoring it and reading a row back over a client connection. ⛔ Deliberately separate from `last_backup_at`: a b…

Błędy, które ten punkt końcowy może zwrócić

401 · 403 · 404

DELETE /v1/databases/{databaseId}