Policy (Slurm)

Cedana API for policies (Slurm)

List maintenance windows

get

Returns all maintenance windows

Authorizations

Auth Token

Responses

200

Returns all SLURM maintenance windows

application/json

500

Failed to connect/fetch from database

application/json

get

/v2/slurm/maintenance_window

HTTPcURLJavaScriptPython

GET /v2/slurm/maintenance_window HTTP/1.1
Accept: */*

[
  {
    "created_at": null,
    "end_time": null,
    "id": null,
    "nodes": [
      "text"
    ],
    "partitions": [
      "text"
    ],
    "reason": null,
    "start_time": null,
    "status": null
  }
]

Create maintenance window

post

Creates a new maintenance window for SLURM clusters

Authorizations

Auth Token

Body

application/json

end_timestring · date-timeRequired

nodesstring[] · nullableOptional

partitionsstring[] · nullableOptional

reasonstringRequired

start_timestring · date-timeRequired

statusstring · nullableOptional

Responses

201

Returns the maintenance window id for the new maintenance window

text/plain

400

Invalid request parameters

application/json

500

Failed to connect/execute request against database

application/json

post

/v2/slurm/maintenance_window

HTTPcURLJavaScriptPython

POST /v2/slurm/maintenance_window HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 148

{
  "end_time": "2026-02-05T03:38:09.567Z",
  "nodes": [
    "text"
  ],
  "partitions": [
    "text"
  ],
  "reason": "text",
  "start_time": "2026-02-05T03:38:09.567Z",
  "status": null
}

<uuid-v4-here>

Get maintenance window

get

Returns a specific maintenance window by ID

Authorizations

Auth Token

Path parameters

idstringRequired

Responses

200

Returns the maintenance window

application/json

400

Invalid UUID provided

application/json

404

Maintenance window not found

application/json

500

Failed to connect/fetch from database

application/json

get

/v2/slurm/maintenance_window/{id}

HTTPcURLJavaScriptPython

GET /v2/slurm/maintenance_window/{id} HTTP/1.1
Accept: */*

{
  "created_at": null,
  "end_time": null,
  "id": null,
  "nodes": [
    "text"
  ],
  "partitions": [
    "text"
  ],
  "reason": null,
  "start_time": null,
  "status": null
}

Update maintenance window

put

Updates an existing maintenance window

Authorizations

Auth Token

Path parameters

idstringRequired

Body

application/json

end_timestring · nullableOptional

nodesstring[] · nullableOptional

partitionsstring[] · nullableOptional

reasonstring · nullableOptional

start_timestring · nullableOptional

statusstring · nullableOptional

Responses

200

Successfully updated maintenance window and returns id

text/plain

Responsestring

400

Invalid UUID provided

application/json

404

Maintenance window not found

application/json

500

Failed to connect/execute request against database

application/json

put

/v2/slurm/maintenance_window/{id}

HTTPcURLJavaScriptPython

PUT /v2/slurm/maintenance_window/{id} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 102

{
  "end_time": null,
  "nodes": [
    "text"
  ],
  "partitions": [
    "text"
  ],
  "reason": null,
  "start_time": null,
  "status": null
}

<uuid-for-maintenance-window>

Delete maintenance window

delete

Deletes a maintenance window by ID

Authorizations

Auth Token

Path parameters

idstringRequired

Responses

200

Successfully deleted maintenance window and returns id

text/plain

Responsestring

400

Invalid UUID provided

application/json

404

Maintenance window not found

application/json

500

Failed to connect/execute request against database

application/json

delete

/v2/slurm/maintenance_window/{id}

HTTPcURLJavaScriptPython

DELETE /v2/slurm/maintenance_window/{id} HTTP/1.1
Accept: */*

<uuid-for-maintenance-window>