Returns the associated profiles of a specified cluster

GET /v1/spectroclusters/:uid/profiles

Request

Path Parameters

uid stringrequired

Cluster uid

Query Parameters

includePackMeta string

includes pack meta such as schema, presets

Responses

application/json

Schema
Example (from schema)

Schema

profiles

object[]

required

Array [

metadata

object

ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.

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

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.

deletionTimestampdate-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.

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

lastModifiedTimestampdate-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.

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

namespacestring

Namespace defines the space within each name must be unique. An empty namespace is equivalent to the "default" namespace, but "default" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.

Must be a DNS_LABEL. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/namespaces

resourceVersionstring

An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.

Populated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

selfLinkstring

SelfLink is a URL representing this object. Populated by the system. Read-only.

uidstring

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

spec

object

Cluster profile spec response

cloudTypestring

Cluster profile cloud type

packs

object[]

Cluster profile packs array

Array [

metadata

object

ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.

annotations

object

property name*string

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.

deletionTimestampdate-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.

labels

object

property name*string

lastModifiedTimestampdate-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.

namestring

namespacestring

Must be a DNS_LABEL. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/namespaces

resourceVersionstring

Populated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

selfLinkstring

SelfLink is a URL representing this object. Populated by the system. Read-only.

uidstring

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

spec

object

Pack object

addonSubTypestring

Pack add-on sub type such as monitoring, db etc

addonTypestring

Pack add-on type such as logging, monitoring, security etc

annotations

object

Pack annotations is used to allow pack to add more arbitrary configurations

property name*string

cloudTypesstring[]

Possible values: [all, aws, azure, gcp, vsphere, openstack, maas, nested, baremetal, eks, aks, edge, edge-native, libvirt, tencent, tke, coxedge, generic, gke]

Pack supported cloud types

digeststring

Pack digest

displayNamestring

Pack display name

eolstring

Pack end of life, date format: yyyy-MM-dd

groupstring

Pack group

layerstring

Possible values: [kernel, os, k8s, cni, csi, addon]

logoUrlstring

Pack logo url

manifests

object[]

Pack manifests are additional content as part of the cluster profile

Array [

apiVersionstring

API version of the referent.

fieldPathstring

If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object.

kindstring

Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

namestring

Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

namespacestring

Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersionstring

Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

uidstring

UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

]

namestring

Pack name

presets

object[]

Pack presets are the set of configurations applied on user selection of presets

Array [

addstring

displayNamestring

groupstring

namestring

removestring[]

]

registryUidstring

Pack registry uid

schema

object[]

Pack schema contains constraints such as data type, format, hints for the pack values

Array [

formatstring

hintsstring[]

listOptionsstring[]

namestring

readonlyboolean

regexstring

requiredboolean

typestring

]

template

Pack template configuration

manifeststring

Pack template manifest content

parameters

Pack template parameters

inputParameters

undefined[]

Pack template input parameters array

Array [

descriptionstring

Pack template parameter description

displayNamestring

Pack template parameter display name

formatstring

Pack template parameter format

hiddenboolean

Pack template parameter hidden flag, if true then the parameter is hidden in the UI

listOptionsstring[]

Pack template parameter list options as string array

namestring

Pack template parameter name

optionalboolean

Pack template parameter optional flag, if true then the parameter value is not mandatory

options

object

Pack template parameter options array

property name*

object

Pack template parameter option

dependencies

object[]

Pack template parameter dependencies

Array [

layerstring

Pack template dependency pack layer

namestring

Pack template dependency pack name

readOnlyboolean

If true then dependency pack values can't be overridden

]

descriptionstring

Pack template parameter description

labelstring

Pack template parameter label

readOnlyboolean

Pack template parameter readonly flag, if true then the parameter value can't be overridden

regexstring

Pack template parameter regex, if set then parameter value must match with specified regex

targetKeystring

Pack template parameter target key which is mapped to the key defined in the pack values

typestring

Pack template parameter data type

valuestring

Pack template parameter value

]

outputParameters

undefined[]

Pack template output parameters array

Array [

descriptionstring

Pack template parameter description

displayNamestring

Pack template parameter display name

formatstring

Pack template parameter format

hiddenboolean

Pack template parameter hidden flag, if true then the parameter is hidden in the UI

listOptionsstring[]

Pack template parameter list options as string array

namestring

Pack template parameter name

optionalboolean

Pack template parameter optional flag, if true then the parameter value is not mandatory

options

object

Pack template parameter options array

property name*

object

Pack template parameter option

dependencies

object[]

Pack template parameter dependencies

Array [

layerstring

Pack template dependency pack layer

namestring

Pack template dependency pack name

readOnlyboolean

If true then dependency pack values can't be overridden

]

descriptionstring

Pack template parameter description

labelstring

Pack template parameter label

readOnlyboolean

Pack template parameter readonly flag, if true then the parameter value can't be overridden

regexstring

Pack template parameter regex, if set then parameter value must match with specified regex

targetKeystring

Pack template parameter target key which is mapped to the key defined in the pack values

typestring

Pack template parameter data type

valuestring

Pack template parameter value

]

valuesstring

Pack template values

typestring

Possible values: [spectro, helm, manifest, oci]

Default value: spectro

valuesstring

Pack values

versionstring

Pack version

statusobject

Pack status

]

typestring

Cluster profile type [ "cluster", "infra", "add-on", "system" ]

versionint32

Cluster profile version

]

