Harthelm Docs
REST APIStages

Stop a stage

Aborts the active run (`prepare`, `test`), or sets every service to stopped (`run`; the pods stay). Stopping a stage that does not run is not an error. Needs `landscape.manage`.

Generated from openapi/harthelm.yaml at v1.5.0
POST
/workspaces/{ws}/stages/{stage}/stop

Authorization

cookie__Host-harthelm_session<token>

Browser session of the UI (12 h idle, 7 days absolute). State-changing requests also need the header Harthelm-CSRF: 1 and a matching Origin.

Path Parameters

ws*integer

Numeric resource id.

Formatint64
Range1 <= value
stage*string
Value in"prepare""test""run"

Response Body

The stage after the stop.

application/json
  1. response
stage*StageName
Value in"prepare""test""run"
running*boolean
run?

The latest run; absent when the stage never ran.

curl -X POST 'https://console.example.com/api/v1/workspaces/1/stages/prepare/stop'
{  "stage": "prepare",  "running": true,  "run": {    "id": 1,    "stage": "prepare",    "profile": "string",    "source_hash": "string",    "run_generation": 0,    "state": "waiting",    "started_by": 1,    "created_at": "2019-08-24T14:15:22Z",    "started_at": "2019-08-24T14:15:22Z",    "finished_at": "2019-08-24T14:15:22Z",    "entries": [      {        "service": "string",        "replica": "string",        "step": 0,        "name": "string",        "state": "waiting",        "exit_code": 0,        "restarts": 0,        "started_at": "2019-08-24T14:15:22Z",        "finished_at": "2019-08-24T14:15:22Z",        "message": "string"      }    ]  }}