Harthelm Docs
REST APITeams

Move the team's workspace volumes to the current UID

Cluster admins only. After `security.defaultUid` changed, re-owns every workspace volume of the team that still belongs to another UID: each workspace stops, a root Job runs `chown -R <uid>:0`, `g=u` and setgid on directories on the node that holds the volume, and the workspace starts again under the new UID. Soft-deleted workspaces are included, their volumes still exist. Follow the Operation (kind `workspace.volume_owner`); it fails when a volume could not be re-owned, and that workspace keeps running as its old UID. Answers 409 when no volume of the team needs it or a migration of the team still runs.

Generated from openapi/harthelm.yaml at v1.5.0
POST
/teams/{team}/volume-owner

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

team*integer

Numeric resource id.

Formatint64
Range1 <= value

Response Body

Accepted; follow the Operation.

application/json
  1. response

A long-running action. It ends in succeeded or failed and stays readable for 7 days.

id*string
Formatuuid
kind*string

What runs, for example workspace.create, workspace.delete, workspace.restore, workspace.volume_owner, landscape.sync, landscape.teardown, workspace.archive, workspace.restore_archive, managed_service.dump.

state*OperationState
Value in"pending""running""succeeded""failed"
target?string

API path of the resource the operation acts on, e.g. /workspaces/123.

detail?string

Human-readable progress, e.g. "Cloning repository".

error?

RFC 9457 problem details.

created_at*string
Formatdate-time
updated_at*string
Formatdate-time
finished_at?string
Formatdate-time
curl -X POST 'https://console.example.com/api/v1/teams/1/volume-owner'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "kind": "string",  "state": "pending",  "target": "string",  "detail": "string",  "error": {    "type": "about:blank",    "title": "string",    "status": 100,    "detail": "string",    "instance": "string",    "errors": [      {        "pointer": "string",        "line": 1,        "column": 1,        "message": "string",        "code": "string",        "subject": "string"      }    ],    "held_by_deleted": {      "workspaces": 0,      "storage_gib": 0    },    "failed_team": {      "id": 1,      "name": "string",      "reason": "string"    }  },  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "finished_at": "2019-08-24T14:15:22Z"}

List the caller's teams

The caller's teams; cluster admins see every team.

Override the team's quota

Cluster admins only (`platform.admin`). Replaces the override; quantities it leaves out take the installation default. Workspaces that run keep running when the new quota is smaller; the next create, Sync or wake is checked against it. Audited as `team.quota`.