Start an arbitration service

2026-04-03 03:16:02  Updated

Description

You can call this operation to start an arbitration service.

Call description

Prerequisites

You have the ARBITRATION:UPDATE permission on the arbitration service.

Request path

POST /api/v2/arbitration/services/{id}/start

Request parameters

path:

Parameter Type Required Example value Description
id Long Yes 4901 The ID of the arbitration service to be started.

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/20838/start

Sample response

{
    "data": {
        "creator": "admin",
        "executor": "xxx.xxx.xxx.xxx",
        "id": 20838,
        "name": "Start arbitration service",
        "operation": "EXECUTE",
        "prohibitRollback": false,
        "startTime": "2025-01-21T10:55:02.121+08:00",
        "status": "RUNNING",
        "subtasks": [
            {
                "description": "Prepare start arbitration service",
                "downstreams": [
                    26288
                ],
                "id": 26287,
                "name": "Prepare start arbitration service",
                "nodeType": "JAVA_TASK",
                "operation": "EXECUTE",
                "parallelIdx": -1,
                "prohibitRollback": false,
                "prohibitSkip": false,
                "runTime": 1,
                "seriesId": 2,
                "status": "READY",
                "taskId": 20838,
                "timeout": 60,
                "upstreams": []
            },
            {
                "description": "Start arbitration service",
                "downstreams": [
                    26286
                ],
                "id": 26288,
                "name": "Start arbitration service",
                "nodeType": "JAVA_TASK",
                "operation": "EXECUTE",
                "parallelIdx": -1,
                "prohibitRollback": false,
                "prohibitSkip": false,
                "runTime": 1,
                "seriesId": 1,
                "status": "PENDING",
                "taskId": 20838,
                "timeout": 1800,
                "upstreams": [
                    26287
                ]
            },
            {
                "description": "Update arbitration service status",
                "downstreams": [],
                "id": 26286,
                "name": "Update arbitration service status",
                "nodeType": "JAVA_TASK",
                "operation": "EXECUTE",
                "parallelIdx": -1,
                "prohibitRollback": false,
                "prohibitSkip": false,
                "runTime": 1,
                "seriesId": 0,
                "status": "PENDING",
                "taskId": 20838,
                "timeout": 60,
                "upstreams": [
                    26288
                ]
            }
        ],
        "taskDefinitionId": -1,
        "type": "MANUAL"
    },
    "duration": 28,
    "server": "6d952bd732",
    "status": 200,
    "successful": true,
    "timestamp": "2025-01-21T10:55:02.131+08:00",
    "traceId": "18c93a6526165273"
}

Contact Us