Description
You can call this operation to perform a precheck on arbitration service replacement for multiple OceanBase clusters.
Call description
Prerequisites
- You have the ARBITRATION:UPDATE permission on the target arbitration service.
- You have the CLUSTER:UPDATE permission on all clusters specified in the
clusterIdListparameter.
Request path
POST /api/v2/ob/clusters/batchReplaceArbitrationPreCheck
Request parameters
body:
| Parameter | Type | Required | Example value | Description |
|---|---|---|---|---|
| arbitrationServiceId | Long | Yes | 1 | The ID of the target arbitration service. |
| clusterIdList | List<Long> | Yes | 83,84 | The list of IDs of the OceanBase clusters whose arbitration service will be replaced. Separate the cluster IDs with commas (,). |
Response parameters
Basic data structure
| Parameter | Type | Description |
|---|---|---|
| data | Object | For more information, see the Precheck result section in this topic. |
| 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. |
Precheck result
| Parameter | Type | Description |
|---|---|---|
| valid | Boolean | Indicates whether the precheck was passed. |
| checkResults | List<Object> | For more information, see the Errors section in this topic. |
Errors
| Parameter | Type | Description |
|---|---|---|
| errorCode | String | The error code. |
| args | Object[] | The arguments of the error code. |
| errorMessage | String | The error message. |
| extraInfo | Object | The additional information. |
Examples
Sample request
POST /api/v2/ob/clusters/batchReplaceArbitrationPreCheck
{
"clusterIdList":[83,84],
"arbitrationServiceId":21
}
Sample response
{
"data": {
"checkResults": [],
"valid": true
},
"duration": 1067,
"server": "5e11a5f435",
"status": 200,
"successful": true,
"timestamp": "2025-01-22T18:11:12.627+08:00",
"traceId": "22c9ca17d3541108"
}