{
  "profiles": [
    {
      "metadata": {
        "annotations": {},
        "creationTimestamp": "2024-07-29T15:51:28.071Z",
        "deletionTimestamp": "2024-07-29T15:51:28.071Z",
        "labels": {},
        "lastModifiedTimestamp": "2024-07-29T15:51:28.071Z",
        "name": "string",
        "namespace": "string",
        "resourceVersion": "string",
        "selfLink": "string",
        "uid": "string"
      },
      "spec": {
        "cloudType": "string",
        "packs": [
          {
            "metadata": {
              "annotations": {},
              "creationTimestamp": "2024-07-29T15:51:28.071Z",
              "deletionTimestamp": "2024-07-29T15:51:28.071Z",
              "labels": {},
              "lastModifiedTimestamp": "2024-07-29T15:51:28.071Z",
              "name": "string",
              "namespace": "string",
              "resourceVersion": "string",
              "selfLink": "string",
              "uid": "string"
            },
            "spec": {
              "addonSubType": "string",
              "addonType": "string",
              "annotations": {},
              "cloudTypes": [
                "all"
              ],
              "digest": "string",
              "displayName": "string",
              "eol": "string",
              "group": "string",
              "layer": "kernel",
              "logoUrl": "string",
              "manifests": [
                {
                  "apiVersion": "string",
                  "fieldPath": "string",
                  "kind": "string",
                  "name": "string",
                  "namespace": "string",
                  "resourceVersion": "string",
                  "uid": "string"
                }
              ],
              "name": "string",
              "presets": [
                {
                  "add": "string",
                  "displayName": "string",
                  "group": "string",
                  "name": "string",
                  "remove": [
                    "string"
                  ]
                }
              ],
              "registryUid": "string",
              "schema": [
                {
                  "format": "string",
                  "hints": [
                    "string"
                  ],
                  "listOptions": [
                    "string"
                  ],
                  "name": "string",
                  "readonly": true,
                  "regex": "string",
                  "required": true,
                  "type": "string"
                }
              ],
              "template": {
                "manifest": "string",
                "parameters": {
                  "inputParameters": [
                    {
                      "description": "string",
                      "displayName": "string",
                      "format": "string",
                      "hidden": true,
                      "listOptions": [
                        "string"
                      ],
                      "name": "string",
                      "optional": true,
                      "options": {},
                      "readOnly": true,
                      "regex": "string",
                      "targetKey": "string",
                      "type": "string",
                      "value": "string"
                    }
                  ],
                  "outputParameters": [
                    {
                      "description": "string",
                      "displayName": "string",
                      "format": "string",
                      "hidden": true,
                      "listOptions": [
                        "string"
                      ],
                      "name": "string",
                      "optional": true,
                      "options": {},
                      "readOnly": true,
                      "regex": "string",
                      "targetKey": "string",
                      "type": "string",
                      "value": "string"
                    }
                  ]
                },
                "values": "string"
              },
              "type": "spectro",
              "values": "string",
              "version": "string"
            },
            "status": {}
          }
        ],
        "type": "string",
        "version": 0
      }
    }
  ]
}

Returns the associated profiles of a specified cluster

/v1/spectroclusters/:uid/profiles

Request​

Path Parameters

Query Parameters

Responses​

Request

Responses