databases

DELETE `/v1/databases/{databaseId}`

Delete a managed database and its backups.

Autentifikacija

Pošaljite API ključ kao bearer token. Ova krajnja točka ne navodi određenu dozvolu u specifikaciji, stoga dajte svom ključu najmanje što mu je potrebno i provjerite odgovor umjesto da pretpostavljate.

Ova krajnja točka ne prihvaća ID organizacije. Vaš ključ već identificira organizaciju kojoj pripada, a odgovor je ograničen na nju.

Isprobajte

Zamijenite sve unutar šiljastih zagrada svojim vlastitim vrijednostima, a rezervirano mjesto za ključ s ključem iz vaše nadzorne ploče.

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

Prijavljeni ste? API konzola na vašoj nadzornoj ploči automatski unosi stvarni ID vaše organizacije i vaš vlastiti ključ te šalje zahtjev prema aktivnom API-ju kako biste mogli vidjeti stvarni odgovor. Otvori ovu krajnju točku u API konzoli

Pojedinosti

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.

Parametri

Naziv	Vrsta	Obavezno	Što je to
`databaseId (path)`	`string`	Da	—

Odgovor

Naziv	Vrsta	Obavezno	Što je to
`id`	`string`	Da	—
`label`	`string`	Da	The customer's own name for it. Never sent to the infrastructure.
`engine`	`string<postgres, mysql>`	Da	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`	Da	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`	Ne	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`	Da	A code from `GET /v1/databases/catalogue`.
`status`	`string<provisioning, available, failed, suspended, deleting, deleted>`	Da	—
`status_detail`	`string`	Ne	Why a `failed` instance failed. Empty otherwise.
`host`	`string`	Ne	Empty until the instance is `available`.
`port`	`integer`	Da	—
`database_name`	`string`	Da	—
`username`	`string`	Da	—
`high_availability`	`boolean`	Da	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`	Ne	—
`ram_gb`	`integer`	Ne	—
`storage_gb`	`integer`	Ne	—
`tls_required`	`boolean`	Da	Always true. TLS is a precondition of selling a publicly reachable database, not a feature that can be turned off.
`created_at`	`string`	Da	—
`last_backup_at`	`string`	Ne	When a backup last completed. `null` means none has ever run.
`order_line_id`	`object`	Ne	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`	Ne	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`	Ne	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…

Pogreške koje ova krajnja točka može vratiti

401 · 403 · 404

DELETE /v1/databases/{databaseId}