DeleteInstances - ApsaraDB for OceanBase - Alibaba Cloud Documentation Center

You can call this operation to release an OceanBase cluster.

Operation description

Before you call this operation, ensure that the following requirements are met:

There is currently no authorization information disclosed in the API.

Parameter	Type	Required	Description	Example
InstanceIds	string	Yes	The ID of the cluster to be deleted. The value is a string in the JSON format.	[”ob ob3f6yhv9uxxxx“]
BackupRetainMode	string	No	The backup retention strategy for cluster deletion. Valid values: receive_all: retains all backup sets. delete_all: deletes all backup sets. receive_last: retains the last backup set. Note Default value: delete_all.	delete_all
DryRun	boolean	No	Specifies whether to perform only a dry run for the request. Default value: false. Valid values: true: Only a dry-run request is sent and the instance is not deleted. If the dry run succeeds, DryRunResult=true is returned. If the dry run fails, an error code is returned. false: The actual request is sent and no dry run is performed. The instance is deleted if the requirements are met. By default, false is returned for the parameter DryRunResult if you set DryRun to false.	false

Parameter	Type	Description	Example
	object	The return result of the request.
RequestId	string	The ID of the request.	473469C7-**-**-B3DB-A3DC0DE3C83E
Data	object	The returned data.
DryRunResult	boolean	The result of the dry-run request. If the DryRun parameter is set to true and the dry run succeeds, the DryRunResult parameter returns true. Otherwise, an error code is returned. If the DryRun parameter is set to false, no dry run is performed and the DryRunResult parameter returns false.	false

Sample success responses

JSONformat

{
  "RequestId": "473469C7-****-****-B3DB-A3DC0DE3C83E",
  "Data": {
    "DryRunResult": false
  }
}

HTTP status code	Error code	Error message
400	BadRequest	BadRequest
404	InstanceStatus.Invalid	InstanceStatus.Invalid
404	StandbyInstance.StillOnline	StandbyInstance.StillOnline
404	UnknownError	UnknownError
404	Tenant.StillOnline	Tenant.StillOnline
404	ServiceTemporarilyUnavailable	ServiceTemporarilyUnavailable
404	NotFound	NotFound
500	InternalServerError	InternalServerError

For a list of error codes, visit the Service error codes.

Change time	Summary of changes	Operation
2023-10-30	The Error code has changed. The request parameters of the API has changed. The response structure of the API has changed	View Change Details
2023-07-04	The Error code has changed	View Change Details