Retrieves specified cluster workloads

POST 
https://api.spectrocloud.com/v1/dashboard/spectroclusters/:uid/workloads

Retrieves specified cluster workloads

Request

Path Parameters

uid stringrequired

Header Parameters

ProjectUid string

Scope the request to the specified project uid

application/json

Body

filter

object

Cluster workloads filter

namespacesstring[]

Responses

200

An array of cluster workloads

application/json

Schema

Schema

metadata

object

ObjectMeta input entity for object creation

annotations

object

Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations

property name*string

labels

object

Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels

property name*string

namestring

Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/identifiers#names

spec

object

Cluster workload spec

clusterroleBindings

object[]

Array [

metadata

object

Cluster workload metadata

creationTimestampdate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

entity

object

Cluster workload ref

kindstring

namestring

uidstring

labels

object

property name*string

namespacestring

spec

object

Cluster RBAC binding

namespacestring

role

object

Cluster role ref

kindstring

Possible values: [Role, ClusterRole]

namestring

subjects

object[]

Array [

namestring

namespacestring

typestring

Possible values: [User, Group, ServiceAccount]

]

typestring

Possible values: [RoleBinding, ClusterRoleBinding]

]

cronJobs

object[]

Array [

metadata

object

Cluster workload metadata

creationTimestampdate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

entity

object

Cluster workload ref

kindstring

namestring

uidstring

labels

object

property name*string

namespacestring

spec

object

Cluster workload cronjob spec

schedulestring

status

object

Cluster workload cronjob status

lastScheduleTimedate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

]

daemonSets

object[]

Array [

metadata

object

Cluster workload metadata

creationTimestampdate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

entity

object

Cluster workload ref

kindstring

namestring

uidstring

labels

object

property name*string

namespacestring

status

object

Cluster workload daemonset status

availableint32

currentScheduledint32

desiredScheduledint32

misScheduledint32

readyint32

updatedScheduledint32

]

deployments

object[]

Array [

metadata

object

Cluster workload metadata

creationTimestampdate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

entity

object

Cluster workload ref

kindstring

namestring

uidstring

labels

object

property name*string

namespacestring

status

object

Cluster workload deployment status

replicas

object

Cluster workload replica status

availableint32

readyint32

totalint32

updatedint32

]

jobs

object[]

Array [

metadata

object

Cluster workload metadata

creationTimestampdate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

entity

object

Cluster workload ref

kindstring

namestring

uidstring

labels

object

property name*string

namespacestring

status

object

Cluster workload job status

completionTimedate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

conditions

object[]

Array [

lastTransitionTimedate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

lastUpdateTimedate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

messagestring

reasonstring

statusstring

typestring

]

startTimedate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

succeededint32

]

pods

object[]

Array [

metadata

object

Cluster workload pod metadata

associatedRefs

object[]

Array [

kindstring

namestring

uidstring

]

creationTimestampdate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

entity

object

Cluster workload ref

kindstring

namestring

uidstring

labels

object

property name*string

machineUidstring

namespacestring

nodenamestring

spec

object

Cluster workload pod spec

containers

object[]

Array [

imagestring

namestring

resources

object

Cluster workload pod container resources

limits

object

Cluster workload pod container resource

cpuint32

cpuUnitstring

memoryint64

memoryUnitstring

requests

object

Cluster workload pod container resource

cpuint32

cpuUnitstring

memoryint64

memoryUnitstring

]

volumes

object[]

Array [

namestring

]

status

object

Cluster workload pod status

containers

object[]

Array [

imagestring

namestring

readyboolean

restartCountint32

startedboolean

state

object

Cluster workload pod container state

exitCodeint32

finishedAtdate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

reasonstring

startedAtdate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

statestring

]

phasestring

podIpstring

qosClassstring

]

roleBindings

object[]

Array [

metadata

object

Cluster workload metadata

creationTimestampdate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

entity

object

Cluster workload ref

kindstring

namestring

uidstring

labels

object

property name*string

namespacestring

spec

object

Cluster RBAC binding

namespacestring

role

object

Cluster role ref

kindstring

Possible values: [Role, ClusterRole]

namestring

subjects

object[]

Array [

namestring

namespacestring

typestring

Possible values: [User, Group, ServiceAccount]

]

typestring

Possible values: [RoleBinding, ClusterRoleBinding]

]

statefulSets

object[]

Array [

metadata

object

Cluster workload metadata

creationTimestampdate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

entity

object

Cluster workload ref

kindstring

namestring

uidstring

labels

object

property name*string

namespacestring

status

object

Cluster workload statefulset status

replicas

object

Cluster workload replica status

availableint32

readyint32

totalint32

updatedint32

]

Example (from schema)

