Description
You can call this operation to upgrade an arbitration service group.
Call description
Prerequisites
You have the ARBITRATION:UPDATE permission on all arbitration services in the arbitration service list.
Request path
POST /api/v2/arbitration/services/groups/{id}/upgrade
Request parameters
path:
| Parameter | Type | Required | Example value | Description |
|---|---|---|---|---|
| id | Long | Yes | 1 | The ID of the arbitration service group to be upgraded. |
body:
| Parameter | Type | Required | Example value | Description |
|---|---|---|---|---|
| fullVersion | String | Yes | 4.3.3.0-200000142024073011 | The full version number of the software package of the target version without the .rpm extension. |
| operatingSystem | String | Yes | el7 | The operating system of the software package. |
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/arbitration/services/groups/1/upgrade
{
"fullVersion": "4.3.4.0-200000022024070119",
"operatingSystem": "el7"
}
Sample response
{
"data": {
"creator": "admin",
"executor": "xxx.xxx.xxx.xxx",
"id": 20843,
"name": "Upgrade arbitration service group",
"operation": "EXECUTE",
"prohibitRollback": false,
"startTime": "2025-01-21T11:08:56.059+08:00",
"status": "RUNNING",
"subtasks": [
{
"description": "Install arbitration rpm",
"downstreams": [
26307
],
"id": 26301,
"name": "Install arbitration rpm",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": 0,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 13,
"status": "PENDING",
"taskId": 20843,
"timeout": 1800,
"upstreams": [
26305
]
},
{
"description": "Update arbitration service status",
"downstreams": [
26310
],
"id": 26304,
"name": "Update arbitration service status",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": 1,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 4,
"status": "PENDING",
"taskId": 20843,
"timeout": 60,
"upstreams": [
26297
]
},
{
"description": "Start arbitration service",
"downstreams": [
26302
],
"id": 26311,
"name": "Start arbitration service",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": 0,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 9,
"status": "PENDING",
"taskId": 20843,
"timeout": 1800,
"upstreams": [
26307
]
},
{
"description": "Begin upgrade arbitration",
"downstreams": [
26301,
26314
],
"id": 26305,
"name": "Begin upgrade arbitration",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": -1,
"prohibitRollback": true,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 17,
"status": "PENDING",
"taskId": 20843,
"timeout": 60,
"upstreams": [
26300,
26313
]
},
{
"description": "Wait node",
"downstreams": [
26299,
26303
],
"id": 26302,
"name": "Wait node",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": -1,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 0,
"status": "PENDING",
"taskId": 20843,
"timeout": 30,
"upstreams": [
26298,
26311
]
},
{
"description": "Wait node",
"downstreams": [
26300,
26313
],
"id": 26308,
"name": "Wait node",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": -1,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 16,
"status": "PENDING",
"taskId": 20843,
"timeout": 30,
"upstreams": [
26306,
26312
]
},
{
"description": "Stop arbitration service",
"downstreams": [
26305
],
"id": 26300,
"name": "Stop arbitration service",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": 1,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 12,
"status": "PENDING",
"taskId": 20843,
"timeout": 1800,
"upstreams": [
26308
]
},
{
"description": "Stop arbitration service",
"downstreams": [
26305
],
"id": 26313,
"name": "Stop arbitration service",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": 0,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 11,
"status": "PENDING",
"taskId": 20843,
"timeout": 1800,
"upstreams": [
26308
]
},
{
"description": "Install arbitration rpm",
"downstreams": [
26307
],
"id": 26314,
"name": "Install arbitration rpm",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": 1,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 14,
"status": "PENDING",
"taskId": 20843,
"timeout": 1800,
"upstreams": [
26305
]
},
{
"description": "Start arbitration service",
"downstreams": [
26302
],
"id": 26298,
"name": "Start arbitration service",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": 1,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 10,
"status": "PENDING",
"taskId": 20843,
"timeout": 1800,
"upstreams": [
26307
]
},
{
"description": "Update arbitration service status",
"downstreams": [
26310
],
"id": 26309,
"name": "Update arbitration service status",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": 0,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 3,
"status": "PENDING",
"taskId": 20843,
"timeout": 60,
"upstreams": [
26297
]
},
{
"description": "Update arbitration service version",
"downstreams": [
26297
],
"id": 26299,
"name": "Update arbitration service version",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": 1,
"prohibitRollback": true,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 2,
"status": "PENDING",
"taskId": 20843,
"timeout": 120,
"upstreams": [
26302
]
},
{
"description": "Prepare upgrade arbitration service",
"downstreams": [
26308
],
"id": 26306,
"name": "Prepare upgrade arbitration service",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": 0,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 6,
"status": "READY",
"taskId": 20843,
"timeout": 60,
"upstreams": []
},
{
"description": "Prepare upgrade arbitration service",
"downstreams": [
26308
],
"id": 26312,
"name": "Prepare upgrade arbitration service",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": 1,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 7,
"status": "READY",
"taskId": 20843,
"timeout": 60,
"upstreams": []
},
{
"description": "Update arbitration group version",
"downstreams": [
26304,
26309
],
"id": 26297,
"name": "Update arbitration group version",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": -1,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 5,
"status": "PENDING",
"taskId": 20843,
"timeout": 60,
"upstreams": [
26299,
26303
]
},
{
"description": "Clean arbitration status monitor records",
"downstreams": [],
"id": 26310,
"name": "Clean arbitration status monitor records",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": -1,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 8,
"status": "PENDING",
"taskId": 20843,
"timeout": 120,
"upstreams": [
26304,
26309
]
},
{
"description": "Update arbitration service version",
"downstreams": [
26297
],
"id": 26303,
"name": "Update arbitration service version",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": 0,
"prohibitRollback": true,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 1,
"status": "PENDING",
"taskId": 20843,
"timeout": 120,
"upstreams": [
26302
]
},
{
"description": "Wait node",
"downstreams": [
26298,
26311
],
"id": 26307,
"name": "Wait node",
"nodeType": "JAVA_TASK",
"operation": "EXECUTE",
"parallelIdx": -1,
"prohibitRollback": false,
"prohibitSkip": false,
"runTime": 1,
"seriesId": 15,
"status": "PENDING",
"taskId": 20843,
"timeout": 30,
"upstreams": [
26301,
26314
]
}
],
"taskDefinitionId": -1,
"type": "MANUAL"
},
"duration": 82,
"server": "6d952bd732",
"status": 200,
"successful": true,
"timestamp": "2025-01-21T11:08:56.097+08:00",
"traceId": "0405c46cf150f575"
}