Drop a database (HTTP)
|
For details about additional languages, see: |
|
Terminating a database permanently deletes all of its data, including automatic backups. You cannot undo this action. |
Deletes a database and erases all data stored in it.
|
You need an application token with permission to create and configure databases, such as the Organization Administrator role. For more information, see Get endpoint and token. |
Result
Deletes the specified database and erases all data stored in the database.
Returns 202 Accepted, indicating that the database deletion has been initiated.
The database isn’t instantly deleted, and the termination process can take some time. To monitor the termination process, you can check the database status in the Astra Portal.
Parameters
Use the DevOps API to delete a database. This operation is a POST request with no body.
The application token must have sufficient permissions to perform the requested operations, such as the Organization Administrator role.
Command signature
curl -sS -L -X POST "https://api.astra.datastax.com/v2/databases/DATABASE_ID/terminate" \
--header "Authorization: Bearer APPLICATION_TOKEN" \
--header "Content-Type: application/json"Examples
The following examples demonstrate how to drop a database.
curl -sS -L -X POST "https://api.astra.datastax.com/v2/databases/DATABASE_ID/terminate" \
--header "Authorization: Bearer APPLICATION_TOKEN" \
--header "Content-Type: application/json"