Spectro Cloud clustergroups API
The clustergroups API from Spectro Cloud — 10 operation(s) for clustergroups.
The clustergroups API from Spectro Cloud — 10 operation(s) for clustergroups.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/spectro-cloud-clustergroups-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Local Management APIs activations Clustergroups API
version: v1
servers:
- url: https://edge-host-ip:5080
tags:
- name: clustergroups
x-displayName: Clustergroups
paths:
/v1/clustergroups:
post:
operationId: v1ClusterGroupsCreate
parameters:
- description: A project UID is required for project-scoped resources and should be omitted when targeting tenant-scoped resources
in: header
name: ProjectUid
schema:
type: string
responses:
'201':
description: Created successfully
headers:
AuditUid:
description: Audit uid for the request
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/v1Uid'
security:
- ApiKey: []
- Authorization: []
summary: Create cluster groups
tags:
- clustergroups
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/v1ClusterGroupEntity'
/v1/clustergroups/developerCredit/usage/{scope}:
parameters:
- in: path
name: scope
required: true
schema:
type: string
enum:
- system
- tenant
get:
operationId: v1ClusterGroupsDeveloperCreditUsageGet
parameters:
- description: A project UID is required for project-scoped resources and should be omitted when targeting tenant-scoped resources
in: header
name: ProjectUid
schema:
type: string
responses:
'200':
description: Cluster group developer credit usage
content:
application/json:
schema:
$ref: '#/components/schemas/v1ClusterGroupsDeveloperCreditUsage'
security:
- ApiKey: []
- Authorization: []
summary: Get cluster group developer credit usage by scope
tags:
- clustergroups
/v1/clustergroups/hostCluster:
get:
operationId: v1ClusterGroupsHostClusterSummary
parameters:
- description: A project UID is required for project-scoped resources and should be omitted when targeting tenant-scoped resources
in: header
name: ProjectUid
schema:
type: string
responses:
'200':
description: An array of cluster groups of host cluster type summary
content:
application/json:
schema:
$ref: '#/components/schemas/v1ClusterGroupsHostClusterSummary'
security:
- ApiKey: []
- Authorization: []
summary: Retrieves a list of cluster groups host cluster summary
tags:
- clustergroups
/v1/clustergroups/hostCluster/metadata:
get:
operationId: v1ClusterGroupsHostClusterMetadata
parameters:
- description: A project UID is required for project-scoped resources and should be omitted when targeting tenant-scoped resources
in: header
name: ProjectUid
schema:
type: string
responses:
'200':
description: An array of cluster groups host cluster metadata items
content:
application/json:
schema:
$ref: '#/components/schemas/v1ClusterGroupsHostClusterMetadata'
security:
- ApiKey: []
- Authorization: []
summary: Retrieves a list of cluster groups host cluster metadata
tags:
- clustergroups
/v1/clustergroups/validate/name:
get:
operationId: v1ClusterGroupsValidateName
parameters:
- in: query
name: name
required: true
schema:
type: string
- description: A project UID is required for project-scoped resources and should be omitted when targeting tenant-scoped resources
in: header
name: ProjectUid
schema:
type: string
responses:
'204':
description: Ok response without content
headers:
AuditUid:
description: Audit uid for the request
schema:
type: string
security:
- ApiKey: []
- Authorization: []
summary: Validates the cluster groups name
tags:
- clustergroups
/v1/clustergroups/{uid}:
parameters:
- in: path
name: uid
required: true
schema:
type: string
delete:
operationId: v1ClusterGroupsUidDelete
parameters:
- description: A project UID is required for project-scoped resources and should be omitted when targeting tenant-scoped resources
in: header
name: ProjectUid
schema:
type: string
responses:
'204':
description: The resource was deleted successfully
security:
- ApiKey: []
- Authorization: []
summary: Deletes the specified cluster group
tags:
- clustergroups
get:
operationId: v1ClusterGroupsUidGet
parameters:
- description: A project UID is required for project-scoped resources and should be omitted when targeting tenant-scoped resources
in: header
name: ProjectUid
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/v1ClusterGroup'
security:
- ApiKey: []
- Authorization: []
summary: Returns the specified cluster groups
tags:
- clustergroups
/v1/clustergroups/{uid}/hostCluster:
parameters:
- in: path
name: uid
required: true
schema:
type: string
put:
operationId: v1ClusterGroupsUidHostClusterUpdate
parameters:
- description: A project UID is required for project-scoped resources and should be omitted when targeting tenant-scoped resources
in: header
name: ProjectUid
schema:
type: string
responses:
'204':
description: The resource was updated successfully
security:
- ApiKey: []
- Authorization: []
summary: Updates cluster reference and host cluster config
tags:
- clustergroups
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/v1ClusterGroupHostClusterEntity'
/v1/clustergroups/{uid}/meta:
parameters:
- in: path
name: uid
required: true
schema:
type: string
put:
operationId: v1ClusterGroupsUidMetaUpdate
parameters:
- description: A project UID is required for project-scoped resources and should be omitted when targeting tenant-scoped resources
in: header
name: ProjectUid
schema:
type: string
responses:
'204':
description: The resource was updated successfully
security:
- ApiKey: []
- Authorization: []
summary: Updates the specified cluster groups meta
tags:
- clustergroups
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/v1ObjectMeta'
/v1/clustergroups/{uid}/packs/resolvedValues:
parameters:
- description: Cluster group uid
in: path
name: uid
required: true
schema:
type: string
get:
operationId: v1ClusterGroupsUidPacksResolvedValuesGet
parameters:
- description: A project UID is required for project-scoped resources and should be omitted when targeting tenant-scoped resources
in: header
name: ProjectUid
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/v1SpectroClusterProfilesResolvedValues'
security:
- ApiKey: []
- Authorization: []
summary: Returns the specified clustergroup's profile packs resolved values
tags:
- clustergroups
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/v1SpectroClusterProfilesParamReferenceEntity'
/v1/clustergroups/{uid}/profiles:
parameters:
- description: ClusterGroup uid
in: path
name: uid
required: true
schema:
type: string
get:
operationId: v1ClusterGroupsUidProfilesGet
parameters:
- description: includes pack meta such as schema, presets
in: query
name: includePackMeta
schema:
type: string
- description: A project UID is required for project-scoped resources and should be omitted when targeting tenant-scoped resources
in: header
name: ProjectUid
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/v1SpectroClusterProfileList'
security:
- ApiKey: []
- Authorization: []
summary: Returns the associated profiles of a specified cluster group
tags:
- clustergroups
put:
operationId: v1ClusterGroupsUidProfilesUpdate
parameters:
- description: A project UID is required for project-scoped resources and should be omitted when targeting tenant-scoped resources
in: header
name: ProjectUid
schema:
type: string
responses:
'204':
description: The resource was updated successfully
security:
- ApiKey: []
- Authorization: []
summary: Updates the specified cluster groups profiles
tags:
- clustergroups
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/v1SpectroClusterProfiles'
components:
schemas:
v1ClusterProfilePacksEntity:
description: Cluster profile packs object
properties:
metadata:
$ref: '#/components/schemas/v1ObjectMeta'
spec:
$ref: '#/components/schemas/v1PackSummarySpec'
status:
$ref: '#/components/schemas/v1PackSummaryStatus'
type: object
v1PackTemplate:
description: Pack template configuration
properties:
manifest:
description: Pack template manifest content
type: string
parameters:
$ref: '#/components/schemas/v1PackTemplateParameters'
values:
description: Pack template values
type: string
v1ObjectScopeEntity:
description: Object scope identity meta
properties:
name:
type: string
scope:
type: string
uid:
type: string
type: object
v1IngressConfig:
description: Ingress configuration for exposing the virtual cluster's kube-apiserver
properties:
host:
type: string
port:
format: int64
type: integer
v1PackSummarySpec:
description: Pack object
properties:
addonSubType:
description: Pack add-on sub type such as monitoring, db etc
type: string
addonType:
description: Pack add-on type such as logging, monitoring, security etc
type: string
annotations:
additionalProperties:
type: string
description: Pack annotations is used to allow pack to add more arbitrary configurations
type: object
cloudTypes:
description: Pack supported cloud types
items:
type: string
type: array
digest:
description: Pack digest
type: string
displayName:
description: Pack display name
type: string
eol:
description: 'Pack end of life, date format: yyyy-MM-dd'
type: string
group:
description: Pack group
type: string
layer:
$ref: '#/components/schemas/v1PackLayer'
logoUrl:
description: Pack logo url
type: string
manifests:
description: Pack manifests are additional content as part of the cluster profile
items:
$ref: '#/components/schemas/v1ObjectReference'
type: array
name:
description: Pack name
type: string
presets:
description: Pack presets are the set of configurations applied on user selection of presets
items:
$ref: '#/components/schemas/v1PackPreset'
type: array
registryUid:
description: Pack registry uid
type: string
schema:
description: Pack schema contains constraints such as data type, format, hints for the pack values
items:
$ref: '#/components/schemas/v1PackSchema'
type: array
template:
$ref: '#/components/schemas/v1PackTemplate'
type:
$ref: '#/components/schemas/v1PackType'
values:
description: Pack values
type: string
version:
description: Pack version
type: string
type: object
v1ObjectMeta:
description: ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
properties:
annotations:
additionalProperties:
type: string
description: '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'
type: object
creationTimestamp:
$ref: '#/components/schemas/v1Time'
description: 'CreationTimestamp is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC.
Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata'
deletionTimestamp:
$ref: '#/components/schemas/v1Time'
description: 'DeletionTimestamp is RFC 3339 date and time at which this resource will be deleted. This field is set by the server when a graceful deletion is requested by the user, and is not directly settable by a client. The resource is expected to be deleted (no longer visible from resource lists, and not reachable by name) after the time in this field, once the finalizers list is empty. As long as the finalizers list contains items, deletion is blocked. Once the deletionTimestamp is set, this value may not be unset or be set further into the future, although it may be shortened or the resource may be deleted prior to this time. For example, a user may request that a pod is deleted in 30 seconds. The Kubelet will react by sending a graceful termination signal to the containers in the pod. After that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) to the container and after cleanup, remove the pod from the API. In the presence of network partitions, this object may still exist after this timestamp, until an administrator or automated process can determine the resource is fully terminated. If not set, graceful deletion of the object has not been requested.
Populated by the system when a graceful deletion is requested. Read-only. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata'
labels:
additionalProperties:
type: string
description: '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'
type: object
lastModifiedTimestamp:
$ref: '#/components/schemas/v1Time'
description: 'LastModifiedTimestamp is a timestamp representing the server time when this object was last modified. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC.
Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata'
name:
description: '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'
type: string
uid:
description: 'UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.
Populated by the system. Read-only. More info: http://kubernetes.io/docs/user-guide/identifiers#uids'
type: string
type: object
v1PackTemplateParameters:
description: Pack template parameters
properties:
inputParameters:
description: Pack template input parameters array
items:
$ref: '#/components/schemas/v1PackTemplateParameter'
type: array
outputParameters:
description: Pack template output parameters array
items:
$ref: '#/components/schemas/v1PackTemplateParameter'
type: array
v1SpectroClusterProfilesResolvedValues:
description: Cluster profiles resolved values response
properties:
profiles:
items:
$ref: '#/components/schemas/v1ProfileResolvedValues'
type: array
uniqueItems: true
type: object
v1Time:
description: 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.
format: date-time
type: string
v1ProfileResolvedValues:
description: Cluster profile resolved pack values
properties:
resolved:
additionalProperties:
type: string
description: Cluster profile pack resolved values
type: object
uid:
description: Cluster profile uid
type: string
v1ClusterGroupsHostClusterSummary:
properties:
summaries:
items:
$ref: '#/components/schemas/v1ClusterGroupSummary'
type: array
uniqueItems: true
required:
- summaries
type: object
v1ClusterProfileTemplate:
description: ClusterProfileTemplate contains details of a clusterprofile definition
properties:
cloudType:
type: string
name:
type: string
packServerRefs:
description: PackServerRefs is only used on Hubble side it is reference to pack registry servers which PackRef belongs to in hubble, pack server is a top level object, so use a reference to point to it packs within a clusterprofile can come from different pack servers, so this is an array
items:
$ref: '#/components/schemas/v1ObjectReference'
type: array
packServerSecret:
description: This secret is used only on Palette side use case is similar to k8s image pull secret this single secret internally should contains all the pack servers in PackServerRefs if empty, means no credential is needed to access the pack server For spectro saas, Ally will set this field before pass to palette
type: string
packs:
description: Packs definitions here are final definitions. If ClonedFrom and ParamsOverwrite is present, then Packs are the final merge result of ClonedFrom and ParamsOverwrite So orchestration engine will just take the Packs and do the work, no need to worry about parameters merge
items:
$ref: '#/components/schemas/v1PackRef'
type: array
profileVersion:
description: version start from 1.0.0, matching the index of ClusterProfileSpec.Versions[] will be used by clusterSpec to identify which version is applied to the cluster
type: string
relatedObject:
$ref: '#/components/schemas/v1ObjectReference'
description: RelatedObject refers to the type of object(clustergroup, cluster or edgeHost) the cluster profile is associated with
type:
type: string
uid:
type: string
version:
description: Deprecated. Use profileVersion
format: int32
type: integer
type: object
v1PackRef:
description: PackRef server/name:tag to point to a pack PackRef is used when construct a ClusterProfile PackSpec is used for UI to render the parameters form ClusterProfile will not know inner details of a pack ClusterProfile only contain pack name:tag, and the param values user entered for it
properties:
annotations:
additionalProperties:
type: string
description: Annotations is used to allow packref to add more arbitrary information one example is to add git reference for values.yaml
type: object
digest:
description: digest is used to specify the version should be installed by palette when pack upgrade available, change this digest to trigger upgrade
type: string
inValidReason:
type: string
isInvalid:
description: pack is invalid when the associated tag is deleted from the registry
type: boolean
layer:
enum:
- kernel
- os
- k8s
- cni
- csi
- addon
type: string
logo:
description: path to the pack logo
type: string
manifests:
items:
$ref: '#/components/schemas/v1ObjectReference'
type: array
name:
description: pack name
type: string
packUid:
description: PackUID is Hubble packUID, not palette Pack.UID It is used by Hubble only.
type: string
params:
additionalProperties:
type: string
description: params passed as env variables to be consumed at installation time
type: object
presets:
items:
$ref: '#/components/schemas/v1PackPreset'
type: array
registryUid:
description: pack registry uid
type: string
schema:
items:
$ref: '#/components/schemas/v1PackSchema'
type: array
server:
description: pack registry server or helm repo
type: string
tag:
description: pack tag
type: string
type:
description: type of the pack
enum:
- spectro
- helm
- manifest
- oci
type: string
values:
description: values represents the values.yaml used as input parameters either Params OR Values should be used, not both If both applied at the same time, will only use Values
type: string
version:
description: pack version
type: string
required:
- layer
- name
type: object
v1Uid:
properties:
uid:
type: string
required:
- uid
type: object
v1ClusterGroupStatus:
description: Cluster group status
properties:
isActive:
type: boolean
x-omitempty: false
v1ClusterGroupSpecEntity:
description: Cluster group specifications request entity
properties:
clusterRefs:
items:
$ref: '#/components/schemas/v1ClusterGroupClusterRef'
type: array
uniqueItems: true
clustersConfig:
$ref: '#/components/schemas/v1ClusterGroupClustersConfig'
profiles:
items:
$ref: '#/components/schemas/v1SpectroClusterProfileEntity'
type: array
type:
enum:
- hostCluster
type: string
v1ClusterGroupResource:
description: Cluster group resource allocated and usage information
properties:
allocated:
format: float64
type: number
x-omitempty: false
used:
format: float64
type: number
x-omitempty: false
v1PackValuesEntity:
description: Pack values entity to refer the existing pack for the values override
properties:
manifests:
description: Pack manifests are additional content as part of the profile
items:
$ref: '#/components/schemas/v1ManifestRefUpdateEntity'
type: array
name:
description: Pack name
type: string
tag:
description: Pack version tag
type: string
type:
$ref: '#/components/schemas/v1PackType'
values:
description: Pack values represents the values.yaml used as input parameters either Params OR Values should be used, not both If both applied at the same time, will only use Values
type: string
required:
- name
type: object
v1SpcApplySettings:
properties:
actionType:
enum:
- DownloadAndInstall
- DownloadAndInstallLater
type: string
type: object
v1SpectroClusterProfileSpec:
description: Cluster profile spec response
properties:
cloudType:
description: Cluster profile cloud type
type: string
packs:
description: Cluster profile packs array
items:
$ref: '#/components/schemas/v1ClusterProfilePacksEntity'
type: array
uniqueItems: true
relatedObject:
$ref: '#/components/schemas/v1ObjectReference'
description: RelatedObject refers to the type of object(clustergroup, cluster or edgeHost) the cluster profile is associated with
type:
description: Cluster profile type [ "cluster", "infra", "add-on", "system" ]
type: string
version:
description: Cluster profile version
format: int32
type: integer
type: object
v1ClusterGroupLimitConfig:
description: Cluster group limit config
properties:
cpu:
description: Deprecated. Use field cpuMilliCore
format: int32
type: integer
cpuMilliCore:
description: CPU in milli cores
format: int32
type: integer
memory:
description: Deprecated. Use field memoryMiB
format: int32
type: integer
memoryMiB:
description: Memory in MiB
format: int32
type: integer
overSubscription:
description: Over subscription percentage
format: int32
type: integer
storageGiB:
description: Storage in GiB
format: int32
type: integer
v1ClusterGroup:
description: Cluster group information
properties:
metadata:
$ref: '#/components/schemas/v1ObjectMeta'
spec:
$ref: '#/components/schemas/v1ClusterGroupSpec'
status:
$ref: '#/components/schemas/v1ClusterGroupStatus'
v1ClusterGroupClusterRef:
description: Cluster group cluster reference
properties:
clusterName:
type: string
clusterUid:
type: string
v1ClusterGroupSummarySpec:
description: Cluster group summay spec
properties:
clusterProfileTemplates:
items:
$ref: '#/components/schemas/v1ClusterProfileTemplateMeta'
type: array
cpu:
$ref: '#/components/schemas/v1ClusterGroupResource'
description: Deprecated
endpointType:
enum:
- Ingress
- LoadBalancer
type: string
hostClusters:
items:
$ref: '#/components/schemas/v1ObjectResReference'
type: array
uniqueItems: true
hostClustersCount:
type: integer
x-omitempty: false
kubernetesDistroType:
$ref: '#/components/schemas/v1ClusterKubernetesDistroType'
memory:
$ref: '#/components/schemas/v1ClusterGroupResource'
description: Deprecated
scope:
type: string
virtualClustersCount:
type: integer
x-omitempty: false
v1ClusterProfileTemplateMeta:
description: Cluster profile template meta information
properties:
cloudType:
type: string
name:
description: Cluster profile name
type: string
packs:
description: Cluster profile packs array
items:
$ref: '#/components/schemas/v1PackRef'
type: array
scope:
description: scope or context(system, tenant or project)
type: string
type:
description: Cluster profile type [ "cluster", "infra", "add-on", "system" ]
type: string
uid:
description: Cluster profile uid
type: string
version:
format: int32
type: integer
type: object
v1ManifestRefUpdateEntity:
description: Manifest update request payload
properties:
content:
description: Manifest content in yaml
type: string
name:
description: Manifest name
type: string
uid:
description: Manifest uid
type: string
required:
- name
v1ClusterGroupsHostClusterMetadata:
properties:
items:
items:
$ref: '#/components/schemas/v1ObjectScopeEntity'
type: array
uniqueItems: true
required:
- items
type: object
v1SpectroClusterProfile:
description: Cluster profile response
properties:
metadata:
$ref: '#/components/schemas/v1ObjectMeta'
spec:
$ref: '#/components/schemas/v1SpectroClusterProfileSpec'
type: object
v1SpectroClusterProfileEntity:
description: Cluster profile request payload
properties:
packValues:
description: Cluster profile packs array
items:
$ref: '#/components/schemas/v1PackValuesEntity'
type: array
uniqueItems: true
replaceWithProfile:
description: Cluster profile uid to be replaced with new profile
type: string
uid:
description: Cluster profile uid
type: string
variables:
items:
$ref: '#/components/schemas/v1SpectroClusterVariable'
type: array
type: object
v1PackPreset:
description: PackPreset defines the preset pack values
properties:
add:
type: string
x-omitempty: false
displayName:
type: string
x-omitempty: false
group:
type: string
x-omitempty: false
name:
type: string
x-omitempty: false
remove:
items:
type: string
type: array
x-omitempty: false
type: object
v1PackDependency:
description: Pack template dependency
properties:
layer:
description: Pack template dependency pack layer
type: string
name:
description: Pack template dependency pack name
type: string
readOnly:
description: If true then dependency pack values can't be overridden
type: boolean
type: object
v1ClusterGroupsDeveloperCreditUsage:
description: Cluster group resource allocated and usage information
properties:
allocatedCredit:
$ref: '#/components/schemas/v1DeveloperCred
# --- truncated at 32 KB (41 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/spectro-cloud/refs/heads/main/openapi/spectro-cloud-clustergroups-api-openapi.yml