Overview
You can call this API to delete an OceanBase cluster instance.
API details
Constraints
The caller must have an AccessKey for accessing the APIs of OceanBase Cloud. For information about how to obtain the AccessKey ID and AccessKey secret, see Manage AccessKeys.
Request path
DELETE /api/v2/instances
Request parameters
Query
| Name | Type | Required | Description | Example value |
|---|---|---|---|---|
| None |
Body
| Name | Type | Required | Description | Example value |
|---|---|---|---|---|
| instanceId | Integer | Yes | The ID of the instance. | ob677efwh8******** |
Response parameters
| Parameter | Type | Description | Example value |
|---|---|---|---|
| success | boolean | Indicates whether the request was successful. | true/false |
| requestId | String | trace | dc302d76-66b5-48d8-ab53-a035******** (64-bit) |
Examples
Request example
curl --request DELETE \
--digest -u 'ak:sk' \
--data '{"instanceId":"ob677efwh8********"}' \
--url https://api-cloud.oceanbase.com/api/v2/instances
-H 'X-Ob-Project-Id: Project ID'
Note
- A project ID uniquely identifies a project. For information about how to obtain the project ID of an instance, see Manage projects.
- Make sure that the project ID corresponding to the specified instanceId is consistent with the specified project ID.
Response example
Here is a response example when the request is successful:
{
"data":{},
"success" : true,
"requestId": "dc302d76-66b5-48d8-ab53-a035********"
}
Here is a response example when the request failed:
{
"errorCode": "Params.InstanceName.Invalid",
"errorMessage": "The cluster name is invalid.",
"requestId": "cb32942e-bdf2-4d85-a26f-6bf8********",
"success": false
}