Deleting an Instance (a V3 API)

Function

This API is used to delete a DDM instance to release all its resources.

Constraints

None

URI

• URL format

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

• Parameter description

  Table 1 Path parameters

  Parameter	Mandatory	Type	Description
  project_id	Yes	String	Project ID of a tenant in a region.
  instance_id	Yes	String	DDM instance ID.

  Table 2 Query parameters

  Parameter	Mandatory	Type	Description
  delete_dn_data	No	Boolean	Whether data stored on the associated DB instances is deleted. This parameter is left empty by default. true: indicates that the data stored on the associated DB instances is deleted. false or leaving this parameter empty: indicates that the data stored on the associated DB instances is not deleted.

Request Parameters

Example Request

DELETE https://ddm.eu-de.otc.t-systems.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/1f5c9fd6cd984056ba89c8c87cc03278in09?delete_dn_data=true

DELETE https://ddm.eu-de.otc.t-systems.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/1f5c9fd6cd984056ba89c8c87cc03278in09?delete_dn_data=false

Response

• Normal response

  Table 4 Response body parameters

  Parameter	Type	Description
  job_id	String	ID of the job for deleting an instance.

• Normal response example

  {
   "job_id": "eff1d289-xxxx-xxxx-8b9f-463ea07c000c"
  }

Status Codes

• Normal

  202

• Abnormal

  For details, see Status Codes.

Error Codes

For details, see Error Codes.