{
  "metadata": {
    "annotations": {},
    "labels": {},
    "name": "string"
  },
  "spec": {
    "clusterroleBindings": [
      {
        "metadata": {
          "creationTimestamp": "2024-07-10T22:28:47.878Z",
          "entity": {
            "kind": "string",
            "name": "string",
            "uid": "string"
          },
          "labels": {},
          "namespace": "string"
        },
        "spec": {
          "namespace": "string",
          "role": {
            "kind": "Role",
            "name": "string"
          },
          "subjects": [
            {
              "name": "string",
              "namespace": "string",
              "type": "User"
            }
          ],
          "type": "RoleBinding"
        }
      }
    ],
    "cronJobs": [
      {
        "metadata": {
          "creationTimestamp": "2024-07-10T22:28:47.878Z",
          "entity": {
            "kind": "string",
            "name": "string",
            "uid": "string"
          },
          "labels": {},
          "namespace": "string"
        },
        "spec": {
          "schedule": "string"
        },
        "status": {
          "lastScheduleTime": "2024-07-10T22:28:47.878Z"
        }
      }
    ],
    "daemonSets": [
      {
        "metadata": {
          "creationTimestamp": "2024-07-10T22:28:47.878Z",
          "entity": {
            "kind": "string",
            "name": "string",
            "uid": "string"
          },
          "labels": {},
          "namespace": "string"
        },
        "status": {
          "available": 0,
          "currentScheduled": 0,
          "desiredScheduled": 0,
          "misScheduled": 0,
          "ready": 0,
          "updatedScheduled": 0
        }
      }
    ],
    "deployments": [
      {
        "metadata": {
          "creationTimestamp": "2024-07-10T22:28:47.878Z",
          "entity": {
            "kind": "string",
            "name": "string",
            "uid": "string"
          },
          "labels": {},
          "namespace": "string"
        },
        "status": {
          "replicas": {
            "available": 0,
            "ready": 0,
            "total": 0,
            "updated": 0
          }
        }
      }
    ],
    "jobs": [
      {
        "metadata": {
          "creationTimestamp": "2024-07-10T22:28:47.878Z",
          "entity": {
            "kind": "string",
            "name": "string",
            "uid": "string"
          },
          "labels": {},
          "namespace": "string"
        },
        "status": {
          "completionTime": "2024-07-10T22:28:47.878Z",
          "conditions": [
            {
              "lastTransitionTime": "2024-07-10T22:28:47.878Z",
              "lastUpdateTime": "2024-07-10T22:28:47.878Z",
              "message": "string",
              "reason": "string",
              "status": "string",
              "type": "string"
            }
          ],
          "startTime": "2024-07-10T22:28:47.878Z",
          "succeeded": 0
        }
      }
    ],
    "pods": [
      {
        "metadata": {
          "associatedRefs": [
            {
              "kind": "string",
              "name": "string",
              "uid": "string"
            }
          ],
          "creationTimestamp": "2024-07-10T22:28:47.878Z",
          "entity": {
            "kind": "string",
            "name": "string",
            "uid": "string"
          },
          "labels": {},
          "machineUid": "string",
          "namespace": "string",
          "nodename": "string"
        },
        "spec": {
          "containers": [
            {
              "image": "string",
              "name": "string",
              "resources": {
                "limits": {
                  "cpu": 0,
                  "cpuUnit": "string",
                  "memory": 0,
                  "memoryUnit": "string"
                },
                "requests": {
                  "cpu": 0,
                  "cpuUnit": "string",
                  "memory": 0,
                  "memoryUnit": "string"
                }
              }
            }
          ],
          "volumes": [
            {
              "name": "string"
            }
          ]
        },
        "status": {
          "containers": [
            {
              "image": "string",
              "name": "string",
              "ready": true,
              "restartCount": 0,
              "started": true,
              "state": {
                "exitCode": 0,
                "finishedAt": "2024-07-10T22:28:47.879Z",
                "reason": "string",
                "startedAt": "2024-07-10T22:28:47.879Z",
                "state": "string"
              }
            }
          ],
          "phase": "string",
          "podIp": "string",
          "qosClass": "string"
        }
      }
    ],
    "roleBindings": [
      {
        "metadata": {
          "creationTimestamp": "2024-07-10T22:28:47.879Z",
          "entity": {
            "kind": "string",
            "name": "string",
            "uid": "string"
          },
          "labels": {},
          "namespace": "string"
        },
        "spec": {
          "namespace": "string",
          "role": {
            "kind": "Role",
            "name": "string"
          },
          "subjects": [
            {
              "name": "string",
              "namespace": "string",
              "type": "User"
            }
          ],
          "type": "RoleBinding"
        }
      }
    ],
    "statefulSets": [
      {
        "metadata": {
          "creationTimestamp": "2024-07-10T22:28:47.879Z",
          "entity": {
            "kind": "string",
            "name": "string",
            "uid": "string"
          },
          "labels": {},
          "namespace": "string"
        },
        "status": {
          "replicas": {
            "available": 0,
            "ready": 0,
            "total": 0,
            "updated": 0
          }
        }
      }
    ]
  }
}

• curl
• python
• go
• nodejs
• java

• CURL

curl -L -X POST 'https://api.spectrocloud.com/v1/dashboard/spectroclusters/:uid/workloads' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'ApiKey: <API_KEY_VALUE>' \
--data-raw '{
  "filter": {
    "namespaces": [
      "string"
    ]
  }
}'

Request Collapse all

Base URL

https://api.spectrocloud.com

Auth

Security Scheme

ApiKeyAuthorization

ApiKey

Parameters

uid — pathrequired

ProjectUid — header

Body

{
  "filter": {
    "namespaces": [
      "string"
    ]
  }
}