Clusters

Cedana API for clusters

List clusters

get

Returns all clusters associated with the authenticated user's organization

Authorizations

Token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Returns a list of clusters

application/json

idstring · uuidRequired

last_syncstring · nullableOptional

metadataanyOptional

namestringRequired

statusstringRequired

500

Failed to fetch clusters from database

application/json

get

/v2/cluster

HTTPcURLJavaScriptPython

GET /v2/cluster HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "last_sync": null,
    "metadata": null,
    "name": "text",
    "status": "text"
  }
]

Create cluster

post

Creates or updates info regarding a Kubernetes cluster

Authorizations

Token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

CreateClusterRequest is the request body for creating a cluster

cluster_namestringRequired

Responses

200

Returns the cluster id for the newly created or updated cluster

text/plain

stringOptional

400

Bad request or missing cluster name

application/json

500

Failed to create cluster in database

application/json

post

/v2/cluster

HTTPcURLJavaScriptPython

POST /v2/cluster HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "cluster_name": "text"
}

550e8400-e29b-41d4-a716-446655440000

Sync cluster

post

Syncs cluster resources such as pods, jobs, and nodes

Authorizations

Token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

cluster_idstring · nullableOptional

metadataanyOptional

resourceone ofOptional

or

or

or

Responses

200

Resource id registered internally

application/json

Standard error response for API endpoints

codestring · nullableOptional

HTTP status code

detailsanyOptional

Optional additional error details

messagestringRequired

Error message describing what went wrong

400

Bad request

application/json

404

Cluster or node not found

application/json

500

Failed to sync resource to database

application/json

post

/v2/cluster/sync

HTTPcURLJavaScriptPython

POST /v2/cluster/sync HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 62

{
  "cluster_id": null,
  "metadata": null,
  "resource": {
    "type": "None"
  }
}

{
  "code": null,
  "details": null,
  "message": "text"
}

Create workload

post

Takes a cluster name and workload specification, then creates a Kubernetes job on the specified cluster

Body

application/json

cluster_idstringRequired

cluster_namestring · nullableOptionalDeprecated

deploymentanyOptional

jobanyOptional

podanyOptional

Responses

200

Added workload to queue

application/json

Standard error response for API endpoints

codestring · nullableOptional

HTTP status code

detailsanyOptional

Optional additional error details

messagestringRequired

Error message describing what went wrong

400

Error parsing body

application/json

500

Server error

application/json

post

/v2/cluster/workload

HTTPcURLJavaScriptPython

POST /v2/cluster/workload HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "cluster_id": "text",
  "deployment": null,
  "job": null,
  "pod": null
}

{
  "code": null,
  "details": null,
  "message": "text"
}

Delete cluster

delete

This endpoint deletes a cluster and all its dependent entities in a single transaction which is rolled back if any part of the deletion fails

Authorizations

Token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

Responses

200

Delete the given cluster, and return Status OK

No content

404

Cluster not found

application/json

500

Failed to delete cluster from database

application/json

delete

/v2/cluster/{id}

HTTPcURLJavaScriptPython

DELETE /v2/cluster/{id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content