# Move out an OceanBase cluster
Description
You can call this operation to move out an OceanBase cluster. If you directly call this operation, the cluster credentials will be missing. We recommend that you export the file of cluster credentials before you move out the OceanBase cluster.
Call description
Prerequisites
You have the permissions to move out the specified OceanBase cluster.
For more information about the permissions, see Overview and Overview.
You have passed the authentication for the OceanBase Cloud Platform (OCP) application service.
Request path
POST /api/v2/ob/clusters/{id}/moveOut
Request parameters
Path parameters
| Parameter | Type | Required | Example value | Description |
|---|---|---|---|---|
| id | Long | Yes | 1 | The ID of the OceanBase cluster to be moved out. |
Body parameters
| Parameter | Type | Required | Example value | Description |
|---|---|---|---|---|
| deleteHost | Boolean | No | true | Specifies whether to delete all hosts in the cluster when the cluster is moved out. |
| targetConfigAddress | String | No | http://xxx.xxx.xxx.xxx:xxx | The URL of the new config server that is specified for the cluster when you move out the cluster. The URL is in the http://xxx.xxx.xxx.xxx:xxx format. |
Response parameters
Basic data structure
| Parameter | Type | Description |
|---|---|---|
| data | Object | The information about the asynchronous task. For more information, see Task return structure. |
| successful | Boolean | Indicates whether the request was successful. |
| timestamp | Datetime | The timestamp when the server completed the request. |
| duration | Integer | The amount of time taken by the server to process the request, in milliseconds. |
| status | Integer | The HTTP status code. |
| traceId | String | The trace ID of the request. This trace ID is used for troubleshooting. |
| server | String | The address of the application server that responded to the request. |
Examples
Sample request
POST /api/v2/ob/clusters/{id}/moveOut
{
"deleteHost": true,
"targetConfigAddress": "http://xxx.xxx.xxx.xxx:xxx"
}
Sample response
{
"data": {
"clusterId": 5000033,
"creator": "admin",
"executor": "xxx.xxx.xxx.xxx",
"id": 13089033,
"name": "Move out primary OB cluster",
"operation": "EXECUTE",
"prohibitRollback": false,
"startTime": "2024-10-10T17:13:19.269+08:00",
"status": "RUNNING",
"subtasks": [
{
"description": "Delete cluster related info",
"downstreams": [
13104453
],
"id": 13104455,
"name": "Delete cluster related info",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": -1,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 1,
"status": "PENDING",
"timeout": 1800,
"upstreams": [
13104454
]
},
{
"description": "Prepare move out cluster",
"downstreams": [
13104454
],
"id": 13104458,
"name": "Prepare move out cluster",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": -1,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 2,
"status": "PENDING",
"timeout": 300,
"upstreams": [
13104456
]
},
{
"description": "Inactive agent modules",
"downstreams": [
13104455
],
"id": 13104454,
"name": "Inactive agent modules",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": 0,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 3,
"status": "PENDING",
"timeout": 3600,
"upstreams": [
13104458
]
},
{
"description": "Unreserve host",
"downstreams": [
13104450
],
"id": 13104451,
"name": "Unreserve host",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": -1,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 7,
"status": "PENDING",
"timeout": 1800,
"upstreams": [
13104453
]
},
{