Deleting a DB Instance

Function

This API is used to delete a DB instance. Before calling this API:

• Learn how to authorize and authenticate it.

• Obtain the required region and endpoint.

URI

DELETE /v3/{project_id}/instances/{instance_id}

Table 1 URI parameters

Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID of a tenant in a region. To obtain this value, see Obtaining a Project ID.
instance_id	Yes	String	DB instance ID, which is compliant with the UUID format.

Request Parameters

Table 2 Request header parameters

Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token.
X-Language	No	String	Language.

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter	Type	Description
job_id	String	Task ID.

Status code: 400

Table 4 Response body parameters

Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Status code: 500

Table 5 Response body parameters

Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Example Request

DELETE https://gaussdb-mysql.eu-de.otc.t-systems.com/v3/054e292c9880d4992f02c0196d3ea468/instances/096c0fc43e804757b59946b80dc27f8bin07

Example Response

Status code: 500

Server error.

{
  "job_id" : "04efe8e2-9255-44ae-a98b-d87cae411890"
}

Status Code

For details, see Status Codes.

Error Code

For details, see Error Codes.

last updated: 2025-10-17 13:56 UTC - commit: 69982723bf975fb292bf35f647acbddfd33eefdb