Categorygithub.com/maltejk/metakube-go-client
module
0.0.0-20220330190035-192cafebce43
Repository: https://github.com/maltejk/metakube-go-client.git
Documentation: pkg.go.dev

# README

MetaKube API.

This describes possible operations which can be made against the MetaKube API.

Informations

Version

2.18

Terms Of Service

https://www.syseleven.de/agb-sla-metakube

Content negotiation

URI Schemes

  • https

Consumes

  • application/json

Produces

  • application/octet-stream
  • application/json
  • application/yaml

Access control

Security Schemes

api_key (header: Authorization)

Type: apikey

Security Requirements

  • api_key

All endpoints

addon

MethodURINameSummary
POST/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/addonscreate addon
POST/api/v2/projects/{project_id}/clusters/{cluster_id}/addonscreate addon v2
DELETE/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/addons/{addon_id}delete addonDeletes the given addon that belongs to the cluster.
DELETE/api/v2/projects/{project_id}/clusters/{cluster_id}/addons/{addon_id}delete addon v2Deletes the given addon that belongs to the cluster.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/addons/{addon_id}get addonGets an addon that is assigned to the given cluster.
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/addons/{addon_id}get addon v2Gets an addon that is assigned to the given cluster.
POST/api/v1/addonslist accessible addons
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/addonslist addons
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/addonslist addons v2
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/installableaddonslist installable addons
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/installableaddonslist installable addons v2
PATCH/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/addons/{addon_id}patch addonPatches an addon that is assigned to the given cluster.
PATCH/api/v2/projects/{project_id}/clusters/{cluster_id}/addons/{addon_id}patch addon v2Patches an addon that is assigned to the given cluster.

admin

MethodURINameSummary
PUT/api/v1/admin/metering/configurationscreate or update metering configurations
PUT/api/v1/admin/metering/credentialscreate or update metering credentials
DELETE/api/v1/admin/admission/plugins/{name}delete admission pluginDeletes the admission plugin.
DELETE/api/v1/admin/seeds/{seed_name}delete seedDeletes the seed CRD object from the Kubermatic.
GET/api/v1/adminget adminsReturns list of admin users.
GET/api/v1/admin/admission/plugins/{name}get admission pluginGets the admission plugin.
GET/api/v1/admin/settings/customlinksget kubermatic custom linksGets the custom links.
GET/api/v1/admin/settingsget kubermatic settingsGets the global settings.
GET/api/v1/admin/seeds/{seed_name}get seedReturns the seed object.
GET/api/v1/admin/admission/pluginslist admission pluginsReturns all admission plugins from the CRDs.
GET/api/v1/admin/seedslist seedsReturns all seeds from the CRDs.
PATCH/api/v1/admin/settingspatch kubermatic settingsPatches the global settings.
PUT/api/v1/adminset adminAllows setting and clearing admin role for users.
PATCH/api/v1/admin/admission/plugins/{name}update admission pluginUpdates the admission plugin.
PATCH/api/v1/admin/seeds/{seed_name}update seedUpdates the seed.

alibaba

MethodURINameSummary
GET/api/v1/providers/alibaba/instancetypeslist alibaba instance typesLists available Alibaba instance types.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/alibaba/instancetypeslist alibaba instance types no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/alibaba/instancetypeslist alibaba instance types no credentials v2
GET/api/v1/providers/alibaba/vswitcheslist alibaba v switchesLists available Alibaba vSwitches.
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/alibaba/vswitcheslist alibaba v switches no credentials v2
GET/api/v1/providers/alibaba/zoneslist alibaba zonesLists available Alibaba zones.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/alibaba/zoneslist alibaba zones no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/alibaba/zoneslist alibaba zones no credentials v2

allowedregistries

MethodURINameSummary
DELETE/api/v2/allowedregistries/{allowed_registry}delete allowed registryDeletes the given allowed registry.
GET/api/v2/allowedregistries/{allowed_registry}get allowed registry
PATCH/api/v2/allowedregistries/{allowed_registry}patch allowed registry

allowedregistry

MethodURINameSummary
POST/api/v2/allowedregistriescreate allowed registry
GET/api/v2/allowedregistrieslist allowed registriesList allowed registries.

anexia

MethodURINameSummary
GET/api/v1/providers/anexia/templateslist anexia templates
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/anexia/templateslist anexia templates no credentials v2
GET/api/v1/providers/anexia/vlanslist anexia vlans
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/anexia/vlanslist anexia vlans no credentials v2

aws

MethodURINameSummary
GET/api/v1/providers/aws/{dc}/securitygroupslist a w s security groups
GET/api/v1/providers/aws/sizeslist a w s sizesLists available AWS sizes.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/aws/sizeslist a w s sizes no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/aws/sizeslist a w s sizes no credentials v2
GET/api/v1/providers/aws/{dc}/subnetslist a w s subnets
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/aws/subnetslist a w s subnets no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/aws/subnetslist a w s subnets no credentials v2
GET/api/v1/providers/aws/{dc}/vpcslist a w s v p c s

azure

MethodURINameSummary
GET/api/v1/providers/azure/availabilityzoneslist azure availability zones
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/azure/availabilityzoneslist azure availability zones no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/azure/availabilityzoneslist azure availability zones no credentials v2
GET/api/v2/providers/azure/resourcegroupslist azure resource groups
GET/api/v2/providers/azure/routetableslist azure route tables
GET/api/v2/providers/azure/securitygroupslist azure security groups
GET/api/v1/providers/azure/sizeslist azure sizes
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/azure/sizeslist azure sizes no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/azure/sizeslist azure sizes no credentials v2
GET/api/v2/providers/azure/subnetslist azure subnets
GET/api/v2/providers/azure/vnetslist azure vnets

backupcredentials

MethodURINameSummary
PUT/api/v2/seeds/{seed_name}/backupcredentialscreate or update backup credentials

constraint

MethodURINameSummary
POST/api/v2/constraintscreate default constraint
GET/api/v2/constraints/{constraint_name}get default constraint
GET/api/v2/constraintslist default constraintList default constraint.
PATCH/api/v2/constraints/{constraint_name}patch default constraint

constraints

MethodURINameSummary
DELETE/api/v2/constraints/{constraint_name}delete default constraintDeletes a specified default constraint.

constrainttemplates

MethodURINameSummary
POST/api/v2/constrainttemplatescreate constraint template
DELETE/api/v2/constrainttemplates/{ct_name}delete constraint template
GET/api/v2/constrainttemplates/{ct_name}get constraint template
GET/api/v2/constrainttemplateslist constraint templatesList constraint templates.
PATCH/api/v2/constrainttemplates/{ct_name}patch constraint template

credentials

MethodURINameSummary
GET/api/v1/providers/{provider_name}/presets/credentialslist credentials

datacenter

MethodURINameSummary
POST/api/v1/seed/{seed_name}/dccreate d cCreate the datacenter for a specified seed.
DELETE/api/v1/seed/{seed_name}/dc/{dc}delete d cDelete the datacenter.
GET/api/v1/providers/{provider_name}/dc/{dc}get d c for providerGet the datacenter for the specified provider.
GET/api/v1/seed/{seed_name}/dc/{dc}get d c for seedReturns the specified datacenter for the specified seed.
GET/api/v1/dc/{dc}get datacenter
GET/api/v1/providers/{provider_name}/dclist d c for providerReturns all datacenters for the specified provider.
GET/api/v1/seed/{seed_name}/dclist d c for seedReturns all datacenters for the specified seed.
GET/api/v1/dclist datacenters
PATCH/api/v1/seed/{seed_name}/dc/{dc}patch d cPatch the datacenter.
PUT/api/v1/seed/{seed_name}/dc/{dc}update d cUpdate the datacenter. The datacenter spec will be overwritten with the one provided in the request.

digitalocean

MethodURINameSummary
GET/api/v1/providers/digitalocean/sizeslist digitalocean sizes
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/digitalocean/sizeslist digitalocean sizes no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/digitalocean/sizeslist digitalocean sizes no credentials v2

etcdbackupconfig

MethodURINameSummary
POST/api/v2/projects/{project_id}/clusters/{cluster_id}/etcdbackupconfigscreate etcd backup config
DELETE/api/v2/projects/{project_id}/clusters/{cluster_id}/etcdbackupconfigs/{ebc_id}delete etcd backup config
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/etcdbackupconfigs/{ebc_id}get etcd backup config
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/etcdbackupconfigslist etcd backup config
GET/api/v2/projects/{project_id}/etcdbackupconfigslist project etcd backup config
PATCH/api/v2/projects/{project_id}/clusters/{cluster_id}/etcdbackupconfigs/{ebc_id}patch etcd backup config

etcdrestore

MethodURINameSummary
POST/api/v2/projects/{project_id}/clusters/{cluster_id}/etcdrestorescreate etcd restore
DELETE/api/v2/projects/{project_id}/clusters/{cluster_id}/etcdrestores/{er_name}delete etcd restore
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/etcdrestores/{er_name}get etcd restore
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/etcdrestoreslist etcd restore
GET/api/v2/projects/{project_id}/etcdrestoreslist project etcd restore

gcp

MethodURINameSummary
GET/api/v1/providers/gcp/disktypeslist g c p disk types
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/gcp/disktypeslist g c p disk types no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/gcp/disktypeslist g c p disk types no credentials v2
GET/api/v1/providers/gcp/networkslist g c p networks
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/gcp/networkslist g c p networks no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/gcp/networkslist g c p networks no credentials v2
GET/api/v1/providers/gcp/sizeslist g c p sizes
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/gcp/sizeslist g c p sizes no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/gcp/sizeslist g c p sizes no credentials v2
GET/api/v1/providers/gcp/{dc}/subnetworkslist g c p subnetworks
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/gcp/subnetworkslist g c p subnetworks no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/gcp/subnetworkslist g c p subnetworks no credentials v2
GET/api/v1/providers/gcp/{dc}/zoneslist g c p zones
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/gcp/zoneslist g c p zones no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/gcp/zoneslist g c p zones no credentials v2

hetzner

MethodURINameSummary
GET/api/v1/providers/hetzner/sizeslist hetzner sizes
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/hetzner/sizeslist hetzner sizes no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/hetzner/sizeslist hetzner sizes no credentials v2

metering

MethodURINameSummary
GET/api/v1/admin/metering/reports/{report_name}get metering report
GET/api/v1/admin/metering/reportslist metering reports

metric

MethodURINameSummary
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments/{machinedeployment_id}/nodes/metricslist machine deployment metricsLists metrics that belong to the given machine deployment.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodedeployments/{nodedeployment_id}/nodes/metricslist node deployment metricsLists metrics that belong to the given node deployment.

mlaadminsetting

MethodURINameSummary
POST/api/v2/projects/{project_id}/clusters/{cluster_id}/mlaadminsettingcreate m l a admin setting
DELETE/api/v2/projects/{project_id}/clusters/{cluster_id}/mlaadminsettingdelete m l a admin settingDeletes the MLA admin setting that belongs to the cluster.
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/mlaadminsettingget m l a admin settingGets MLA Admin settings for the given cluster.
PUT/api/v2/projects/{project_id}/clusters/{cluster_id}/mlaadminsettingupdate m l a admin settingUpdates the MLA admin setting for the given cluster.

openstack

MethodURINameSummary
GET/api/v1/providers/openstack/availabilityzoneslist openstack availability zones
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/openstack/availabilityzoneslist openstack availability zones no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/openstack/availabilityzoneslist openstack availability zones no credentials v2
GET/api/v1/providers/openstack/imageslist openstack images
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/openstack/imageslist openstack images no credentials
GET/api/v1/providers/openstack/networkslist openstack networks
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/openstack/networkslist openstack networks no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/openstack/networkslist openstack networks no credentials v2
GET/api/v1/providers/openstack/quotalimitslist openstack quota limits
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/openstack/quotalimitslist openstack quota limits no credentials
GET/api/v1/providers/openstack/securitygroupslist openstack security groups
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/openstack/securitygroupslist openstack security groups no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/openstack/securitygroupslist openstack security groups no credentials v2
GET/api/v1/providers/openstack/sizeslist openstack sizes
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/openstack/sizeslist openstack sizes no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/openstack/sizeslist openstack sizes no credentials v2
GET/api/v1/providers/openstack/subnetslist openstack subnets
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/openstack/subnetslist openstack subnets no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/openstack/subnetslist openstack subnets no credentials v2
GET/api/v1/providers/openstack/tenantslist openstack tenants
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/openstack/tenantslist openstack tenants no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/openstack/tenantslist openstack tenants no credentials v2

operations

MethodURINameSummary
GET/api/v1/kubeconfigcreate o ID c kubeconfig
GET/api/v1/addonconfigs/{addon_id}get addon configReturns specified addon config.
GET/api/v1/admission/plugins/{version}get admission pluginsReturns specified addon config.
GET/api/v1/addonconfigslist addon configsReturns all available addon configs.
GET/api/v1/labels/systemlist system labels
POST/api/v2/projects/{project_id}/clusters/{cluster_id}/externalccmmigrationmigrate cluster to external c c m

packet

MethodURINameSummary
GET/api/v1/providers/packet/sizeslist packet sizes
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/packet/sizeslist packet sizes no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/packet/sizeslist packet sizes no credentials v2

preset

MethodURINameSummary
POST/api/v2/providers/{provider_name}/presetscreate preset
GET/api/v2/presetslist presets
GET/api/v2/providers/{provider_name}/presetslist provider presets
PUT/api/v2/providers/{provider_name}/presetsupdate preset
PUT/api/v2/presets/{preset_name}/statusupdate preset statusUpdates the status of a preset. It can enable or disable it, so that it won't be listed by the list endpoints.

project

MethodURINameSummary
PUT/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/sshkeys/{key_id}assign SSH key to cluster
PUT/api/v2/projects/{project_id}/clusters/{cluster_id}/sshkeys/{key_id}assign SSH key to cluster v2
POST/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/clusterroles/{role_id}/clusterbindingsbind user to cluster role
POST/api/v2/projects/{project_id}/clusters/{cluster_id}/clusterroles/{role_id}/clusterbindingsbind user to cluster role v2
POST/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/roles/{namespace}/{role_id}/bindingsbind user to role
POST/api/v2/projects/{project_id}/clusters/{cluster_id}/roles/{namespace}/{role_id}/bindingsbind user to role v2
POST/api/v1/projects/{project_id}/dc/{dc}/clusterscreate clusterCreates a cluster for the given project.
POST/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/clusterrolescreate cluster role
POST/api/v2/projects/{project_id}/clustertemplatescreate cluster templateCreates a cluster templates for the given project.
POST/api/v2/projects/{project_id}/clustertemplates/{template_id}/instancescreate cluster template instanceCreate cluster template instance.
POST/api/v2/projects/{project_id}/clusterscreate cluster v2Creates a cluster for the given project.
POST/api/v2/projects/{project_id}/clusters/{cluster_id}/constraintscreate constraintCreates a given constraint for the specified cluster.
POST/api/v2/projects/{project_id}/kubernetes/clusterscreate external clusterCreates an external cluster for the given project.
POST/api/v2/projects/{project_id}/clusters/{cluster_id}/gatekeeper/configcreate gatekeeper config
POST/api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeploymentscreate machine deployment
POST/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodedeploymentscreate node deployment
POST/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/ndrequestscreate node deployment request
POST/api/v1/projectscreate projectCreates a brand new project.
POST/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/rolescreate role
POST/api/v1/projects/{project_id}/sshkeyscreate SSH keyAdds the given SSH key to the specified project.
DELETE/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}delete cluster
DELETE/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/clusterroles/{role_id}delete cluster role
DELETE/api/v2/projects/{project_id}/clustertemplates/{template_id}delete cluster templateDelete cluster template.
DELETE/api/v2/projects/{project_id}/clusters/{cluster_id}delete cluster v2
DELETE/api/v2/projects/{project_id}/clusters/{cluster_id}/constraints/{constraint_name}delete constraintDeletes a specified constraint for the given cluster.
DELETE/api/v2/projects/{project_id}/kubernetes/clusters/{cluster_id}delete external cluster
DELETE/api/v2/projects/{project_id}/clusters/{cluster_id}/gatekeeper/configdelete gatekeeper configDeletes the gatekeeper sync config for the specified cluster.
DELETE/api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments/{machinedeployment_id}delete machine deploymentDeletes the given machine deployment that belongs to the cluster.
DELETE/api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments/nodes/{node_id}delete machine deployment nodeDeletes the given node that belongs to the machine deployment.
DELETE/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodedeployments/{nodedeployment_id}delete node deploymentDeletes the given node deployment that belongs to the cluster.
DELETE/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/ndrequests/{ndrequest_id}delete node deployment requestDeletes the given NodeDeploymentRequest that belongs to the cluster.
DELETE/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodes/{node_id}delete node for cluster legacyDeprecated:
Deletes the given node that belongs to the cluster.
DELETE/api/v1/projects/{project_id}delete projectDeletes the project with the given ID.
DELETE/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/roles/{namespace}/{role_id}delete role
DELETE/api/v1/projects/{project_id}/sshkeys/{key_id}delete SSH keyRemoves the given SSH Key from the system.
DELETE/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/sshkeys/{key_id}detach SSH key from cluster
DELETE/api/projects/{project_id}/clusters/{cluster_id}/sshkeys/{key_id}detach SSH key from cluster v2
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/alertmanager/configget alertmanagerGets the alertmanager configuration for the specified cluster.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}get cluster
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/eventsget cluster eventsGets the events related to the specified cluster.
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/eventsget cluster events v2Gets the events related to the specified cluster.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/healthget cluster health
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/healthget cluster health v2
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/kubeconfigget cluster kubeconfigGets the kubeconfig for the specified cluster.
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/kubeconfigget cluster kubeconfig v2Gets the kubeconfig for the specified cluster.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/metricsget cluster metrics
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/metricsget cluster metrics v2
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/oidcget cluster oidcGets the OIDC params for the specified cluster with OIDC authentication.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/roles/{role_id}get cluster role
GET/api/v2/projects/{project_id}/clustertemplates/{template_id}get cluster templateGet cluster template.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/upgradesget cluster upgrades
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/upgradesget cluster upgrades v2
GET/api/v2/projects/{project_id}/clusters/{cluster_id}get cluster v2
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/constraints/{constraint_name}get constraintGets an specified constraint for the given cluster.
GET/api/v2/projects/{project_id}/kubernetes/clusters/{cluster_id}get external clusterGets an external cluster for the given project.
GET/api/v2/projects/{project_id}/kubernetes/clusters/{cluster_id}/metricsget external cluster metrics
GET/api/v2/projects/{project_id}/kubernetes/clusters/{cluster_id}/nodes/{node_id}get external cluster nodeGets an external cluster node.
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/gatekeeper/configget gatekeeper configGets the gatekeeper sync config for the specified cluster.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/kubeloginkubeconfigget kube login cluster kubeconfigGets the kubeconfig for the specified cluster with oidc authentication that works nicely with kube-login.
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments/{machinedeployment_id}get machine deploymentGets a machine deployment that is assigned to the given cluster.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodedeployments/{nodedeployment_id}get node deploymentGets a node deployment that is assigned to the given cluster.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/ndrequests/{ndrequest_id}get node deployment requestGets a NodeDeploymentRequest that is assigned to the given cluster.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/oidckubeconfigget oidc cluster kubeconfigGets the kubeconfig for the specified cluster with oidc authentication.
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/oidckubeconfigget oidc cluster kubeconfig v2Gets the kubeconfig for the specified cluster with oidc authentication.
GET/api/v1/projects/{project_id}get project
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/roles/{namespace}/{role_id}get role
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/clusterroleslist cluster role
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/clusterbindingslist cluster role binding
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/clusterbindingslist cluster role binding v2
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/clusterrolenameslist cluster role names
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/clusterrolenameslist cluster role names v2
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/clusterroleslist cluster role v2
GET/api/v2/projects/{project_id}/clustertemplateslist cluster templatesList cluster templates for the given project.
GET/api/v1/projects/{project_id}/dc/{dc}/clusterslist clustersLists clusters for the specified project and data center.
GET/api/v1/projects/{project_id}/clusterslist clusters for projectLists clusters for the specified project.
GET/api/v2/projects/{project_id}/clusterslist clusters v2Lists clusters for the specified project.
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/constraintslist constraintsLists constraints for the specified cluster.
GET/api/v2/projects/{project_id}/kubernetes/clusters/{cluster_id}/eventslist external cluster eventsGets an external cluster events.
GET/api/v2/projects/{project_id}/kubernetes/clusters/{cluster_id}/nodeslist external cluster nodesGets an external cluster nodes.
GET/api/v2/projects/{project_id}/kubernetes/clusters/{cluster_id}/nodesmetricslist external cluster nodes metricsGets an external cluster nodes metrics.
GET/api/v2/projects/{project_id}/kubernetes/clusterslist external clustersLists external clusters for the specified project.
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments/{machinedeployment_id}/nodeslist machine deployment nodesLists nodes that belong to the given machine deployment.
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments/{machinedeployment_id}/nodes/eventslist machine deployment nodes eventsLists machine deployment events. If query parameter type is set to warning then only warning events are retrieved.
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeploymentslist machine deployments
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/namespaceslist namespace
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/namespaceslist namespace v2
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodedeployments/{nodedeployment_id}/nodeslist node deployment nodesLists nodes that belong to the given node deployment.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodedeployments/{nodedeployment_id}/nodes/eventslist node deployment nodes eventsLists node deployment events. If query parameter type is set to warning then only warning events are retrieved.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/ndrequestslist node deployment requests
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodedeploymentslist node deployments
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/nodeslist nodes for clusterThis endpoint is used for kubeadm cluster.
GET/api/v1/projectslist projectsLists projects that an authenticated user is a member of.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/roleslist role
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/bindingslist role binding
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/bindingslist role binding v2
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/rolenameslist role names
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/rolenameslist role names v2
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/roleslist role v2
GET/api/v1/projects/{project_id}/sshkeyslist SSH keysLists SSH Keys that belong to the given project.
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/sshkeyslist SSH keys assigned to cluster
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/sshkeyslist SSH keys assigned to cluster v2
PATCH/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}patch clusterPatches the given cluster using JSON Merge Patch method (https://tools.ietf.org/html/rfc7396).
PATCH/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/clusterroles/{role_id}patch cluster role
PATCH/api/v2/projects/{project_id}/clusters/{cluster_id}patch cluster v2Patches the given cluster using JSON Merge Patch method (https://tools.ietf.org/html/rfc7396).
PATCH/api/v2/projects/{project_id}/clusters/{cluster_id}/constraints/{constraint_name}patch constraintPatches a given constraint for the specified cluster.
PATCH/api/v2/projects/{project_id}/clusters/{cluster_id}/gatekeeper/configpatch gatekeeper configPatches the gatekeeper config for the specified cluster.
PATCH/api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments/{machinedeployment_id}patch machine deployment
PATCH/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodedeployments/{nodedeployment_id}patch node deployment
PATCH/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/ndrequests/{ndrequest_id}patch node deployment requestPatches a NodeDeploymentRequest that is assigned to the given cluster.
PATCH/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/roles/{namespace}/{role_id}patch role
DELETE/api/v2/projects/{project_id}/clusters/{cluster_id}/alertmanager/configreset alertmanagerResets the alertmanager configuration to default for the specified cluster.
POST/api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments/{machinedeployment_id}restart machine deploymentSchedules rolling restart of a machine deployment that is assigned to the given cluster.
PUT/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/tokenrevoke cluster admin token
PUT/api/v2/projects/{project_id}/clusters/{cluster_id}/tokenrevoke cluster admin token v2
PUT/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/viewertokenrevoke cluster viewer token
PUT/api/v2/projects/{project_id}/clusters/{cluster_id}/viewertokenrevoke cluster viewer token v2
DELETE/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/clusterroles/{role_id}/clusterbindingsunbind user from cluster role binding
DELETE/api/v2/projects/{project_id}/clusters/{cluster_id}/clusterroles/{role_id}/clusterbindingsunbind user from cluster role binding v2
DELETE/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/roles/{namespace}/{role_id}/bindingsunbind user from role binding
DELETE/api/v2/projects/{project_id}/clusters/{cluster_id}/roles/{namespace}/{role_id}/bindingsunbind user from role binding v2
PUT/api/v2/projects/{project_id}/clusters/{cluster_id}/alertmanager/configupdate alertmanager
PUT/api/v2/projects/{project_id}/kubernetes/clusters/{cluster_id}update external clusterUpdates an external cluster for the given project.
PUT/api/v1/projects/{project_id}update project
PUT/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodes/upgradesupgrade cluster node deployments
PUT/api/v2/projects/{project_id}/clusters/{cluster_id}/nodes/upgradesupgrade cluster node deployments v2

rulegroup

MethodURINameSummary
POST/api/v2/projects/{project_id}/clusters/{cluster_id}/rulegroupscreate rule group
DELETE/api/v2/projects/{project_id}/clusters/{cluster_id}/rulegroups/{rulegroup_id}delete rule groupDeletes the given rule group that belongs to the cluster.
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/rulegroups/{rulegroup_id}get rule groupGets a specified rule group for the given cluster.
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/rulegroupslist rule groups
PUT/api/v2/projects/{project_id}/clusters/{cluster_id}/rulegroups/{rulegroup_id}update rule groupUpdates the specified rule group for the given cluster.

seed

MethodURINameSummary
GET/api/v2/seeds/{seed_name}/settingsget seed settingsGets the seed settings.
GET/api/v1/seedlist seed names

serviceaccounts

MethodURINameSummary
POST/api/v1/projects/{project_id}/serviceaccountsadd service account to project
DELETE/api/v1/projects/{project_id}/serviceaccounts/{serviceaccount_id}delete service account
GET/api/v1/projects/{project_id}/serviceaccountslist service accounts
PUT/api/v1/projects/{project_id}/serviceaccounts/{serviceaccount_id}update service account

settings

MethodURINameSummary
GET/api/v1/me/settingsget current user settingsReturns settings of the current user.
PATCH/api/v1/me/settingspatch current user settingsUpdates settings of the current user.

tokens

MethodURINameSummary
POST/api/v1/projects/{project_id}/serviceaccounts/{serviceaccount_id}/tokensadd token to service account
DELETE/api/v1/projects/{project_id}/serviceaccounts/{serviceaccount_id}/tokens/{token_id}delete service account token
GET/api/v1/projects/{project_id}/serviceaccounts/{serviceaccount_id}/tokenslist service account tokens
PATCH/api/v1/projects/{project_id}/serviceaccounts/{serviceaccount_id}/tokens/{token_id}patch service account token
PUT/api/v1/projects/{project_id}/serviceaccounts/{serviceaccount_id}/tokens/{token_id}update service account token

users

MethodURINameSummary
POST/api/v1/projects/{project_id}/usersadd user to project
DELETE/api/v1/projects/{project_id}/users/{user_id}delete user from project
PUT/api/v1/projects/{project_id}/users/{user_id}edit user in project
GET/api/v1/meget current userReturns information about the current user.
GET/api/v1/projects/{project_id}/usersget users for project
POST/api/v1/me/logoutlogout current userAdds current authorization bearer token to the blacklist.

version

MethodURINameSummary
GET/api/v2/providers/{provider_name}/versionslist versions by provider

versions

MethodURINameSummary
GET/api/v1/upgrades/clusterget master versions
GET/api/v1/versionget meta kube versionsGet versions of running MetaKube components.
GET/api/v1/upgrades/nodeget node upgrades

vsphere

MethodURINameSummary
GET/api/v2/providers/vsphere/datastoreslist v sphere datastores
GET/api/v1/providers/vsphere/folderslist v sphere folders
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/vsphere/folderslist v sphere folders no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/vsphere/folderslist v sphere folders no credentials v2
GET/api/v1/providers/vsphere/networkslist v sphere networks
GET/api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/vsphere/networkslist v sphere networks no credentials
GET/api/v2/projects/{project_id}/clusters/{cluster_id}/providers/vsphere/networkslist v sphere networks no credentials v2

Paths

add service account to project (addServiceAccountToProject)

POST /api/v1/projects/{project_id}/serviceaccounts

Adds the given service account to the given project

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
BodybodyServiceAccountmodels.ServiceAccount

All responses

CodeStatusDescriptionHas headersSchema
201CreatedServiceAccountschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - ServiceAccount

Status: Created

Schema

ServiceAccount

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

add token to service account (addTokenToServiceAccount)

POST /api/v1/projects/{project_id}/serviceaccounts/{serviceaccount_id}/tokens

Generates a token for the given service account

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
serviceaccount_idpathstringstring
BodybodyServiceAccountTokenmodels.ServiceAccountToken

All responses

CodeStatusDescriptionHas headersSchema
201CreatedServiceAccountTokenschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - ServiceAccountToken

Status: Created

Schema

ServiceAccountToken

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

add user to project (addUserToProject)

POST /api/v1/projects/{project_id}/users

Adds the given user to the given project

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
BodybodyUsermodels.User

All responses

CodeStatusDescriptionHas headersSchema
201CreatedUserschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - User

Status: Created

Schema

User

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

assign SSH key to cluster (assignSSHKeyToCluster)

PUT /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/sshkeys/{key_id}

Assigns an existing ssh key to the given cluster

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
key_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
201CreatedSSHKeyschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - SSHKey

Status: Created

Schema

SSHKey

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

assign SSH key to cluster v2 (assignSSHKeyToClusterV2)

PUT /api/v2/projects/{project_id}/clusters/{cluster_id}/sshkeys/{key_id}

Assigns an existing ssh key to the given cluster

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
key_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
201CreatedSSHKeyschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - SSHKey

Status: Created

Schema

SSHKey

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

bind user to cluster role (bindUserToClusterRole)

POST /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/clusterroles/{role_id}/clusterbindings

Binds user to cluster role

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
role_idpathstringstring
BodybodyClusterRoleUsermodels.ClusterRoleUser

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterRoleBindingschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterRoleBinding

Status: OK

Schema

ClusterRoleBinding

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

bind user to cluster role v2 (bindUserToClusterRoleV2)

POST /api/v2/projects/{project_id}/clusters/{cluster_id}/clusterroles/{role_id}/clusterbindings

Binds user to cluster role

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
role_idpathstringstring
BodybodyClusterRoleUsermodels.ClusterRoleUser

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterRoleBindingschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterRoleBinding

Status: OK

Schema

ClusterRoleBinding

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

bind user to role (bindUserToRole)

POST /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/roles/{namespace}/{role_id}/bindings

Binds user to the role

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
namespacepathstringstring
project_idpathstringstring
role_idpathstringstring
BodybodyRoleUsermodels.RoleUser

All responses

CodeStatusDescriptionHas headersSchema
200OKRoleBindingschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - RoleBinding

Status: OK

Schema

RoleBinding

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

bind user to role v2 (bindUserToRoleV2)

POST /api/v2/projects/{project_id}/clusters/{cluster_id}/roles/{namespace}/{role_id}/bindings

Binds user to the role

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
namespacepathstringstring
project_idpathstringstring
role_idpathstringstring
BodybodyRoleUsermodels.RoleUser

All responses

CodeStatusDescriptionHas headersSchema
200OKRoleBindingschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - RoleBinding

Status: OK

Schema

RoleBinding

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

create addon (createAddon)

POST /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/addons

Creates an addon that will belong to the given cluster

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
BodybodyAddonmodels.Addon

All responses

CodeStatusDescriptionHas headersSchema
201CreatedAddonschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - Addon

Status: Created

Schema

Addon

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

create addon v2 (createAddonV2)

POST /api/v2/projects/{project_id}/clusters/{cluster_id}/addons

Creates an addon that will belong to the given cluster

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
BodybodyAddonmodels.Addon

All responses

CodeStatusDescriptionHas headersSchema
201CreatedAddonschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - Addon

Status: Created

Schema

Addon

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

create allowed registry (createAllowedRegistry)

POST /api/v2/allowedregistries

Creates a allowed registry

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
BodybodyWrBodymodels.WrBody

All responses

CodeStatusDescriptionHas headersSchema
201CreatedAllowedRegistryschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - AllowedRegistry

Status: Created

Schema

AllowedRegistry

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Creates a cluster for the given project. (createCluster)

POST /api/v1/projects/{project_id}/dc/{dc}/clusters

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
dcpathstringstring
project_idpathstringstring
BodybodyCreateClusterSpecmodels.CreateClusterSpec

All responses

CodeStatusDescriptionHas headersSchema
201CreatedClusterschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - Cluster

Status: Created

Schema

Cluster

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

create cluster role (createClusterRole)

POST /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/clusterroles

Creates cluster role

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
BodybodyClusterRolemodels.ClusterRole

All responses

CodeStatusDescriptionHas headersSchema
201CreatedClusterRoleschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - ClusterRole

Status: Created

Schema

ClusterRole

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Creates a cluster templates for the given project. (createClusterTemplate)

POST /api/v2/projects/{project_id}/clustertemplates

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
BodybodyCreateClusterTemplateBodyCreateClusterTemplateBody

All responses

CodeStatusDescriptionHas headersSchema
201CreatedClusterTemplateschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - ClusterTemplate

Status: Created

Schema

ClusterTemplate

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Inlined models

CreateClusterTemplateBody

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DNSDomainstringstring
Namestringstring
PodsCIDRstringstring
Scopestringstring
ServicesCIDRstringstring
UserSSHKeys[]ClusterTemplateSSHKey[]*models.ClusterTemplateSSHKey
clusterClustermodels.Cluster
nodeDeploymentNodeDeploymentmodels.NodeDeployment

Create cluster template instance. (createClusterTemplateInstance)

POST /api/v2/projects/{project_id}/clustertemplates/{template_id}/instances

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
template_idpathstringstring
BodybodyCreateClusterTemplateInstanceBodyCreateClusterTemplateInstanceBody

All responses

CodeStatusDescriptionHas headersSchema
201CreatedClusterTemplateInstanceschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - ClusterTemplateInstance

Status: Created

Schema

ClusterTemplateInstance

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Inlined models

CreateClusterTemplateInstanceBody

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Replicasint64 (formatted integer)int64

Creates a cluster for the given project. (createClusterV2)

POST /api/v2/projects/{project_id}/clusters

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
BodybodyCreateClusterSpecmodels.CreateClusterSpec

All responses

CodeStatusDescriptionHas headersSchema
201CreatedClusterschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - Cluster

Status: Created

Schema

Cluster

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Creates a given constraint for the specified cluster. (createConstraint)

POST /api/v2/projects/{project_id}/clusters/{cluster_id}/constraints

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
BodybodyConstraintBodymodels.ConstraintBody

All responses

CodeStatusDescriptionHas headersSchema
200OKConstraintschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Constraint

Status: OK

Schema

Constraint

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

create constraint template (createConstraintTemplate)

POST /api/v2/constrainttemplates

Create constraint template

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
BodybodyCtBodymodels.CtBody

All responses

CodeStatusDescriptionHas headersSchema
200OKConstraintTemplateschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ConstraintTemplate

Status: OK

Schema

ConstraintTemplate

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Create the datacenter for a specified seed. (createDC)

POST /api/v1/seed/{seed_name}/dc

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
seed_namepathstringstring
BodybodyCreateDCBodyCreateDCBody

All responses

CodeStatusDescriptionHas headersSchema
201CreatedDatacenterschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - Datacenter

Status: Created

Schema

Datacenter

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Inlined models

CreateDCBody

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Namestringstring
specDatacenterSpecmodels.DatacenterSpec

create default constraint (createDefaultConstraint)

POST /api/v2/constraints

Creates default constraint

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
BodybodyConstraintBodymodels.ConstraintBody

All responses

CodeStatusDescriptionHas headersSchema
200OKConstraintschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Constraint

Status: OK

Schema

Constraint

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

create etcd backup config (createEtcdBackupConfig)

POST /api/v2/projects/{project_id}/clusters/{cluster_id}/etcdbackupconfigs

Creates a etcd backup config that will belong to the given cluster

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
BodybodyEbcBodymodels.EbcBody

All responses

CodeStatusDescriptionHas headersSchema
201CreatedEtcdBackupConfigschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - EtcdBackupConfig

Status: Created

Schema

EtcdBackupConfig

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

create etcd restore (createEtcdRestore)

POST /api/v2/projects/{project_id}/clusters/{cluster_id}/etcdrestores

Creates a etcd backup restore for a given cluster

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
BodybodyErBodymodels.ErBody

All responses

CodeStatusDescriptionHas headersSchema
201CreatedEtcdBackupConfigschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - EtcdBackupConfig

Status: Created

Schema

EtcdBackupConfig

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Creates an external cluster for the given project. (createExternalCluster)

POST /api/v2/projects/{project_id}/kubernetes/clusters

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
BodybodyBodymodels.Body

All responses

CodeStatusDescriptionHas headersSchema
201CreatedClusterschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - Cluster

Status: Created

Schema

Cluster

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

create gatekeeper config (createGatekeeperConfig)

POST /api/v2/projects/{project_id}/clusters/{cluster_id}/gatekeeper/config

Creates a gatekeeper config for the given cluster

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
BodybodyGatekeeperConfigmodels.GatekeeperConfig

All responses

CodeStatusDescriptionHas headersSchema
201CreatedGatekeeperConfigschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - GatekeeperConfig

Status: Created

Schema

GatekeeperConfig

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

create m l a admin setting (createMLAAdminSetting)

POST /api/v2/projects/{project_id}/clusters/{cluster_id}/mlaadminsetting

Creates MLA admin setting that will belong to the given cluster

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
BodybodyMLAAdminSettingmodels.MLAAdminSetting

All responses

CodeStatusDescriptionHas headersSchema
201CreatedMLAAdminSettingschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - MLAAdminSetting

Status: Created

Schema

MLAAdminSetting

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

create machine deployment (createMachineDeployment)

POST /api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments

Creates a machine deployment that will belong to the given cluster

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
BodybodyNodeDeploymentmodels.NodeDeployment

All responses

CodeStatusDescriptionHas headersSchema
201CreatedNodeDeploymentschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - NodeDeployment

Status: Created

Schema

NodeDeployment

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

create node deployment (createNodeDeployment)

POST /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodedeployments

Creates a node deployment that will belong to the given cluster

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
BodybodyNodeDeploymentmodels.NodeDeployment

All responses

CodeStatusDescriptionHas headersSchema
201CreatedNodeDeploymentschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - NodeDeployment

Status: Created

Schema

NodeDeployment

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

create node deployment request (createNodeDeploymentRequest)

POST /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/ndrequests

Creates a NodeDeploymentRequest that will belong to the given cluster

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
BodybodyNodeDeploymentRequestmodels.NodeDeploymentRequest

All responses

CodeStatusDescriptionHas headersSchema
201CreatedNodeDeploymentRequestschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - NodeDeploymentRequest

Status: Created

Schema

NodeDeploymentRequest

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

create o ID c kubeconfig (createOIDCKubeconfig)

GET /api/v1/kubeconfig

Starts OIDC flow and generates kubeconfig, the generated config contains OIDC provider authentication info

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idquerystringstring
project_idquerystringstring
user_idquerystringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKKubeconfig is a clusters kubeconfigschema
defaulterrorResponseschema

Responses

200 - Kubeconfig is a clusters kubeconfig

Status: OK

Schema

[]uint8 (formatted integer)

Default Response

errorResponse

Schema

ErrorResponse

create or update backup credentials (createOrUpdateBackupCredentials)

PUT /api/v2/seeds/{seed_name}/backupcredentials

Creates or updates backup credentials for a given seed

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
seed_namepathstringstring
BodybodyBcBodymodels.BcBody

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

create or update metering configurations (createOrUpdateMeteringConfigurations)

PUT /api/v1/admin/metering/configurations

Configures KKP metering tool. Only available in Kubermatic Enterprise Edition

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

create or update metering credentials (createOrUpdateMeteringCredentials)

PUT /api/v1/admin/metering/credentials

Creates or updates the metering tool credentials. Only available in Kubermatic Enterprise Edition

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

create preset (createPreset)

POST /api/v2/providers/{provider_name}/presets

Creates the preset

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
provider_namepathstringstring
BodybodyPresetmodels.Preset

All responses

CodeStatusDescriptionHas headersSchema
200OKPresetschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Preset

Status: OK

Schema

Preset

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Creates a brand new project. (createProject)

POST /api/v1/projects

Note that this endpoint can be consumed by every authenticated user.

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
BodybodyCreateProjectBodyCreateProjectBody

All responses

CodeStatusDescriptionHas headersSchema
201CreatedProjectschema
401UnauthorizedEmptyResponse is a empty responseschema
409ConflictEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - Project

Status: Created

Schema

Project

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
409 - EmptyResponse is a empty response

Status: Conflict

Schema
Default Response

errorResponse

Schema

ErrorResponse

Inlined models

CreateProjectBody

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Labelsmap of stringmap[string]string
Namestringstring
Users[]string[]stringhuman user email list for the service account in projectmanagers group

create role (createRole)

POST /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/roles

Creates cluster role

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
BodybodyRolemodels.Role

All responses

CodeStatusDescriptionHas headersSchema
201CreatedRoleschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - Role

Status: Created

Schema

Role

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

create rule group (createRuleGroup)

POST /api/v2/projects/{project_id}/clusters/{cluster_id}/rulegroups

Creates a rule group that will belong to the given cluster

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
BodybodyRuleGroupmodels.RuleGroup

All responses

CodeStatusDescriptionHas headersSchema
201CreatedRuleGroupschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - RuleGroup

Status: Created

Schema

RuleGroup

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Adds the given SSH key to the specified project. (createSSHKey)

POST /api/v1/projects/{project_id}/sshkeys

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
KeybodySSHKeymodels.SSHKey

All responses

CodeStatusDescriptionHas headersSchema
201CreatedSSHKeyschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

201 - SSHKey

Status: Created

Schema

SSHKey

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Deletes the given addon that belongs to the cluster. (deleteAddon)

DELETE /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/addons/{addon_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
addon_idpathstringstring
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Deletes the given addon that belongs to the cluster. (deleteAddonV2)

DELETE /api/v2/projects/{project_id}/clusters/{cluster_id}/addons/{addon_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
addon_idpathstringstring
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Deletes the admission plugin. (deleteAdmissionPlugin)

DELETE /api/v1/admin/admission/plugins/{name}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
namepathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Deletes the given allowed registry. (deleteAllowedRegistry)

DELETE /api/v2/allowedregistries/{allowed_registry}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
allowed_registrypathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

delete cluster (deleteCluster)

DELETE /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}

Deletes the specified cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
DeleteLoadBalancersheaderbooleanbool
DeleteVolumesheaderbooleanbool

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

delete cluster role (deleteClusterRole)

DELETE /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/clusterroles/{role_id}

Delete the cluster role with the given name

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
role_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Delete cluster template. (deleteClusterTemplate)

DELETE /api/v2/projects/{project_id}/clustertemplates/{template_id}

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
template_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

delete cluster v2 (deleteClusterV2)

DELETE /api/v2/projects/{project_id}/clusters/{cluster_id}

Deletes the specified cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
DeleteLoadBalancersheaderbooleanbool
DeleteVolumesheaderbooleanbool

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Deletes a specified constraint for the given cluster. (deleteConstraint)

DELETE /api/v2/projects/{project_id}/clusters/{cluster_id}/constraints/{constraint_name}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
constraint_namepathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

delete constraint template (deleteConstraintTemplate)

DELETE /api/v2/constrainttemplates/{ct_name}

Deletes the specified cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
ct_namepathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Delete the datacenter. (deleteDC)

DELETE /api/v1/seed/{seed_name}/dc/{dc}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
dcpathstringstring
seed_namepathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Deletes a specified default constraint. (deleteDefaultConstraint)

DELETE /api/v2/constraints/{constraint_name}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
constraint_namepathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

delete etcd backup config (deleteEtcdBackupConfig)

DELETE /api/v2/projects/{project_id}/clusters/{cluster_id}/etcdbackupconfigs/{ebc_id}

Deletes a etcd backup config for a given cluster based on its id

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
ebc_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

delete etcd restore (deleteEtcdRestore)

DELETE /api/v2/projects/{project_id}/clusters/{cluster_id}/etcdrestores/{er_name}

Deletes a etcd restore config for a given cluster based on its name

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
er_namepathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
409ConflicterrorResponseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
409 - errorResponse

Status: Conflict

Schema

ErrorResponse

Default Response

errorResponse

Schema

ErrorResponse

delete external cluster (deleteExternalCluster)

DELETE /api/v2/projects/{project_id}/kubernetes/clusters/{cluster_id}

Deletes the specified external cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Deletes the gatekeeper sync config for the specified cluster. (deleteGatekeeperConfig)

DELETE /api/v2/projects/{project_id}/clusters/{cluster_id}/gatekeeper/config

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Deletes the MLA admin setting that belongs to the cluster. (deleteMLAAdminSetting)

DELETE /api/v2/projects/{project_id}/clusters/{cluster_id}/mlaadminsetting

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Deletes the given machine deployment that belongs to the cluster. (deleteMachineDeployment)

DELETE /api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments/{machinedeployment_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
machinedeployment_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Deletes the given node that belongs to the machine deployment. (deleteMachineDeploymentNode)

DELETE /api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments/nodes/{node_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
node_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Deletes the given node deployment that belongs to the cluster. (deleteNodeDeployment)

DELETE /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodedeployments/{nodedeployment_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
nodedeployment_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Deletes the given NodeDeploymentRequest that belongs to the cluster. (deleteNodeDeploymentRequest)

DELETE /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/ndrequests/{ndrequest_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
ndrequest_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Deprecated:

Deletes the given node that belongs to the cluster. (deleteNodeForClusterLegacy)

DELETE /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodes/{node_id}

This endpoint is deprecated, please create a Node Deployment instead.

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
node_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Deletes the project with the given ID. (deleteProject)

DELETE /api/v1/projects/{project_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

delete role (deleteRole)

DELETE /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/roles/{namespace}/{role_id}

Delete the cluster role with the given name

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
namespacepathstringstring
project_idpathstringstring
role_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Deletes the given rule group that belongs to the cluster. (deleteRuleGroup)

DELETE /api/v2/projects/{project_id}/clusters/{cluster_id}/rulegroups/{rulegroup_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
rulegroup_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Removes the given SSH Key from the system. (deleteSSHKey)

DELETE /api/v1/projects/{project_id}/sshkeys/{key_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
key_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Deletes the seed CRD object from the Kubermatic. (deleteSeed)

DELETE /api/v1/admin/seeds/{seed_name}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
seed_namepathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

delete service account (deleteServiceAccount)

DELETE /api/v1/projects/{project_id}/serviceaccounts/{serviceaccount_id}

Deletes service account for the given project

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
serviceaccount_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

delete service account token (deleteServiceAccountToken)

DELETE /api/v1/projects/{project_id}/serviceaccounts/{serviceaccount_id}/tokens/{token_id}

Deletes the token

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
serviceaccount_idpathstringstring
token_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

delete user from project (deleteUserFromProject)

DELETE /api/v1/projects/{project_id}/users/{user_id}

Removes the given member from the project

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
user_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKUserschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - User

Status: OK

Schema

User

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

detach SSH key from cluster (detachSSHKeyFromCluster)

DELETE /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/sshkeys/{key_id}

Unassignes an ssh key from the given cluster

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
key_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

detach SSH key from cluster v2 (detachSSHKeyFromClusterV2)

DELETE /api/projects/{project_id}/clusters/{cluster_id}/sshkeys/{key_id}

Unassignes an ssh key from the given cluster

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
key_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

edit user in project (editUserInProject)

PUT /api/v1/projects/{project_id}/users/{user_id}

Changes membership of the given user for the given project

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
user_idpathstringstring
BodybodyUsermodels.User

All responses

CodeStatusDescriptionHas headersSchema
200OKUserschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - User

Status: OK

Schema

User

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets an addon that is assigned to the given cluster. (getAddon)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/addons/{addon_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
addon_idpathstringstring
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAddonschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Addon

Status: OK

Schema

Addon

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Returns specified addon config. (getAddonConfig)

GET /api/v1/addonconfigs/{addon_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
addon_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAddonConfigschema
401UnauthorizedEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - AddonConfig

Status: OK

Schema

AddonConfig

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets an addon that is assigned to the given cluster. (getAddonV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/addons/{addon_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
addon_idpathstringstring
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAddonschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Addon

Status: OK

Schema

Addon

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Returns list of admin users. (getAdmins)

GET /api/v1/admin

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKAdminschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Admin

Status: OK

Schema

[]Admin

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets the admission plugin. (getAdmissionPlugin)

GET /api/v1/admin/admission/plugins/{name}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
namepathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAdmissionPluginschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - AdmissionPlugin

Status: OK

Schema

AdmissionPlugin

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Returns specified addon config. (getAdmissionPlugins)

GET /api/v1/admission/plugins/{version}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
versionpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAdmissionPluginListschema
401UnauthorizedEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - AdmissionPluginList

Status: OK

Schema

AdmissionPluginList

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets the alertmanager configuration for the specified cluster. (getAlertmanager)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/alertmanager/config

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAlertmanagerschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Alertmanager

Status: OK

Schema

Alertmanager

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get allowed registry (getAllowedRegistry)

GET /api/v2/allowedregistries/{allowed_registry}

Get allowed registries specified by name

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
allowed_registrypathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAllowedRegistryschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - AllowedRegistry

Status: OK

Schema

AllowedRegistry

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get cluster (getCluster)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}

Gets the cluster with the given name

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Cluster

Status: OK

Schema

Cluster

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets the events related to the specified cluster. (getClusterEvents)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/events

Produces

  • application/yaml

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
typequerystringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEventschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Event

Status: OK

Schema

[]Event

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets the events related to the specified cluster. (getClusterEventsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/events

Produces

  • application/yaml

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
typequerystringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEventschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Event

Status: OK

Schema

[]Event

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get cluster health (getClusterHealth)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/health

Returns the cluster's component health status

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterHealthschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterHealth

Status: OK

Schema

ClusterHealth

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get cluster health v2 (getClusterHealthV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/health

Returns the cluster's component health status

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterHealthschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterHealth

Status: OK

Schema

ClusterHealth

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets the kubeconfig for the specified cluster. (getClusterKubeconfig)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/kubeconfig

Produces

  • application/octet-stream

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKKubeconfig is a clusters kubeconfigschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Kubeconfig is a clusters kubeconfig

Status: OK

Schema

[]uint8 (formatted integer)

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets the kubeconfig for the specified cluster. (getClusterKubeconfigV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/kubeconfig

Produces

  • application/octet-stream

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKKubeconfig is a clusters kubeconfigschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Kubeconfig is a clusters kubeconfig

Status: OK

Schema

[]uint8 (formatted integer)

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get cluster metrics (getClusterMetrics)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/metrics

Gets cluster metrics

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterMetricsschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterMetrics

Status: OK

Schema

ClusterMetrics

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get cluster metrics v2 (getClusterMetricsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/metrics

Gets cluster metrics

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterMetricsschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterMetrics

Status: OK

Schema

ClusterMetrics

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets the OIDC params for the specified cluster with OIDC authentication. (getClusterOidc)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/oidc

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOIDCSpecschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - OIDCSpec

Status: OK

Schema

OIDCSpec

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get cluster role (getClusterRole)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/roles/{role_id}

Gets the cluster role with the given name

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
role_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterRoleschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterRole

Status: OK

Schema

ClusterRole

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Get cluster template. (getClusterTemplate)

GET /api/v2/projects/{project_id}/clustertemplates/{template_id}

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
template_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterTemplateschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterTemplate

Status: OK

Schema

ClusterTemplate

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get cluster upgrades (getClusterUpgrades)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/upgrades

Gets possible cluster upgrades

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKMasterVersionschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - MasterVersion

Status: OK

Schema

[]MasterVersion

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get cluster upgrades v2 (getClusterUpgradesV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/upgrades

Gets possible cluster upgrades

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKMasterVersionschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - MasterVersion

Status: OK

Schema

[]MasterVersion

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get cluster v2 (getClusterV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}

Gets the cluster with the given name

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Cluster

Status: OK

Schema

Cluster

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets an specified constraint for the given cluster. (getConstraint)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/constraints/{constraint_name}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
constraint_namepathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKConstraintschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Constraint

Status: OK

Schema

Constraint

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get constraint template (getConstraintTemplate)

GET /api/v2/constrainttemplates/{ct_name}

Get constraint templates specified by name

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
ct_namepathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKConstraintTemplateschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ConstraintTemplate

Status: OK

Schema

ConstraintTemplate

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Returns information about the current user. (getCurrentUser)

GET /api/v1/me

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKUserschema
401UnauthorizedEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - User

Status: OK

Schema

User

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
Default Response

errorResponse

Schema

ErrorResponse

Returns settings of the current user. (getCurrentUserSettings)

GET /api/v1/me/settings

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKUserSettingsschema
401UnauthorizedEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - UserSettings

Status: OK

Schema

UserSettings

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
Default Response

errorResponse

Schema

ErrorResponse

Get the datacenter for the specified provider. (getDCForProvider)

GET /api/v1/providers/{provider_name}/dc/{dc}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
dcpathstringstring
provider_namepathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKDatacenterschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Datacenter

Status: OK

Schema

Datacenter

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Returns the specified datacenter for the specified seed. (getDCForSeed)

GET /api/v1/seed/{seed_name}/dc/{dc}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
dcpathstringstring
seed_namepathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKDatacenterschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Datacenter

Status: OK

Schema

Datacenter

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get datacenter (getDatacenter)

GET /api/v1/dc/{dc}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
dcpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKDatacenterschema
defaulterrorResponseschema

Responses

200 - Datacenter

Status: OK

Schema

Datacenter

Default Response

errorResponse

Schema

ErrorResponse

get default constraint (getDefaultConstraint)

GET /api/v2/constraints/{constraint_name}

Gets an specified default constraint

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
constraint_namepathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKConstraintschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Constraint

Status: OK

Schema

Constraint

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get etcd backup config (getEtcdBackupConfig)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/etcdbackupconfigs/{ebc_id}

Gets a etcd backup config for a given cluster based on its id

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
ebc_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEtcdBackupConfigschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EtcdBackupConfig

Status: OK

Schema

EtcdBackupConfig

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get etcd restore (getEtcdRestore)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/etcdrestores/{er_name}

Gets a etcd backup restore for a given cluster based on its name

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
er_namepathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEtcdRestoreschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EtcdRestore

Status: OK

Schema

EtcdRestore

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets an external cluster for the given project. (getExternalCluster)

GET /api/v2/projects/{project_id}/kubernetes/clusters/{cluster_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Cluster

Status: OK

Schema

Cluster

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get external cluster metrics (getExternalClusterMetrics)

GET /api/v2/projects/{project_id}/kubernetes/clusters/{cluster_id}/metrics

Gets cluster metrics

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterMetricsschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterMetrics

Status: OK

Schema

ClusterMetrics

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets an external cluster node. (getExternalClusterNode)

GET /api/v2/projects/{project_id}/kubernetes/clusters/{cluster_id}/nodes/{node_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
node_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Node

Status: OK

Schema

Node

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets the gatekeeper sync config for the specified cluster. (getGatekeeperConfig)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/gatekeeper/config

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKGatekeeperConfigschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - GatekeeperConfig

Status: OK

Schema

GatekeeperConfig

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets the kubeconfig for the specified cluster with oidc authentication that works nicely with kube-login. (getKubeLoginClusterKubeconfig)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/kubeloginkubeconfig

Produces

  • application/yaml

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKKubeconfig is a clusters kubeconfigschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Kubeconfig is a clusters kubeconfig

Status: OK

Schema

[]uint8 (formatted integer)

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets the custom links. (getKubermaticCustomLinks)

GET /api/v1/admin/settings/customlinks

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKGlobalCustomLinksschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - GlobalCustomLinks

Status: OK

Schema

GlobalCustomLinks

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets the global settings. (getKubermaticSettings)

GET /api/v1/admin/settings

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKGlobalSettingsschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - GlobalSettings

Status: OK

Schema

GlobalSettings

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets MLA Admin settings for the given cluster. (getMLAAdminSetting)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/mlaadminsetting

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKMLAAdminSettingschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - MLAAdminSetting

Status: OK

Schema

MLAAdminSetting

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets a machine deployment that is assigned to the given cluster. (getMachineDeployment)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments/{machinedeployment_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
machinedeployment_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeDeploymentschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - NodeDeployment

Status: OK

Schema

NodeDeployment

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get master versions (getMasterVersions)

GET /api/v1/upgrades/cluster

Lists all versions which don't result in automatic updates

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKMasterVersionschema
defaulterrorResponseschema

Responses

200 - MasterVersion

Status: OK

Schema

[]MasterVersion

Default Response

errorResponse

Schema

ErrorResponse

Get versions of running MetaKube components. (getMetaKubeVersions)

GET /api/v1/version

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKMetaKubeVersionsschema
defaulterrorResponseschema

Responses

200 - MetaKubeVersions

Status: OK

Schema

KubermaticVersions

Default Response

errorResponse

Schema

ErrorResponse

get metering report (getMeteringReport)

GET /api/v1/admin/metering/reports/{report_name}

Download a specific metering report. Provides an S3 pre signed URL valid for 1 hour. Only available in Kubermatic Enterprise Edition

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
report_namepathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKMeteringReportURLschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - MeteringReportURL

Status: OK

Schema
NameTypeGo typeDefaultDescriptionExample
getMeteringReportOKBodystring
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets a node deployment that is assigned to the given cluster. (getNodeDeployment)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodedeployments/{nodedeployment_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
nodedeployment_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeDeploymentschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - NodeDeployment

Status: OK

Schema

NodeDeployment

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets a NodeDeploymentRequest that is assigned to the given cluster. (getNodeDeploymentRequest)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/ndrequests/{ndrequest_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
ndrequest_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeDeploymentRequestschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - NodeDeploymentRequest

Status: OK

Schema

NodeDeploymentRequest

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get node upgrades (getNodeUpgrades)

GET /api/v1/upgrades/node

Gets possible node upgrades for a specific control plane version

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
control_plane_versionquerystringstring
typequerystringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKMasterVersionschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - MasterVersion

Status: OK

Schema

[]MasterVersion

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets the kubeconfig for the specified cluster with oidc authentication. (getOidcClusterKubeconfig)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/oidckubeconfig

Produces

  • application/yaml

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKKubeconfig is a clusters kubeconfigschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Kubeconfig is a clusters kubeconfig

Status: OK

Schema

[]uint8 (formatted integer)

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets the kubeconfig for the specified cluster with oidc authentication. (getOidcClusterKubeconfigV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/oidckubeconfig

Produces

  • application/octet-stream

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKKubeconfig is a clusters kubeconfigschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Kubeconfig is a clusters kubeconfig

Status: OK

Schema

[]uint8 (formatted integer)

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get project (getProject)

GET /api/v1/projects/{project_id}

Gets the project with the given ID

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKProjectschema
401UnauthorizedEmptyResponse is a empty responseschema
409ConflictEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Project

Status: OK

Schema

Project

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
409 - EmptyResponse is a empty response

Status: Conflict

Schema
Default Response

errorResponse

Schema

ErrorResponse

get role (getRole)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/roles/{namespace}/{role_id}

Gets the role with the given name

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
namespacepathstringstring
project_idpathstringstring
role_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKRoleschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Role

Status: OK

Schema

Role

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets a specified rule group for the given cluster. (getRuleGroup)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/rulegroups/{rulegroup_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
rulegroup_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKRuleGroupschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - RuleGroup

Status: OK

Schema

RuleGroup

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Returns the seed object. (getSeed)

GET /api/v1/admin/seeds/{seed_name}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
seed_namepathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKSeedschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Seed

Status: OK

Schema

Seed

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets the seed settings. (getSeedSettings)

GET /api/v2/seeds/{seed_name}/settings

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
seed_namepathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKSeedSettingsschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - SeedSettings

Status: OK

Schema

SeedSettings

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

get users for project (getUsersForProject)

GET /api/v1/projects/{project_id}/users

Get list of users for the given project

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKUserschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - User

Status: OK

Schema

[]User

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list a w s security groups (listAWSSecurityGroups)

GET /api/v1/providers/aws/{dc}/securitygroups

Lists available AWS Security Groups

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
dcpathstringstring
AccessKeyIDheaderstringstring
Credentialheaderstringstring
SecretAccessKeyheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAWSSecurityGroupListschema
defaulterrorResponseschema

Responses

200 - AWSSecurityGroupList

Status: OK

Schema

AWSSecurityGroupList

Default Response

errorResponse

Schema

ErrorResponse

Lists available AWS sizes. (listAWSSizes)

GET /api/v1/providers/aws/sizes

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
Regionheaderstringstring
architecturequerystringstringarchitecture query parameter. Supports: arm64 and x64 types.

All responses

CodeStatusDescriptionHas headersSchema
200OKAWSSizeListschema
defaulterrorResponseschema

Responses

200 - AWSSizeList

Status: OK

Schema

AWSSizeList

Default Response

errorResponse

Schema

ErrorResponse

list a w s sizes no credentials (listAWSSizesNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/aws/sizes

Lists available AWS sizes

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAWSSizeListschema
defaulterrorResponseschema

Responses

200 - AWSSizeList

Status: OK

Schema

AWSSizeList

Default Response

errorResponse

Schema

ErrorResponse

list a w s sizes no credentials v2 (listAWSSizesNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/aws/sizes

Lists available AWS sizes

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
architecturequerystringstringarchitecture query parameter. Supports: arm64 and x64 types.

All responses

CodeStatusDescriptionHas headersSchema
200OKAWSSizeListschema
defaulterrorResponseschema

Responses

200 - AWSSizeList

Status: OK

Schema

AWSSizeList

Default Response

errorResponse

Schema

ErrorResponse

list a w s subnets (listAWSSubnets)

GET /api/v1/providers/aws/{dc}/subnets

Lists available AWS subnets

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
dcpathstringstring
AccessKeyIDheaderstringstring
Credentialheaderstringstring
SecretAccessKeyheaderstringstring
vpcheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAWSSubnetListschema
defaulterrorResponseschema

Responses

200 - AWSSubnetList

Status: OK

Schema

AWSSubnetList

Default Response

errorResponse

Schema

ErrorResponse

list a w s subnets no credentials (listAWSSubnetsNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/aws/subnets

Lists available AWS subnets

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAWSSubnetListschema
defaulterrorResponseschema

Responses

200 - AWSSubnetList

Status: OK

Schema

AWSSubnetList

Default Response

errorResponse

Schema

ErrorResponse

list a w s subnets no credentials v2 (listAWSSubnetsNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/aws/subnets

Lists available AWS subnets

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAWSSubnetListschema
defaulterrorResponseschema

Responses

200 - AWSSubnetList

Status: OK

Schema

AWSSubnetList

Default Response

errorResponse

Schema

ErrorResponse

list a w s v p c s (listAWSVPCS)

GET /api/v1/providers/aws/{dc}/vpcs

Lists available AWS vpc's

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
dcpathstringstring
AccessKeyIDheaderstringstring
Credentialheaderstringstring
SecretAccessKeyheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAWSVPCListschema
defaulterrorResponseschema

Responses

200 - AWSVPCList

Status: OK

Schema

AWSVPCList

Default Response

errorResponse

Schema

ErrorResponse

list accessible addons (listAccessibleAddons)

POST /api/v1/addons

Lists names of addons that can be configured inside the user clusters

Consumes

  • application/json

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKAccessibleAddonsschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - AccessibleAddons

Status: OK

Schema

AccessibleAddons

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Returns all available addon configs. (listAddonConfigs)

GET /api/v1/addonconfigs

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKAddonConfigschema
401UnauthorizedEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - AddonConfig

Status: OK

Schema

[]AddonConfig

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
Default Response

errorResponse

Schema

ErrorResponse

list addons (listAddons)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/addons

Lists addons that belong to the given cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAddonschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Addon

Status: OK

Schema

[]Addon

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list addons v2 (listAddonsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/addons

Lists addons that belong to the given cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAddonschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Addon

Status: OK

Schema

[]Addon

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Returns all admission plugins from the CRDs. (listAdmissionPlugins)

GET /api/v1/admin/admission/plugins

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKAdmissionPluginschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - AdmissionPlugin

Status: OK

Schema

[]AdmissionPlugin

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Lists available Alibaba instance types. (listAlibabaInstanceTypes)

GET /api/v1/providers/alibaba/instancetypes

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
AccessKeyIDheaderstringstring
AccessKeySecretheaderstringstring
Credentialheaderstringstring
Regionheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAlibabaInstanceTypeListschema
defaulterrorResponseschema

Responses

200 - AlibabaInstanceTypeList

Status: OK

Schema

AlibabaInstanceTypeList

Default Response

errorResponse

Schema

ErrorResponse

list alibaba instance types no credentials (listAlibabaInstanceTypesNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/alibaba/instancetypes

Lists available Alibaba Instance Types

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
Regionheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAlibabaInstanceTypeListschema
defaulterrorResponseschema

Responses

200 - AlibabaInstanceTypeList

Status: OK

Schema

AlibabaInstanceTypeList

Default Response

errorResponse

Schema

ErrorResponse

list alibaba instance types no credentials v2 (listAlibabaInstanceTypesNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/alibaba/instancetypes

Lists available Alibaba Instance Types

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
Regionheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAlibabaInstanceTypeListschema
defaulterrorResponseschema

Responses

200 - AlibabaInstanceTypeList

Status: OK

Schema

AlibabaInstanceTypeList

Default Response

errorResponse

Schema

ErrorResponse

Lists available Alibaba vSwitches. (listAlibabaVSwitches)

GET /api/v1/providers/alibaba/vswitches

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKAlibabaVSwitchListschema
defaulterrorResponseschema

Responses

200 - AlibabaVSwitchList

Status: OK

Schema

AlibabaVSwitchList

Default Response

errorResponse

Schema

ErrorResponse

list alibaba v switches no credentials v2 (listAlibabaVSwitchesNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/alibaba/vswitches

Lists available Alibaba vSwitches

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
Regionheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAlibabaVSwitchListschema
defaulterrorResponseschema

Responses

200 - AlibabaVSwitchList

Status: OK

Schema

AlibabaVSwitchList

Default Response

errorResponse

Schema

ErrorResponse

Lists available Alibaba zones. (listAlibabaZones)

GET /api/v1/providers/alibaba/zones

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
AccessKeyIDheaderstringstring
AccessKeySecretheaderstringstring
Credentialheaderstringstring
Regionheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAlibabaZoneListschema
defaulterrorResponseschema

Responses

200 - AlibabaZoneList

Status: OK

Schema

AlibabaZoneList

Default Response

errorResponse

Schema

ErrorResponse

list alibaba zones no credentials (listAlibabaZonesNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/alibaba/zones

Lists available Alibaba Instance Types

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
Regionheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAlibabaZoneListschema
defaulterrorResponseschema

Responses

200 - AlibabaZoneList

Status: OK

Schema

AlibabaZoneList

Default Response

errorResponse

Schema

ErrorResponse

list alibaba zones no credentials v2 (listAlibabaZonesNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/alibaba/zones

Lists available Alibaba Instance Types

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
Regionheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAlibabaZoneListschema
defaulterrorResponseschema

Responses

200 - AlibabaZoneList

Status: OK

Schema

AlibabaZoneList

Default Response

errorResponse

Schema

ErrorResponse

List allowed registries. (listAllowedRegistries)

GET /api/v2/allowedregistries

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKAllowedRegistryschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - AllowedRegistry

Status: OK

Schema

[]AllowedRegistry

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list anexia templates (listAnexiaTemplates)

GET /api/v1/providers/anexia/templates

Lists templates from anexia

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
Credentialheaderstringstring
Locationheaderstringstring
Tokenheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAnexiaTemplateListschema
defaulterrorResponseschema

Responses

200 - AnexiaTemplateList

Status: OK

Schema

AnexiaTemplateList

Default Response

errorResponse

Schema

ErrorResponse

list anexia templates no credentials v2 (listAnexiaTemplatesNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/anexia/templates

Lists templates from Anexia

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAnexiaTemplateListschema
defaulterrorResponseschema

Responses

200 - AnexiaTemplateList

Status: OK

Schema

AnexiaTemplateList

Default Response

errorResponse

Schema

ErrorResponse

list anexia vlans (listAnexiaVlans)

GET /api/v1/providers/anexia/vlans

Lists vlans from anexia

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
Credentialheaderstringstring
Tokenheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAnexiaVlanListschema
defaulterrorResponseschema

Responses

200 - AnexiaVlanList

Status: OK

Schema

AnexiaVlanList

Default Response

errorResponse

Schema

ErrorResponse

list anexia vlans no credentials v2 (listAnexiaVlansNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/anexia/vlans

Lists vlans from Anexia

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAnexiaVlanListschema
defaulterrorResponseschema

Responses

200 - AnexiaVlanList

Status: OK

Schema

AnexiaVlanList

Default Response

errorResponse

Schema

ErrorResponse

list azure availability zones (listAzureAvailabilityZones)

GET /api/v1/providers/azure/availabilityzones

Lists VM availability zones in an Azure region

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKAzureAvailabilityZonesListschema
defaulterrorResponseschema

Responses

200 - AzureAvailabilityZonesList

Status: OK

Schema

AzureAvailabilityZonesList

Default Response

errorResponse

Schema

ErrorResponse

list azure availability zones no credentials (listAzureAvailabilityZonesNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/azure/availabilityzones

Lists available VM availability zones in an Azure region

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
SKUNameheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAzureAvailabilityZonesListschema
defaulterrorResponseschema

Responses

200 - AzureAvailabilityZonesList

Status: OK

Schema

AzureAvailabilityZonesList

Default Response

errorResponse

Schema

ErrorResponse

list azure availability zones no credentials v2 (listAzureAvailabilityZonesNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/azure/availabilityzones

Lists available VM availability zones in an Azure region

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
SKUNameheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAzureAvailabilityZonesListschema
defaulterrorResponseschema

Responses

200 - AzureAvailabilityZonesList

Status: OK

Schema

AzureAvailabilityZonesList

Default Response

errorResponse

Schema

ErrorResponse

list azure resource groups (listAzureResourceGroups)

GET /api/v2/providers/azure/resourcegroups

Lists available VM resource groups

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
ClientIDheaderstringstring
ClientSecretheaderstringstring
Credentialheaderstringstring
Locationheaderstringstring
SubscriptionIDheaderstringstring
TenantIDheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAzureResourceGroupsListschema
defaulterrorResponseschema

Responses

200 - AzureResourceGroupsList

Status: OK

Schema

AzureResourceGroupsList

Default Response

errorResponse

Schema

ErrorResponse

list azure route tables (listAzureRouteTables)

GET /api/v2/providers/azure/routetables

Lists available VM route tables

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
ClientIDheaderstringstring
ClientSecretheaderstringstring
Credentialheaderstringstring
Locationheaderstringstring
ResourceGroupheaderstringstring
SubscriptionIDheaderstringstring
TenantIDheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAzureRouteTablesListschema
defaulterrorResponseschema

Responses

200 - AzureRouteTablesList

Status: OK

Schema

AzureRouteTablesList

Default Response

errorResponse

Schema

ErrorResponse

list azure security groups (listAzureSecurityGroups)

GET /api/v2/providers/azure/securitygroups

Lists available VM security groups

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
ClientIDheaderstringstring
ClientSecretheaderstringstring
Credentialheaderstringstring
Locationheaderstringstring
ResourceGroupheaderstringstring
SubscriptionIDheaderstringstring
TenantIDheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAzureSecurityGroupsListschema
defaulterrorResponseschema

Responses

200 - AzureSecurityGroupsList

Status: OK

Schema

AzureSecurityGroupsList

Default Response

errorResponse

Schema

ErrorResponse

list azure sizes (listAzureSizes)

GET /api/v1/providers/azure/sizes

Lists available VM sizes in an Azure region

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
ClientIDheaderstringstring
ClientSecretheaderstringstring
Credentialheaderstringstring
Locationheaderstringstring
SubscriptionIDheaderstringstring
TenantIDheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAzureSizeListschema
defaulterrorResponseschema

Responses

200 - AzureSizeList

Status: OK

Schema

AzureSizeList

Default Response

errorResponse

Schema

ErrorResponse

list azure sizes no credentials (listAzureSizesNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/azure/sizes

Lists available VM sizes in an Azure region

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAzureSizeListschema
defaulterrorResponseschema

Responses

200 - AzureSizeList

Status: OK

Schema

AzureSizeList

Default Response

errorResponse

Schema

ErrorResponse

list azure sizes no credentials v2 (listAzureSizesNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/azure/sizes

Lists available VM sizes in an Azure region

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAzureSizeListschema
defaulterrorResponseschema

Responses

200 - AzureSizeList

Status: OK

Schema

AzureSizeList

Default Response

errorResponse

Schema

ErrorResponse

list azure subnets (listAzureSubnets)

GET /api/v2/providers/azure/subnets

Lists available VM subnets

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
ClientIDheaderstringstring
ClientSecretheaderstringstring
Credentialheaderstringstring
ResourceGroupheaderstringstring
SubscriptionIDheaderstringstring
TenantIDheaderstringstring
VirtualNetworkheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAzureSubnetsListschema
defaulterrorResponseschema

Responses

200 - AzureSubnetsList

Status: OK

Schema

AzureSubnetsList

Default Response

errorResponse

Schema

ErrorResponse

list azure vnets (listAzureVnets)

GET /api/v2/providers/azure/vnets

Lists available VM virtual networks

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
ClientIDheaderstringstring
ClientSecretheaderstringstring
Credentialheaderstringstring
Locationheaderstringstring
ResourceGroupheaderstringstring
SubscriptionIDheaderstringstring
TenantIDheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAzureVirtualNetworksListschema
defaulterrorResponseschema

Responses

200 - AzureVirtualNetworksList

Status: OK

Schema

AzureVirtualNetworksList

Default Response

errorResponse

Schema

ErrorResponse

list cluster role (listClusterRole)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/clusterroles

Lists all ClusterRoles

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterRoleschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterRole

Status: OK

Schema

[]ClusterRole

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list cluster role binding (listClusterRoleBinding)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/clusterbindings

List cluster role binding

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterRoleBindingschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterRoleBinding

Status: OK

Schema

[]ClusterRoleBinding

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list cluster role binding v2 (listClusterRoleBindingV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/clusterbindings

List cluster role binding

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterRoleBindingschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterRoleBinding

Status: OK

Schema

[]ClusterRoleBinding

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list cluster role names (listClusterRoleNames)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/clusterrolenames

Lists all ClusterRoles

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterRoleNameschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterRoleName

Status: OK

Schema

[]ClusterRoleName

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list cluster role names v2 (listClusterRoleNamesV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/clusterrolenames

Lists all ClusterRoles

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterRoleNameschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterRoleName

Status: OK

Schema

[]ClusterRoleName

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list cluster role v2 (listClusterRoleV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/clusterroles

Lists all ClusterRoles

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterRoleschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterRole

Status: OK

Schema

[]ClusterRole

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

List cluster templates for the given project. (listClusterTemplates)

GET /api/v2/projects/{project_id}/clustertemplates

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterTemplateListschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterTemplateList

Status: OK

Schema

ClusterTemplateList

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Lists clusters for the specified project and data center. (listClusters)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterListschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterList

Status: OK

Schema

ClusterList

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Lists clusters for the specified project. (listClustersForProject)

GET /api/v1/projects/{project_id}/clusters

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterListschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterList

Status: OK

Schema

ClusterList

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Lists clusters for the specified project. (listClustersV2)

GET /api/v2/projects/{project_id}/clusters

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterListschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterList

Status: OK

Schema

ClusterList

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

List constraint templates. (listConstraintTemplates)

GET /api/v2/constrainttemplates

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKConstraintTemplateschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ConstraintTemplate

Status: OK

Schema

[]ConstraintTemplate

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Lists constraints for the specified cluster. (listConstraints)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/constraints

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKConstraintschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Constraint

Status: OK

Schema

[]Constraint

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list credentials (listCredentials)

GET /api/v1/providers/{provider_name}/presets/credentials

Lists credential names for the provider

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
provider_namepathstringstring
datacenterquerystringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKCredentialListschema
defaulterrorResponseschema

Responses

200 - CredentialList

Status: OK

Schema

CredentialList

Default Response

errorResponse

Schema

ErrorResponse

Returns all datacenters for the specified provider. (listDCForProvider)

GET /api/v1/providers/{provider_name}/dc

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
provider_namepathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKDatacenterschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Datacenter

Status: OK

Schema

[]Datacenter

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Returns all datacenters for the specified seed. (listDCForSeed)

GET /api/v1/seed/{seed_name}/dc

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
seed_namepathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKDatacenterschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Datacenter

Status: OK

Schema

[]Datacenter

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list datacenters (listDatacenters)

GET /api/v1/dc

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKDatacenterListschema
defaulterrorResponseschema

Responses

200 - DatacenterList

Status: OK

Schema

DatacenterList

Default Response

errorResponse

Schema

ErrorResponse

List default constraint. (listDefaultConstraint)

GET /api/v2/constraints

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKConstraintschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Constraint

Status: OK

Schema

[]Constraint

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list digitalocean sizes (listDigitaloceanSizes)

GET /api/v1/providers/digitalocean/sizes

Lists sizes from digitalocean

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
Credentialheaderstringstring
DoTokenheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKDigitaloceanSizeListschema
defaulterrorResponseschema

Responses

200 - DigitaloceanSizeList

Status: OK

Schema

DigitaloceanSizeList

Default Response

errorResponse

Schema

ErrorResponse

list digitalocean sizes no credentials (listDigitaloceanSizesNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/digitalocean/sizes

Lists sizes from digitalocean

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKDigitaloceanSizeListschema
defaulterrorResponseschema

Responses

200 - DigitaloceanSizeList

Status: OK

Schema

DigitaloceanSizeList

Default Response

errorResponse

Schema

ErrorResponse

list digitalocean sizes no credentials v2 (listDigitaloceanSizesNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/digitalocean/sizes

Lists sizes from digitalocean

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKDigitaloceanSizeListschema
defaulterrorResponseschema

Responses

200 - DigitaloceanSizeList

Status: OK

Schema

DigitaloceanSizeList

Default Response

errorResponse

Schema

ErrorResponse

list etcd backup config (listEtcdBackupConfig)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/etcdbackupconfigs

List etcd backup configs for a given cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEtcdBackupConfigschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EtcdBackupConfig

Status: OK

Schema

[]EtcdBackupConfig

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list etcd restore (listEtcdRestore)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/etcdrestores

List etcd backup restores for a given cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEtcdRestoreschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EtcdRestore

Status: OK

Schema

[]EtcdRestore

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets an external cluster events. (listExternalClusterEvents)

GET /api/v2/projects/{project_id}/kubernetes/clusters/{cluster_id}/events

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
typequerystringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEventschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Event

Status: OK

Schema

[]Event

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets an external cluster nodes. (listExternalClusterNodes)

GET /api/v2/projects/{project_id}/kubernetes/clusters/{cluster_id}/nodes

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Node

Status: OK

Schema

[]Node

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Gets an external cluster nodes metrics. (listExternalClusterNodesMetrics)

GET /api/v2/projects/{project_id}/kubernetes/clusters/{cluster_id}/nodesmetrics

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeMetricschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - NodeMetric

Status: OK

Schema

[]NodeMetric

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Lists external clusters for the specified project. (listExternalClusters)

GET /api/v2/projects/{project_id}/kubernetes/clusters

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterListschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterList

Status: OK

Schema

ClusterList

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list g c p disk types (listGCPDiskTypes)

GET /api/v1/providers/gcp/disktypes

Lists disk types from GCP

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
Credentialheaderstringstring
ServiceAccountheaderstringstring
Zoneheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKGCPDiskTypeListschema
defaulterrorResponseschema

Responses

200 - GCPDiskTypeList

Status: OK

Schema

GCPDiskTypeList

Default Response

errorResponse

Schema

ErrorResponse

list g c p disk types no credentials (listGCPDiskTypesNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/gcp/disktypes

Lists disk types from GCP

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
Zoneheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKGCPDiskTypeListschema
defaulterrorResponseschema

Responses

200 - GCPDiskTypeList

Status: OK

Schema

GCPDiskTypeList

Default Response

errorResponse

Schema

ErrorResponse

list g c p disk types no credentials v2 (listGCPDiskTypesNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/gcp/disktypes

Lists disk types from GCP

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
Zoneheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKGCPDiskTypeListschema
defaulterrorResponseschema

Responses

200 - GCPDiskTypeList

Status: OK

Schema

GCPDiskTypeList

Default Response

errorResponse

Schema

ErrorResponse

list g c p networks (listGCPNetworks)

GET /api/v1/providers/gcp/networks

Lists networks from GCP

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKGCPNetworkListschema
defaulterrorResponseschema

Responses

200 - GCPNetworkList

Status: OK

Schema

GCPNetworkList

Default Response

errorResponse

Schema

ErrorResponse

list g c p networks no credentials (listGCPNetworksNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/gcp/networks

Lists available GCP networks

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKGCPNetworkListschema
defaulterrorResponseschema

Responses

200 - GCPNetworkList

Status: OK

Schema

GCPNetworkList

Default Response

errorResponse

Schema

ErrorResponse

list g c p networks no credentials v2 (listGCPNetworksNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/gcp/networks

Lists available GCP networks

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKGCPNetworkListschema
defaulterrorResponseschema

Responses

200 - GCPNetworkList

Status: OK

Schema

GCPNetworkList

Default Response

errorResponse

Schema

ErrorResponse

list g c p sizes (listGCPSizes)

GET /api/v1/providers/gcp/sizes

Lists machine sizes from GCP

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
Credentialheaderstringstring
ServiceAccountheaderstringstring
Zoneheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKGCPMachineSizeListschema
defaulterrorResponseschema

Responses

200 - GCPMachineSizeList

Status: OK

Schema

GCPMachineSizeList

Default Response

errorResponse

Schema

ErrorResponse

list g c p sizes no credentials (listGCPSizesNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/gcp/sizes

Lists machine sizes from GCP

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
Zoneheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKGCPMachineSizeListschema
defaulterrorResponseschema

Responses

200 - GCPMachineSizeList

Status: OK

Schema

GCPMachineSizeList

Default Response

errorResponse

Schema

ErrorResponse

list g c p sizes no credentials v2 (listGCPSizesNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/gcp/sizes

Lists machine sizes from GCP

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
Zoneheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKGCPMachineSizeListschema
defaulterrorResponseschema

Responses

200 - GCPMachineSizeList

Status: OK

Schema

GCPMachineSizeList

Default Response

errorResponse

Schema

ErrorResponse

list g c p subnetworks (listGCPSubnetworks)

GET /api/v1/providers/gcp/{dc}/subnetworks

Lists subnetworks from GCP

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
dcpathstringstring
Credentialheaderstringstring
Networkheaderstringstring
ServiceAccountheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKGCPSubnetworkListschema
defaulterrorResponseschema

Responses

200 - GCPSubnetworkList

Status: OK

Schema

GCPSubnetworkList

Default Response

errorResponse

Schema

ErrorResponse

list g c p subnetworks no credentials (listGCPSubnetworksNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/gcp/subnetworks

Lists available GCP subnetworks

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
Networkheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKGCPSubnetworkListschema
defaulterrorResponseschema

Responses

200 - GCPSubnetworkList

Status: OK

Schema

GCPSubnetworkList

Default Response

errorResponse

Schema

ErrorResponse

list g c p subnetworks no credentials v2 (listGCPSubnetworksNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/gcp/subnetworks

Lists available GCP subnetworks

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
Networkheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKGCPSubnetworkListschema
defaulterrorResponseschema

Responses

200 - GCPSubnetworkList

Status: OK

Schema

GCPSubnetworkList

Default Response

errorResponse

Schema

ErrorResponse

list g c p zones (listGCPZones)

GET /api/v1/providers/gcp/{dc}/zones

Lists available GCP zones

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
dcpathstringstring
Credentialheaderstringstring
ServiceAccountheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKGCPZoneListschema
defaulterrorResponseschema

Responses

200 - GCPZoneList

Status: OK

Schema

GCPZoneList

Default Response

errorResponse

Schema

ErrorResponse

list g c p zones no credentials (listGCPZonesNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/gcp/zones

Lists available GCP zones

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKGCPZoneListschema
defaulterrorResponseschema

Responses

200 - GCPZoneList

Status: OK

Schema

GCPZoneList

Default Response

errorResponse

Schema

ErrorResponse

list g c p zones no credentials v2 (listGCPZonesNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/gcp/zones

Lists available GCP zones

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKGCPZoneListschema
defaulterrorResponseschema

Responses

200 - GCPZoneList

Status: OK

Schema

GCPZoneList

Default Response

errorResponse

Schema

ErrorResponse

list hetzner sizes (listHetznerSizes)

GET /api/v1/providers/hetzner/sizes

Lists sizes from hetzner

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
Credentialheaderstringstring
HetznerTokenheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKHetznerSizeListschema
defaulterrorResponseschema

Responses

200 - HetznerSizeList

Status: OK

Schema

HetznerSizeList

Default Response

errorResponse

Schema

ErrorResponse

list hetzner sizes no credentials (listHetznerSizesNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/hetzner/sizes

Lists sizes from hetzner

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKHetznerSizeListschema
defaulterrorResponseschema

Responses

200 - HetznerSizeList

Status: OK

Schema

HetznerSizeList

Default Response

errorResponse

Schema

ErrorResponse

list hetzner sizes no credentials v2 (listHetznerSizesNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/hetzner/sizes

Lists sizes from hetzner

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKHetznerSizeListschema
defaulterrorResponseschema

Responses

200 - HetznerSizeList

Status: OK

Schema

HetznerSizeList

Default Response

errorResponse

Schema

ErrorResponse

list installable addons (listInstallableAddons)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/installableaddons

Lists names of addons that can be installed inside the user cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAccessibleAddonsschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - AccessibleAddons

Status: OK

Schema

AccessibleAddons

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list installable addons v2 (listInstallableAddonsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/installableaddons

Lists names of addons that can be installed inside the user cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKAccessibleAddonsschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - AccessibleAddons

Status: OK

Schema

AccessibleAddons

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Lists metrics that belong to the given machine deployment. (listMachineDeploymentMetrics)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments/{machinedeployment_id}/nodes/metrics

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
machinedeployment_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeMetricschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - NodeMetric

Status: OK

Schema

[]NodeMetric

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Lists nodes that belong to the given machine deployment. (listMachineDeploymentNodes)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments/{machinedeployment_id}/nodes

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
machinedeployment_idpathstringstring
project_idpathstringstring
hideInitialConditionsquerybooleanbool

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Node

Status: OK

Schema

[]Node

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Lists machine deployment events. If query parameter type is set to warning then only warning events are retrieved. (listMachineDeploymentNodesEvents)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments/{machinedeployment_id}/nodes/events

If the value is 'normal' then normal events are returned. If the query parameter is missing method returns all events.

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
machinedeployment_idpathstringstring
project_idpathstringstring
typequerystringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEventschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Event

Status: OK

Schema

[]Event

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list machine deployments (listMachineDeployments)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments

Lists machine deployments that belong to the given cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeDeploymentschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - NodeDeployment

Status: OK

Schema

[]NodeDeployment

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list metering reports (listMeteringReports)

GET /api/v1/admin/metering/reports

List metering reports. Only available in Kubermatic Enterprise Edition

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
max_keysqueryint64 (formatted integer)int64
start_afterquerystringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKMeteringReportschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - MeteringReport

Status: OK

Schema

[]MeteringReport

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list namespace (listNamespace)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/namespaces

Lists all namespaces in the cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKNamespaceschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Namespace

Status: OK

Schema

[]Namespace

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list namespace v2 (listNamespaceV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/namespaces

Lists all namespaces in the cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKNamespaceschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Namespace

Status: OK

Schema

[]Namespace

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Lists metrics that belong to the given node deployment. (listNodeDeploymentMetrics)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodedeployments/{nodedeployment_id}/nodes/metrics

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
nodedeployment_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeMetricschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - NodeMetric

Status: OK

Schema

[]NodeMetric

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Lists nodes that belong to the given node deployment. (listNodeDeploymentNodes)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodedeployments/{nodedeployment_id}/nodes

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
nodedeployment_idpathstringstring
project_idpathstringstring
hideInitialConditionsquerybooleanbool

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Node

Status: OK

Schema

[]Node

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Lists node deployment events. If query parameter type is set to warning then only warning events are retrieved. (listNodeDeploymentNodesEvents)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodedeployments/{nodedeployment_id}/nodes/events

If the value is 'normal' then normal events are returned. If the query parameter is missing method returns all events.

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
nodedeployment_idpathstringstring
project_idpathstringstring
typequerystringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEventschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Event

Status: OK

Schema

[]Event

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list node deployment requests (listNodeDeploymentRequests)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/ndrequests

Lists NodeDeploymentRequests that belong to the given cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeDeploymentRequestschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - NodeDeploymentRequest

Status: OK

Schema

[]NodeDeploymentRequest

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list node deployments (listNodeDeployments)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodedeployments

Lists node deployments that belong to the given cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeDeploymentschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - NodeDeployment

Status: OK

Schema

[]NodeDeployment

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

This endpoint is used for kubeadm cluster. (listNodesForCluster)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/nodes

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
hideInitialConditionsquerybooleanbool

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Node

Status: OK

Schema

[]Node

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list openstack availability zones (listOpenstackAvailabilityZones)

GET /api/v1/providers/openstack/availabilityzones

Lists availability zones from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
ApplicationCredentialIDheaderstringstring
ApplicationCredentialSecretheaderstringstring
Credentialheaderstringstring
DatacenterNameheaderstringstring
Domainheaderstringstring
OIDCAuthenticationheaderbooleanbool
Passwordheaderstringstring
Tenantheaderstringstring
TenantIDheaderstringstring
Usernameheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackAvailabilityZoneschema
defaulterrorResponseschema

Responses

200 - OpenstackAvailabilityZone

Status: OK

Schema

[]OpenstackAvailabilityZone

Default Response

errorResponse

Schema

ErrorResponse

list openstack availability zones no credentials (listOpenstackAvailabilityZonesNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/openstack/availabilityzones

Lists availability zones from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackAvailabilityZoneschema
defaulterrorResponseschema

Responses

200 - OpenstackAvailabilityZone

Status: OK

Schema

[]OpenstackAvailabilityZone

Default Response

errorResponse

Schema

ErrorResponse

list openstack availability zones no credentials v2 (listOpenstackAvailabilityZonesNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/openstack/availabilityzones

Lists availability zones from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackAvailabilityZoneschema
defaulterrorResponseschema

Responses

200 - OpenstackAvailabilityZone

Status: OK

Schema

[]OpenstackAvailabilityZone

Default Response

errorResponse

Schema

ErrorResponse

list openstack images (listOpenstackImages)

GET /api/v1/providers/openstack/images

Lists images from openstack

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKImageschema
defaulterrorResponseschema

Responses

200 - Image

Status: OK

Schema

[]Image

Default Response

errorResponse

Schema

ErrorResponse

list openstack images no credentials (listOpenstackImagesNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/openstack/images

Lists images from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKImageschema
defaulterrorResponseschema

Responses

200 - Image

Status: OK

Schema

[]Image

Default Response

errorResponse

Schema

ErrorResponse

list openstack networks (listOpenstackNetworks)

GET /api/v1/providers/openstack/networks

Lists networks from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
ApplicationCredentialIDheaderstringstring
ApplicationCredentialSecretheaderstringstring
Credentialheaderstringstring
DatacenterNameheaderstringstring
Domainheaderstringstring
OIDCAuthenticationheaderbooleanbool
Passwordheaderstringstring
Tenantheaderstringstring
TenantIDheaderstringstring
Usernameheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackNetworkschema
defaulterrorResponseschema

Responses

200 - OpenstackNetwork

Status: OK

Schema

[]OpenstackNetwork

Default Response

errorResponse

Schema

ErrorResponse

list openstack networks no credentials (listOpenstackNetworksNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/openstack/networks

Lists networks from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackNetworkschema
defaulterrorResponseschema

Responses

200 - OpenstackNetwork

Status: OK

Schema

[]OpenstackNetwork

Default Response

errorResponse

Schema

ErrorResponse

list openstack networks no credentials v2 (listOpenstackNetworksNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/openstack/networks

Lists networks from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackNetworkschema
defaulterrorResponseschema

Responses

200 - OpenstackNetwork

Status: OK

Schema

[]OpenstackNetwork

Default Response

errorResponse

Schema

ErrorResponse

list openstack quota limits (listOpenstackQuotaLimits)

GET /api/v1/providers/openstack/quotalimits

Lists quotalimits for tenant from openstack

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKQuotasschema
defaulterrorResponseschema

Responses

200 - Quotas

Status: OK

Schema

Quotas

Default Response

errorResponse

Schema

ErrorResponse

list openstack quota limits no credentials (listOpenstackQuotaLimitsNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/openstack/quotalimits

Lists quotalimits for tenant from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKQuotasschema
defaulterrorResponseschema

Responses

200 - Quotas

Status: OK

Schema

Quotas

Default Response

errorResponse

Schema

ErrorResponse

list openstack security groups (listOpenstackSecurityGroups)

GET /api/v1/providers/openstack/securitygroups

Lists security groups from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
ApplicationCredentialIDheaderstringstring
ApplicationCredentialSecretheaderstringstring
Credentialheaderstringstring
DatacenterNameheaderstringstring
Domainheaderstringstring
OIDCAuthenticationheaderbooleanbool
Passwordheaderstringstring
Tenantheaderstringstring
TenantIDheaderstringstring
Usernameheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackSecurityGroupschema
defaulterrorResponseschema

Responses

200 - OpenstackSecurityGroup

Status: OK

Schema

[]OpenstackSecurityGroup

Default Response

errorResponse

Schema

ErrorResponse

list openstack security groups no credentials (listOpenstackSecurityGroupsNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/openstack/securitygroups

Lists security groups from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackSecurityGroupschema
defaulterrorResponseschema

Responses

200 - OpenstackSecurityGroup

Status: OK

Schema

[]OpenstackSecurityGroup

Default Response

errorResponse

Schema

ErrorResponse

list openstack security groups no credentials v2 (listOpenstackSecurityGroupsNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/openstack/securitygroups

Lists security groups from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackSecurityGroupschema
defaulterrorResponseschema

Responses

200 - OpenstackSecurityGroup

Status: OK

Schema

[]OpenstackSecurityGroup

Default Response

errorResponse

Schema

ErrorResponse

list openstack sizes (listOpenstackSizes)

GET /api/v1/providers/openstack/sizes

Lists sizes from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
ApplicationCredentialIDheaderstringstring
ApplicationCredentialSecretheaderstringstring
Credentialheaderstringstring
DatacenterNameheaderstringstring
Domainheaderstringstring
OIDCAuthenticationheaderbooleanbool
Passwordheaderstringstring
Tenantheaderstringstring
TenantIDheaderstringstring
Usernameheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackSizeschema
defaulterrorResponseschema

Responses

200 - OpenstackSize

Status: OK

Schema

[]OpenstackSize

Default Response

errorResponse

Schema

ErrorResponse

list openstack sizes no credentials (listOpenstackSizesNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/openstack/sizes

Lists sizes from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackSizeschema
defaulterrorResponseschema

Responses

200 - OpenstackSize

Status: OK

Schema

[]OpenstackSize

Default Response

errorResponse

Schema

ErrorResponse

list openstack sizes no credentials v2 (listOpenstackSizesNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/openstack/sizes

Lists sizes from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackSizeschema
defaulterrorResponseschema

Responses

200 - OpenstackSize

Status: OK

Schema

[]OpenstackSize

Default Response

errorResponse

Schema

ErrorResponse

list openstack subnets (listOpenstackSubnets)

GET /api/v1/providers/openstack/subnets

Lists subnets from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
ApplicationCredentialIDheaderstringstring
ApplicationCredentialSecretheaderstringstring
Credentialheaderstringstring
DatacenterNameheaderstringstring
Domainheaderstringstring
OIDCAuthenticationheaderbooleanbool
Passwordheaderstringstring
Tenantheaderstringstring
TenantIDheaderstringstring
Usernameheaderstringstring
network_idquerystringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackSubnetschema
defaulterrorResponseschema

Responses

200 - OpenstackSubnet

Status: OK

Schema

[]OpenstackSubnet

Default Response

errorResponse

Schema

ErrorResponse

list openstack subnets no credentials (listOpenstackSubnetsNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/openstack/subnets

Lists subnets from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
network_idquerystringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackSubnetschema
defaulterrorResponseschema

Responses

200 - OpenstackSubnet

Status: OK

Schema

[]OpenstackSubnet

Default Response

errorResponse

Schema

ErrorResponse

list openstack subnets no credentials v2 (listOpenstackSubnetsNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/openstack/subnets

Lists subnets from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
network_idquerystringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackSubnetschema
defaulterrorResponseschema

Responses

200 - OpenstackSubnet

Status: OK

Schema

[]OpenstackSubnet

Default Response

errorResponse

Schema

ErrorResponse

list openstack tenants (listOpenstackTenants)

GET /api/v1/providers/openstack/tenants

Lists tenants from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
ApplicationCredentialIDheaderstringstring
ApplicationCredentialSecretheaderstringstring
Credentialheaderstringstring
DatacenterNameheaderstringstring
Domainheaderstringstring
OIDCAuthenticationheaderbooleanbool
Passwordheaderstringstring
Usernameheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackTenantschema
defaulterrorResponseschema

Responses

200 - OpenstackTenant

Status: OK

Schema

[]OpenstackTenant

Default Response

errorResponse

Schema

ErrorResponse

list openstack tenants no credentials (listOpenstackTenantsNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/openstack/tenants

Lists tenants from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackTenantschema
defaulterrorResponseschema

Responses

200 - OpenstackTenant

Status: OK

Schema

[]OpenstackTenant

Default Response

errorResponse

Schema

ErrorResponse

list openstack tenants no credentials v2 (listOpenstackTenantsNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/openstack/tenants

Lists tenants from openstack

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKOpenstackTenantschema
defaulterrorResponseschema

Responses

200 - OpenstackTenant

Status: OK

Schema

[]OpenstackTenant

Default Response

errorResponse

Schema

ErrorResponse

list packet sizes (listPacketSizes)

GET /api/v1/providers/packet/sizes

Lists sizes from packet

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
apiKeyheaderstringstring
credentialheaderstringstring
projectIDheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKPacketSizeListschema
defaulterrorResponseschema

Responses

200 - PacketSizeList

Status: OK

Schema

[]PacketSizeList

Default Response

errorResponse

Schema

ErrorResponse

list packet sizes no credentials (listPacketSizesNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/packet/sizes

Lists sizes from packet

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKPacketSizeListschema
defaulterrorResponseschema

Responses

200 - PacketSizeList

Status: OK

Schema

[]PacketSizeList

Default Response

errorResponse

Schema

ErrorResponse

list packet sizes no credentials v2 (listPacketSizesNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/packet/sizes

Lists sizes from packet

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKPacketSizeListschema
defaulterrorResponseschema

Responses

200 - PacketSizeList

Status: OK

Schema

[]PacketSizeList

Default Response

errorResponse

Schema

ErrorResponse

list presets (listPresets)

GET /api/v2/presets

Lists presets

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
disabledquerybooleanbool

All responses

CodeStatusDescriptionHas headersSchema
200OKPresetListschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - PresetList

Status: OK

Schema

PresetList

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list project etcd backup config (listProjectEtcdBackupConfig)

GET /api/v2/projects/{project_id}/etcdbackupconfigs

List etcd backup configs for a given project

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
typequerystringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEtcdBackupConfigschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EtcdBackupConfig

Status: OK

Schema

[]EtcdBackupConfig

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list project etcd restore (listProjectEtcdRestore)

GET /api/v2/projects/{project_id}/etcdrestores

List etcd backup restores for a given project

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEtcdRestoreschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EtcdRestore

Status: OK

Schema

[]EtcdRestore

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Lists projects that an authenticated user is a member of. (listProjects)

GET /api/v1/projects

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
displayAllquerybooleanbool

All responses

CodeStatusDescriptionHas headersSchema
200OKProjectschema
401UnauthorizedEmptyResponse is a empty responseschema
409ConflictEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Project

Status: OK

Schema

[]Project

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
409 - EmptyResponse is a empty response

Status: Conflict

Schema
Default Response

errorResponse

Schema

ErrorResponse

list provider presets (listProviderPresets)

GET /api/v2/providers/{provider_name}/presets

Lists presets for the provider

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
provider_namepathstringstring
datacenterquerystringstring
disabledquerybooleanbool

All responses

CodeStatusDescriptionHas headersSchema
200OKPresetListschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - PresetList

Status: OK

Schema

PresetList

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list role (listRole)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/roles

Lists all Roles

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKRoleschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Role

Status: OK

Schema

[]Role

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list role binding (listRoleBinding)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/bindings

List role binding

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKRoleBindingschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - RoleBinding

Status: OK

Schema

[]RoleBinding

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list role binding v2 (listRoleBindingV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/bindings

List role binding

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKRoleBindingschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - RoleBinding

Status: OK

Schema

[]RoleBinding

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list role names (listRoleNames)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/rolenames

Lists all Role names with namespaces

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKRoleNameschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - RoleName

Status: OK

Schema

[]RoleName

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list role names v2 (listRoleNamesV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/rolenames

Lists all Role names with namespaces

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKRoleNameschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - RoleName

Status: OK

Schema

[]RoleName

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list role v2 (listRoleV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/roles

Lists all Roles

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKRoleschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Role

Status: OK

Schema

[]Role

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list rule groups (listRuleGroups)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/rulegroups

Lists rule groups that belong to the given cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
typequerystringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKRuleGroupschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - RuleGroup

Status: OK

Schema

[]RuleGroup

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Lists SSH Keys that belong to the given project. (listSSHKeys)

GET /api/v1/projects/{project_id}/sshkeys

The returned collection is sorted by creation timestamp.

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKSSHKeyschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - SSHKey

Status: OK

Schema

[]SSHKey

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list SSH keys assigned to cluster (listSSHKeysAssignedToCluster)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/sshkeys

Lists ssh keys that are assigned to the cluster The returned collection is sorted by creation timestamp.

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKSSHKeyschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - SSHKey

Status: OK

Schema

[]SSHKey

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list SSH keys assigned to cluster v2 (listSSHKeysAssignedToClusterV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/sshkeys

Lists ssh keys that are assigned to the cluster The returned collection is sorted by creation timestamp.

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKSSHKeyschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - SSHKey

Status: OK

Schema

[]SSHKey

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list seed names (listSeedNames)

GET /api/v1/seed

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKSeedNamesListschema
defaulterrorResponseschema

Responses

200 - SeedNamesList

Status: OK

Schema

SeedNamesList

Default Response

errorResponse

Schema

ErrorResponse

Returns all seeds from the CRDs. (listSeeds)

GET /api/v1/admin/seeds

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKSeedschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Seed

Status: OK

Schema

[]Seed

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list service account tokens (listServiceAccountTokens)

GET /api/v1/projects/{project_id}/serviceaccounts/{serviceaccount_id}/tokens

List tokens for the given service account

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
serviceaccount_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKPublicServiceAccountTokenschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - PublicServiceAccountToken

Status: OK

Schema

[]PublicServiceAccountToken

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list service accounts (listServiceAccounts)

GET /api/v1/projects/{project_id}/serviceaccounts

List Service Accounts for the given project

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKServiceAccountschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ServiceAccount

Status: OK

Schema

[]ServiceAccount

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list system labels (listSystemLabels)

GET /api/v1/labels/system

List restricted system labels

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKResourceLabelMapschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ResourceLabelMap

Status: OK

Schema

ResourceLabelMap

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

list v sphere datastores (listVSphereDatastores)

GET /api/v2/providers/vsphere/datastores

Lists datastores from vsphere datacenter

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
Credentialheaderstringstring
DatacenterNameheaderstringstring
Passwordheaderstringstring
Usernameheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKVSphereDatastoreListschema
defaulterrorResponseschema

Responses

200 - VSphereDatastoreList

Status: OK

Schema

[]VSphereDatastoreList

Default Response

errorResponse

Schema

ErrorResponse

list v sphere folders (listVSphereFolders)

GET /api/v1/providers/vsphere/folders

Lists folders from vsphere datacenter

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
Credentialheaderstringstring
DatacenterNameheaderstringstring
Passwordheaderstringstring
Usernameheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKVSphereFolderschema
defaulterrorResponseschema

Responses

200 - VSphereFolder

Status: OK

Schema

[]VSphereFolder

Default Response

errorResponse

Schema

ErrorResponse

list v sphere folders no credentials (listVSphereFoldersNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/vsphere/folders

Lists folders from vsphere datacenter

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKVSphereFolderschema
defaulterrorResponseschema

Responses

200 - VSphereFolder

Status: OK

Schema

[]VSphereFolder

Default Response

errorResponse

Schema

ErrorResponse

list v sphere folders no credentials v2 (listVSphereFoldersNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/vsphere/folders

Lists folders from vsphere datacenter

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKVSphereFolderschema
defaulterrorResponseschema

Responses

200 - VSphereFolder

Status: OK

Schema

[]VSphereFolder

Default Response

errorResponse

Schema

ErrorResponse

list v sphere networks (listVSphereNetworks)

GET /api/v1/providers/vsphere/networks

Lists networks from vsphere datacenter

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
Credentialheaderstringstring
DatacenterNameheaderstringstring
Passwordheaderstringstring
Usernameheaderstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKVSphereNetworkschema
defaulterrorResponseschema

Responses

200 - VSphereNetwork

Status: OK

Schema

[]VSphereNetwork

Default Response

errorResponse

Schema

ErrorResponse

list v sphere networks no credentials (listVSphereNetworksNoCredentials)

GET /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/providers/vsphere/networks

Lists networks from vsphere datacenter

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKVSphereNetworkschema
defaulterrorResponseschema

Responses

200 - VSphereNetwork

Status: OK

Schema

[]VSphereNetwork

Default Response

errorResponse

Schema

ErrorResponse

list v sphere networks no credentials v2 (listVSphereNetworksNoCredentialsV2)

GET /api/v2/projects/{project_id}/clusters/{cluster_id}/providers/vsphere/networks

Lists networks from vsphere datacenter

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKVSphereNetworkschema
defaulterrorResponseschema

Responses

200 - VSphereNetwork

Status: OK

Schema

[]VSphereNetwork

Default Response

errorResponse

Schema

ErrorResponse

list versions by provider (listVersionsByProvider)

GET /api/v2/providers/{provider_name}/versions

Lists all versions which don't result in automatic updates for a given provider

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
provider_namepathstringstring
typequerystringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKVersionListschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - VersionList

Status: OK

Schema

VersionList

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Adds current authorization bearer token to the blacklist. (logoutCurrentUser)

POST /api/v1/me/logout

Enforces user to login again with the new token.

Produces

  • application/json

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
Default Response

errorResponse

Schema

ErrorResponse

migrate cluster to external c c m (migrateClusterToExternalCCM)

POST /api/v2/projects/{project_id}/clusters/{cluster_id}/externalccmmigration

Enable the migration to the external CCM for the given cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Patches an addon that is assigned to the given cluster. (patchAddon)

PATCH /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/addons/{addon_id}

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
addon_idpathstringstring
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
BodybodyAddonmodels.Addon

All responses

CodeStatusDescriptionHas headersSchema
200OKAddonschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Addon

Status: OK

Schema

Addon

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Patches an addon that is assigned to the given cluster. (patchAddonV2)

PATCH /api/v2/projects/{project_id}/clusters/{cluster_id}/addons/{addon_id}

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
addon_idpathstringstring
cluster_idpathstringstring
project_idpathstringstring
BodybodyAddonmodels.Addon

All responses

CodeStatusDescriptionHas headersSchema
200OKAddonschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Addon

Status: OK

Schema

Addon

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

patch allowed registry (patchAllowedRegistry)

PATCH /api/v2/allowedregistries/{allowed_registry}

Patch a specified allowed registry

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
allowed_registrypathstringstring
Patchbodyinterface{}interface{}

All responses

CodeStatusDescriptionHas headersSchema
200OKConstraintTemplateschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ConstraintTemplate

Status: OK

Schema

ConstraintTemplate

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Patches the given cluster using JSON Merge Patch method (https://tools.ietf.org/html/rfc7396). (patchCluster)

PATCH /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
Patchbodyinterface{}interface{}

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Cluster

Status: OK

Schema

Cluster

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

patch cluster role (patchClusterRole)

PATCH /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/clusterroles/{role_id}

Patch the cluster role with the given name

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
role_idpathstringstring
Patchbodyinterface{}interface{}

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterRoleschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterRole

Status: OK

Schema

ClusterRole

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Patches the given cluster using JSON Merge Patch method (https://tools.ietf.org/html/rfc7396). (patchClusterV2)

PATCH /api/v2/projects/{project_id}/clusters/{cluster_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
Patchbodyinterface{}interface{}

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Cluster

Status: OK

Schema

Cluster

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Patches a given constraint for the specified cluster. (patchConstraint)

PATCH /api/v2/projects/{project_id}/clusters/{cluster_id}/constraints/{constraint_name}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
constraint_namepathstringstring
project_idpathstringstring
Patchbodyinterface{}interface{}

All responses

CodeStatusDescriptionHas headersSchema
200OKConstraintschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Constraint

Status: OK

Schema

Constraint

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

patch constraint template (patchConstraintTemplate)

PATCH /api/v2/constrainttemplates/{ct_name}

Patch a specified constraint template

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
ct_namepathstringstring
Patchbodyinterface{}interface{}

All responses

CodeStatusDescriptionHas headersSchema
200OKConstraintTemplateschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ConstraintTemplate

Status: OK

Schema

ConstraintTemplate

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Updates settings of the current user. (patchCurrentUserSettings)

PATCH /api/v1/me/settings

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
Patchbodyinterface{}interface{}

All responses

CodeStatusDescriptionHas headersSchema
200OKUserSettingsschema
401UnauthorizedEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - UserSettings

Status: OK

Schema

UserSettings

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
Default Response

errorResponse

Schema

ErrorResponse

Patch the datacenter. (patchDC)

PATCH /api/v1/seed/{seed_name}/dc/{dc}

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
dcpathstringstring
seed_namepathstringstring
Patchbodyinterface{}interface{}

All responses

CodeStatusDescriptionHas headersSchema
200OKDatacenterschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Datacenter

Status: OK

Schema

Datacenter

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

patch default constraint (patchDefaultConstraint)

PATCH /api/v2/constraints/{constraint_name}

Patch a specified default constraint

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
constraint_namepathstringstring
Patchbodyinterface{}interface{}

All responses

CodeStatusDescriptionHas headersSchema
200OKConstraintschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Constraint

Status: OK

Schema

Constraint

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

patch etcd backup config (patchEtcdBackupConfig)

PATCH /api/v2/projects/{project_id}/clusters/{cluster_id}/etcdbackupconfigs/{ebc_id}

Patches a etcd backup config for a given cluster based on its id

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
ebc_idpathstringstring
project_idpathstringstring
BodybodyEtcdBackupConfigSpecmodels.EtcdBackupConfigSpec

All responses

CodeStatusDescriptionHas headersSchema
200OKEtcdBackupConfigschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EtcdBackupConfig

Status: OK

Schema

EtcdBackupConfig

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Patches the gatekeeper config for the specified cluster. (patchGatekeeperConfig)

PATCH /api/v2/projects/{project_id}/clusters/{cluster_id}/gatekeeper/config

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
Patchbodyinterface{}interface{}

All responses

CodeStatusDescriptionHas headersSchema
200OKGatekeeperConfigschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - GatekeeperConfig

Status: OK

Schema

GatekeeperConfig

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Patches the global settings. (patchKubermaticSettings)

PATCH /api/v1/admin/settings

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
Patchbodyinterface{}interface{}

All responses

CodeStatusDescriptionHas headersSchema
200OKGlobalSettingsschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - GlobalSettings

Status: OK

Schema

GlobalSettings

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

patch machine deployment (patchMachineDeployment)

PATCH /api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments/{machinedeployment_id}

Patches a machine deployment that is assigned to the given cluster. Please note that at the moment only node deployment's spec can be updated by a patch, no other fields can be changed using this endpoint.

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
machinedeployment_idpathstringstring
project_idpathstringstring
Patchbodyinterface{}interface{}

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeDeploymentschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - NodeDeployment

Status: OK

Schema

NodeDeployment

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

patch node deployment (patchNodeDeployment)

PATCH /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodedeployments/{nodedeployment_id}

Patches a node deployment that is assigned to the given cluster. Please note that at the moment only node deployment's spec can be updated by a patch, no other fields can be changed using this endpoint.

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
nodedeployment_idpathstringstring
project_idpathstringstring
Patchbodyinterface{}interface{}

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeDeploymentschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - NodeDeployment

Status: OK

Schema

NodeDeployment

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Patches a NodeDeploymentRequest that is assigned to the given cluster. (patchNodeDeploymentRequest)

PATCH /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/ndrequests/{ndrequest_id}

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
ndrequest_idpathstringstring
project_idpathstringstring
Patchbody[]uint8 (formatted integer)[]uint8

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeDeploymentRequestschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - NodeDeploymentRequest

Status: OK

Schema

NodeDeploymentRequest

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

patch role (patchRole)

PATCH /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/roles/{namespace}/{role_id}

Patch the role with the given name

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
namespacepathstringstring
project_idpathstringstring
role_idpathstringstring
Patchbodyinterface{}interface{}

All responses

CodeStatusDescriptionHas headersSchema
200OKRoleschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Role

Status: OK

Schema

Role

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

patch service account token (patchServiceAccountToken)

PATCH /api/v1/projects/{project_id}/serviceaccounts/{serviceaccount_id}/tokens/{token_id}

Patches the token name

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
serviceaccount_idpathstringstring
token_idpathstringstring
Bodybody[]uint8 (formatted integer)[]uint8

All responses

CodeStatusDescriptionHas headersSchema
200OKPublicServiceAccountTokenschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - PublicServiceAccountToken

Status: OK

Schema

PublicServiceAccountToken

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Resets the alertmanager configuration to default for the specified cluster. (resetAlertmanager)

DELETE /api/v2/projects/{project_id}/clusters/{cluster_id}/alertmanager/config

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Schedules rolling restart of a machine deployment that is assigned to the given cluster. (restartMachineDeployment)

POST /api/v2/projects/{project_id}/clusters/{cluster_id}/machinedeployments/{machinedeployment_id}

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
machinedeployment_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKNodeDeploymentschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - NodeDeployment

Status: OK

Schema

NodeDeployment

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

revoke cluster admin token (revokeClusterAdminToken)

PUT /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/token

Revokes the current admin token

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

revoke cluster admin token v2 (revokeClusterAdminTokenV2)

PUT /api/v2/projects/{project_id}/clusters/{cluster_id}/token

Revokes the current admin token

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

revoke cluster viewer token (revokeClusterViewerToken)

PUT /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/viewertoken

Revokes the current viewer token

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

revoke cluster viewer token v2 (revokeClusterViewerTokenV2)

PUT /api/v2/projects/{project_id}/clusters/{cluster_id}/viewertoken

Revokes the current viewer token

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Allows setting and clearing admin role for users. (setAdmin)

PUT /api/v1/admin

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
BodybodyAdminmodels.Admin

All responses

CodeStatusDescriptionHas headersSchema
200OKAdminschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Admin

Status: OK

Schema

Admin

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

unbind user from cluster role binding (unbindUserFromClusterRoleBinding)

DELETE /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/clusterroles/{role_id}/clusterbindings

Unbinds user from cluster role binding

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
role_idpathstringstring
BodybodyClusterRoleUsermodels.ClusterRoleUser

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterRoleBindingschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterRoleBinding

Status: OK

Schema

ClusterRoleBinding

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

unbind user from cluster role binding v2 (unbindUserFromClusterRoleBindingV2)

DELETE /api/v2/projects/{project_id}/clusters/{cluster_id}/clusterroles/{role_id}/clusterbindings

Unbinds user from cluster role binding

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
role_idpathstringstring
BodybodyClusterRoleUsermodels.ClusterRoleUser

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterRoleBindingschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ClusterRoleBinding

Status: OK

Schema

ClusterRoleBinding

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

unbind user from role binding (unbindUserFromRoleBinding)

DELETE /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/roles/{namespace}/{role_id}/bindings

Unbinds user from the role binding

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
namespacepathstringstring
project_idpathstringstring
role_idpathstringstring
BodybodyRoleUsermodels.RoleUser

All responses

CodeStatusDescriptionHas headersSchema
200OKRoleBindingschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - RoleBinding

Status: OK

Schema

RoleBinding

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

unbind user from role binding v2 (unbindUserFromRoleBindingV2)

DELETE /api/v2/projects/{project_id}/clusters/{cluster_id}/roles/{namespace}/{role_id}/bindings

Unbinds user from the role binding

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
namespacepathstringstring
project_idpathstringstring
role_idpathstringstring
BodybodyRoleUsermodels.RoleUser

All responses

CodeStatusDescriptionHas headersSchema
200OKRoleBindingschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - RoleBinding

Status: OK

Schema

RoleBinding

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Updates the admission plugin. (updateAdmissionPlugin)

PATCH /api/v1/admin/admission/plugins/{name}

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
namepathstringstring
BodybodyAdmissionPluginmodels.AdmissionPlugin

All responses

CodeStatusDescriptionHas headersSchema
200OKAdmissionPluginschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - AdmissionPlugin

Status: OK

Schema

AdmissionPlugin

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

update alertmanager (updateAlertmanager)

PUT /api/v2/projects/{project_id}/clusters/{cluster_id}/alertmanager/config

Updates an alertmanager configuration for the given cluster

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
BodybodyAlertmanagermodels.Alertmanager

All responses

CodeStatusDescriptionHas headersSchema
200OKAlertmanagerschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Alertmanager

Status: OK

Schema

Alertmanager

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Update the datacenter. The datacenter spec will be overwritten with the one provided in the request. (updateDC)

PUT /api/v1/seed/{seed_name}/dc/{dc}

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
dcpathstringstring
seed_namepathstringstring
BodybodyUpdateDCBodyUpdateDCBody

All responses

CodeStatusDescriptionHas headersSchema
200OKDatacenterschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Datacenter

Status: OK

Schema

Datacenter

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Inlined models

UpdateDCBody

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Namestringstring
specDatacenterSpecmodels.DatacenterSpec

Updates an external cluster for the given project. (updateExternalCluster)

PUT /api/v2/projects/{project_id}/kubernetes/clusters/{cluster_id}

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
BodybodyBodymodels.Body

All responses

CodeStatusDescriptionHas headersSchema
200OKClusterschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Cluster

Status: OK

Schema

Cluster

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Updates the MLA admin setting for the given cluster. (updateMLAAdminSetting)

PUT /api/v2/projects/{project_id}/clusters/{cluster_id}/mlaadminsetting

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
BodybodyMLAAdminSettingmodels.MLAAdminSetting

All responses

CodeStatusDescriptionHas headersSchema
200OKMLAAdminSettingschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - MLAAdminSetting

Status: OK

Schema

MLAAdminSetting

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

update preset (updatePreset)

PUT /api/v2/providers/{provider_name}/presets

Updates provider preset

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
provider_namepathstringstring
BodybodyPresetmodels.Preset

All responses

CodeStatusDescriptionHas headersSchema
200OKPresetschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Preset

Status: OK

Schema

Preset

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Updates the status of a preset. It can enable or disable it, so that it won't be listed by the list endpoints. (updatePresetStatus)

PUT /api/v2/presets/{preset_name}/status

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
preset_namepathstringstring
providerquerystringstring
BodybodyUpdatePresetStatusBodyUpdatePresetStatusBody

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Inlined models

UpdatePresetStatusBody

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Enabledbooleanbool

update project (updateProject)

PUT /api/v1/projects/{project_id}

Updates the given project

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
BodybodyProjectmodels.Project

All responses

CodeStatusDescriptionHas headersSchema
200OKProjectschema
400Bad RequestEmptyResponse is a empty responseschema
404Not FoundEmptyResponse is a empty responseschema
500Internal Server ErrorEmptyResponse is a empty responseschema
501Not ImplementedEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Project

Status: OK

Schema

Project

400 - EmptyResponse is a empty response

Status: Bad Request

Schema
404 - EmptyResponse is a empty response

Status: Not Found

Schema
500 - EmptyResponse is a empty response

Status: Internal Server Error

Schema
501 - EmptyResponse is a empty response

Status: Not Implemented

Schema
Default Response

errorResponse

Schema

ErrorResponse

Updates the specified rule group for the given cluster. (updateRuleGroup)

PUT /api/v2/projects/{project_id}/clusters/{cluster_id}/rulegroups/{rulegroup_id}

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
rulegroup_idpathstringstring
BodybodyRuleGroupmodels.RuleGroup

All responses

CodeStatusDescriptionHas headersSchema
200OKRuleGroupschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - RuleGroup

Status: OK

Schema

RuleGroup

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Updates the seed. (updateSeed)

PATCH /api/v1/admin/seeds/{seed_name}

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
seed_namepathstringstring
BodybodyUpdateSeedBodyUpdateSeedBody

All responses

CodeStatusDescriptionHas headersSchema
200OKSeedschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - Seed

Status: OK

Schema

Seed

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Inlined models

UpdateSeedBody

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Namestringstring
specSeedSpecmodels.SeedSpec

update service account (updateServiceAccount)

PUT /api/v1/projects/{project_id}/serviceaccounts/{serviceaccount_id}

Updates service account for the given project

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
serviceaccount_idpathstringstring
BodybodyServiceAccountmodels.ServiceAccount

All responses

CodeStatusDescriptionHas headersSchema
200OKServiceAccountschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ServiceAccount

Status: OK

Schema

ServiceAccount

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

update service account token (updateServiceAccountToken)

PUT /api/v1/projects/{project_id}/serviceaccounts/{serviceaccount_id}/tokens/{token_id}

Updates and regenerates the token

Consumes

  • application/json

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
project_idpathstringstring
serviceaccount_idpathstringstring
token_idpathstringstring
BodybodyPublicServiceAccountTokenmodels.PublicServiceAccountToken

All responses

CodeStatusDescriptionHas headersSchema
200OKServiceAccountTokenschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - ServiceAccountToken

Status: OK

Schema

ServiceAccountToken

401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

upgrade cluster node deployments (upgradeClusterNodeDeployments)

PUT /api/v1/projects/{project_id}/dc/{dc}/clusters/{cluster_id}/nodes/upgrades

Upgrades node deployments in a cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
dcpathstringstring
project_idpathstringstring
BodybodyMasterVersionmodels.MasterVersion

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

upgrade cluster node deployments v2 (upgradeClusterNodeDeploymentsV2)

PUT /api/v2/projects/{project_id}/clusters/{cluster_id}/nodes/upgrades

Upgrades node deployments in a cluster

Produces

  • application/json

Parameters

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
cluster_idpathstringstring
project_idpathstringstring
BodybodyMasterVersionmodels.MasterVersion

All responses

CodeStatusDescriptionHas headersSchema
200OKEmptyResponse is a empty responseschema
401UnauthorizedEmptyResponse is a empty responseschema
403ForbiddenEmptyResponse is a empty responseschema
defaulterrorResponseschema

Responses

200 - EmptyResponse is a empty response

Status: OK

Schema
401 - EmptyResponse is a empty response

Status: Unauthorized

Schema
403 - EmptyResponse is a empty response

Status: Forbidden

Schema
Default Response

errorResponse

Schema

ErrorResponse

Models

AWSCloudSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AccessKeyIDstringstring
ControlPlaneRoleARNstringstringThe IAM role, the control plane will use. The control plane will perform an assume-role
InstanceProfileNamestringstring
OpenstackBillingTenantstringstring
RoleNamestringstringDEPRECATED. Don't care for the role name. We only require the ControlPlaneRoleARN to be set so the control plane
can perform the assume-role.
We keep it for backwards compatibility (We use this name for cleanup purpose).
RouteTableIDstringstring
SecretAccessKeystringstring
SecurityGroupIDstringstring
VPCIDstringstring
credentialsReferenceGlobalSecretKeySelectorGlobalSecretKeySelector

AWSNodeSpec

AWSNodeSpec aws specific node settings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AMIstringstringami to use. Will be defaulted to a ami for your selected operating system and region. Only set this when you know what you do.
AssignPublicIPbooleanboolThis flag controls a property of the AWS instance. When set the AWS instance will get a public IP address
assigned during launch overriding a possible setting in the used AWS subnet.
AvailabilityZonestringstringAvailability zone in which to place the node. It is coupled with the subnet to which the node will belong.
InstanceTypestringstringt2.micro
IsSpotInstancebooleanboolIsSpotInstance indicates whether the created machine is an aws ec2 spot instance or on-demand ec2 instance.
SpotInstanceInterruptionBehaviorstringstringSpotInstanceInterruptionBehavior sets the interruption behavior for the spot instance when capacity is no longer
available at the price you specified, if there is no capacity, or if a constraint cannot be met. Charges for EBS
volume storage apply when an instance is stopped.
SpotInstanceMaxPricestringstringSpotInstanceMaxPrice is the maximum price you are willing to pay per instance hour. Your instance runs when
your maximum price is greater than the Spot Price.
SpotInstancePersistentRequestbooleanboolSpotInstancePersistentRequest ensures that your request will be submitted every time your Spot Instance is terminated.
SubnetIDstringstringThe VPC subnet to which the node shall be connected.
Tagsmap of stringmap[string]stringadditional instance tags
VolumeSizeint64 (formatted integer)int64size of the volume in gb. Only one volume will be created
VolumeTypestringstringgp2, io1, st1, sc1, standard

AWSSecurityGroupList

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
IDs[]string[]string

AWSSize

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Architecturestringstring
GPUsint64 (formatted integer)int64
Memoryfloat (formatted number)float32
Namestringstring
PrettyNamestringstring
Pricedouble (formatted number)float64
VCPUsint64 (formatted integer)int64

AWSSizeList

[]AWSSize

AWSSubnet

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AvailabilityZonestringstring
AvailabilityZoneIDstringstring
AvailableIPAddressCountint64 (formatted integer)int64
DefaultForAzbooleanbool
IDstringstring
IPv4CIDRstringstring
IPv6CIDRstringstring
IsDefaultSubnetbooleanbool
Namestringstring
Statestringstring
Tags[]AWSTag[]*AWSTag

AWSSubnetList

[]AWSSubnet

AWSTag

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Keystringstring
Valuestringstring

AWSVPC

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CidrBlockstringstringThe primary IPv4 CIDR block for the VPC.
CidrBlockAssociationSet[]AWSVpcCidrBlockAssociation[]*AWSVpcCidrBlockAssociationInformation about the IPv4 CIDR blocks associated with the VPC.
DhcpOptionsIDstringstringThe ID of the set of DHCP options you've associated with the VPC (or default
if the default options are associated with the VPC).
InstanceTenancystringstringThe allowed tenancy of instances launched into the VPC.
Ipv6CidrBlockAssociationSet[]AWSVpcIPV6CidrBlockAssociation[]*AWSVpcIPV6CidrBlockAssociationInformation about the IPv6 CIDR blocks associated with the VPC.
IsDefaultbooleanboolIndicates whether the VPC is the default VPC.
Namestringstring
OwnerIDstringstringThe ID of the AWS account that owns the VPC.
StatestringstringThe current state of the VPC.
Tags[]AWSTag[]*AWSTagAny tags assigned to the VPC.
VpcIDstringstringThe ID of the VPC.

AWSVPCList

[]AWSVPC

AWSVpcCidrBlockAssociation

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AssociationIDstringstringThe association ID for the IPv4 CIDR block.
CidrBlockstringstringThe IPv4 CIDR block.
StatestringstringThe state of the CIDR block.
StatusMessagestringstringA message about the status of the CIDR block, if applicable.

AWSVpcIpv6CidrBlockAssociation

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AssociationIDstringstringThe association ID for the IPv4 CIDR block.
CidrBlockstringstringThe IPv4 CIDR block.
StatestringstringThe state of the CIDR block.
StatusMessagestringstringA message about the status of the CIDR block, if applicable.

Absolute

Usage is a struct that contains the current resource usage and limits of a tenant.

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
MaxImageMetaint64 (formatted integer)int64MaxImageMeta is the amount of image metadata available to a tenant.
MaxPersonalityint64 (formatted integer)int64MaxPersonality is the amount of personality/files available to a tenant.
MaxPersonalitySizeint64 (formatted integer)int64MaxPersonalitySize is the personality file size available to a tenant.
MaxSecurityGroupRulesint64 (formatted integer)int64MaxSecurityGroupRules is the number of security group rules available to
a tenant.
MaxSecurityGroupsint64 (formatted integer)int64MaxSecurityGroups is the number of security groups available to a tenant.
MaxServerGroupMembersint64 (formatted integer)int64MaxServerGroupMembers is the number of server group members available
to a tenant.
MaxServerGroupsint64 (formatted integer)int64MaxServerGroups is the number of server groups available to a tenant.
MaxServerMetaint64 (formatted integer)int64MaxServerMeta is the amount of server metadata available to a tenant.
MaxTotalCoresint64 (formatted integer)int64MaxTotalCores is the number of cores available to a tenant.
MaxTotalFloatingIpsint64 (formatted integer)int64MaxTotalFloatingIps is the number of floating IPs available to a tenant.
MaxTotalInstancesint64 (formatted integer)int64MaxTotalInstances is the number of instances/servers available to a tenant.
MaxTotalKeypairsint64 (formatted integer)int64MaxTotalKeypairs is the total keypairs available to a tenant.
MaxTotalRAMSizeint64 (formatted integer)int64MaxTotalRAMSize is the total amount of RAM available to a tenant measured
in megabytes (MB).
TotalCoresUsedint64 (formatted integer)int64TotalCoresUsed is the number of cores currently in use.
TotalFloatingIpsUsedint64 (formatted integer)int64TotalFloatingIpsUsed is the number of floating IPs in use.
TotalInstancesUsedint64 (formatted integer)int64TotalInstancesUsed is the number of instances/servers in use.
TotalRAMUsedint64 (formatted integer)int64TotalRAMUsed is the total RAM/memory in use measured in megabytes (MB).
TotalSecurityGroupsUsedint64 (formatted integer)int64TotalSecurityGroupsUsed is the total number of security groups in use.
TotalServerGroupsUsedint64 (formatted integer)int64TotalServerGroupsUsed is the total number of server groups in use.

AccessibleAddons

[]string

Addon

Addon represents a predefined addon that users may install into their cluster

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Annotationsmap of stringmap[string]stringAnnotations that can be added to the resource
CreationTimestampdate-time (formatted string)strfmt.DateTimeCreationTimestamp is a timestamp representing the server time when this object was created.
DeletionTimestampdate-time (formatted string)strfmt.DateTimeDeletionTimestamp is a timestamp representing the server time when this object was deleted.
IDstringstringID unique value that identifies the resource generated by the server. Read-Only.
NamestringstringName represents human readable name for the resource
specAddonSpecAddonSpec

AddonConfig

AddonConfig represents a addon configuration

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Annotationsmap of stringmap[string]stringAnnotations that can be added to the resource
CreationTimestampdate-time (formatted string)strfmt.DateTimeCreationTimestamp is a timestamp representing the server time when this object was created.
DeletionTimestampdate-time (formatted string)strfmt.DateTimeDeletionTimestamp is a timestamp representing the server time when this object was deleted.
IDstringstringID unique value that identifies the resource generated by the server. Read-Only.
NamestringstringName represents human readable name for the resource
specAddonConfigSpecAddonConfigSpec

AddonConfigSpec

AddonConfigSpec specifies configuration of addon

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Controls[]AddonFormControl[]*AddonFormControlControls that can be set for configured addon
DescriptionstringstringDescription of the configured addon, it will be displayed in the addon overview in the UI
LogostringstringLogo of the configured addon, encoded in base64
LogoFormatstringstringLogoFormat contains logo format of the configured addon, i.e. svg+xml
ShortDescriptionstringstringShortDescription of the configured addon that contains more detailed information about the addon,
it will be displayed in the addon details view in the UI

AddonFormControl

AddonFormControl specifies addon form control

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DisplayNamestringstringDisplayName is visible in the UI
HelpTextstringstringHelpText is visible in the UI next to the control
InternalNamestringstringInternalName is used internally to save in the addon object
RequiredbooleanboolRequired indicates if the control has to be set
TypestringstringType of displayed control

AddonSpec

AddonSpec addon specification

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
ContinuouslyReconcilebooleanboolContinuouslyReconcile indicates that the addon cannot be deleted or modified outside of the UI after installation
IsDefaultbooleanboolIsDefault indicates whether the addon is default
Variablesmap of anymap[string]interface{}Variables is free form data to use for parsing the manifest templates

Admin

Admin represents admin user

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
EmailstringstringEmail address of the admin user
IsAdminbooleanboolIsAdmin indicates admin role
NamestringstringName of the admin user

AdmissionPlugin

AdmissionPlugin represents an admission plugin

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Namestringstring
Pluginstringstring
fromVersionSemverSemver

AdmissionPluginList

AdmissionPluginList represents a list of admission plugins

[]string

Alertmanager

Alertmanager represents an Alertmanager Configuration

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
specAlertmanagerSpecAlertmanagerSpec

AlertmanagerSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Config[]uint8 (formatted integer)[]uint8Config contains the alertmanager configuration in YAML

AlibabaCloudSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AccessKeyIDstringstring
AccessKeySecretstringstring
credentialsReferenceGlobalSecretKeySelectorGlobalSecretKeySelector

AlibabaInstanceType

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CPUCoreCountint64 (formatted integer)int64
GPUCoreCountint64 (formatted integer)int64
IDstringstring
MemorySizedouble (formatted number)float64

AlibabaInstanceTypeList

[]AlibabaInstanceType

AlibabaNodeSpec

AlibabaNodeSpec alibaba specific node settings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DiskSizestringstring
DiskTypestringstring
InstanceTypestringstring
InternetMaxBandwidthOutstringstring
Labelsmap of stringmap[string]string
VSwitchIDstringstring
ZoneIDstringstring

AlibabaVSwitch

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
IDstringstring

AlibabaVSwitchList

[]AlibabaVSwitch

AlibabaZone

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
IDstringstring

AlibabaZoneList

[]AlibabaZone

AllowedRegistry

AllowedRegistry represents a object containing a allowed image registry prefix

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Namestringstring
specAllowedRegistrySpecAllowedRegistrySpec

AllowedRegistrySpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
RegistryPrefixstringstringRegistryPrefix contains the prefix of the registry which will be allowed. User clusters will be able to deploy
only images which are prefixed with one of the allowed image registry prefixes.

AnexiaCloudSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Tokenstringstring
credentialsReferenceGlobalSecretKeySelectorGlobalSecretKeySelector

AnexiaNodeSpec

AnexiaNodeSpec anexia specific node settings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CPUsint64 (formatted integer)int64CPUs states how many cpus the node will have.
DiskSizeint64 (formatted integer)int64DiskSize states the disk size that node will have.
Memoryint64 (formatted integer)int64Memory states the memory that node will have.
TemplateIDstringstringTemplateID instance template
VlanIDstringstringVlanID Instance vlanID

AnexiaTemplate

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
IDstringstring

AnexiaTemplateList

[]AnexiaTemplate

AnexiaVlan

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
IDstringstring

AnexiaVlanList

[]AnexiaVlan

AuditLoggingSettings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Enabledbooleanbool

AzureAvailabilityZonesList

AzureAvailabilityZonesList is the object representing the availability zones for vms in azure cloud provider

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Zones[]string[]string

AzureCloudSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AssignAvailabilitySetbooleanbool
AvailabilitySetstringstring
ClientIDstringstring
ClientSecretstringstring
OpenstackBillingTenantstringstring
ResourceGroupstringstring
RouteTableNamestringstring
SecurityGroupstringstring
SubnetNamestringstring
SubscriptionIDstringstring
TenantIDstringstring
VNetNamestringstring
VNetResourceGroupstringstring
credentialsReferenceGlobalSecretKeySelectorGlobalSecretKeySelector
loadBalancerSKULBSKULBSKU

AzureNodeSpec

AzureNodeSpec describes settings for an Azure node

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AssignAvailabilitySetbooleanboolAssignAvailabilitySet is used to check if an availability set should be created and assigned to the cluster.
AssignPublicIPbooleanboolshould the machine have a publicly accessible IP address
DataDiskSizeint32 (formatted integer)int32Data disk size in GB
ImageIDstringstringImageID represents the ID of the image that should be used to run the node
OSDiskSizeint32 (formatted integer)int32OS disk size in GB
SizestringstringVM size
Tagsmap of stringmap[string]stringAdditional metadata to set
Zones[]string[]stringZones represents the availability zones for azure vms

AzureResourceGroupsList

AzureResourceGroupsList is the object representing the resource groups for vms in azure cloud provider

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
ResourceGroups[]string[]string

AzureRouteTablesList

AzureRouteTablesList is the object representing the route tables for vms in azure cloud provider

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
RouteTables[]string[]string

AzureSecurityGroupsList

AzureSecurityGroupsList is the object representing the security groups for vms in azure cloud provider

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
SecurityGroups[]string[]string

AzureSize

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
MaxDataDiskCountint32 (formatted integer)int32
MemoryInMBint32 (formatted integer)int32
Namestringstring
NumberOfCoresint32 (formatted integer)int32
NumberOfGPUsint32 (formatted integer)int32
OsDiskSizeInMBint32 (formatted integer)int32
ResourceDiskSizeInMBint32 (formatted integer)int32

AzureSizeList

[]AzureSize

AzureSubnetsList

AzureSubnetsList is the object representing the subnets for vms in azure cloud provider

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Subnets[]string[]string

AzureVirtualNetworksList

AzureVirtualNetworksList is the object representing the virtual network for vms in azure cloud provider

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
VirtualNetworks[]string[]string

BackupCredentials

BackupCredentials contains credentials for etcd backups

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
s3S3BackupCredentialsS3BackupCredentials

BackupStatus

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
BackupMessagestringstring
BackupNamestringstring
DeleteJobNamestringstring
DeleteMessagestringstring
JobNamestringstring
backupFinishedTimeTimeTime
backupPhaseBackupStatusPhaseBackupStatusPhase
backupStartTimeTimeTime
deleteFinishedTimeTimeTime
deletePhaseBackupStatusPhaseBackupStatusPhase
deleteStartTimeTimeTime
scheduledTimeTimeTime

BackupStatusPhase

NameTypeGo typeDefaultDescriptionExample
BackupStatusPhasestringstring

BringYourOwnCloudSpec

interface{}

ByPodStatus

ByPodStatus defines the observed state of ConstraintTemplate as seen by an individual controller +kubebuilder:pruning:PreserveUnknownFields

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Errors[]CreateCRDError[]*CreateCRDError
IDstringstringa unique identifier for the pod that wrote the status
ObservedGenerationint64 (formatted integer)int64

CRD

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
specCRDSpecCRDSpec

CRDSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
namesNamesNames
validationValidationValidation

CentOSSpec

CentOSSpec contains CentOS specific settings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DistUpgradeOnBootbooleanbooldo a dist-upgrade on boot and reboot it required afterwards

CleanupOptions

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Enabledbooleanbool
Enforcedbooleanbool

CloudSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DatacenterNamestringstringDatacenterName where the users 'cloud' lives in.
alibabaAlibabaCloudSpecAlibabaCloudSpec
anexiaAnexiaCloudSpecAnexiaCloudSpec
awsAWSCloudSpecAWSCloudSpec
azureAzureCloudSpecAzureCloudSpec
bringyourownBringYourOwnCloudSpecBringYourOwnCloudSpec
digitaloceanDigitaloceanCloudSpecDigitaloceanCloudSpec
fakeFakeCloudSpecFakeCloudSpec
gcpGCPCloudSpecGCPCloudSpec
hetznerHetznerCloudSpecHetznerCloudSpec
kubevirtKubevirtCloudSpecKubevirtCloudSpec
openstackOpenstackCloudSpecOpenstackCloudSpec
packetPacketCloudSpecPacketCloudSpec
vsphereVSphereCloudSpecVSphereCloudSpec

Cluster

Note: Cluster has a custom MarshalJSON method defined and thus the output may vary

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Annotationsmap of stringmap[string]stringAnnotations that can be added to the resource
CreationTimestampdate-time (formatted string)strfmt.DateTimeCreationTimestamp is a timestamp representing the server time when this object was created.
Credentialstringstring
DeletionTimestampdate-time (formatted string)strfmt.DateTimeDeletionTimestamp is a timestamp representing the server time when this object was deleted.
IDstringstringID unique value that identifies the resource generated by the server. Read-Only.
InheritedLabelsmap of stringmap[string]string
Labelsmap of stringmap[string]string
NamestringstringName represents human readable name for the resource
Typestringstring
specClusterSpecClusterSpec
statusClusterStatusClusterStatus

ClusterHealth

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
apiserverHealthStatusHealthStatus
cloudProviderInfrastructureHealthStatusHealthStatus
controllerHealthStatusHealthStatus
etcdHealthStatusHealthStatus
gatekeeperAuditHealthStatusHealthStatus
gatekeeperControllerHealthStatusHealthStatus
machineControllerHealthStatusHealthStatus
schedulerHealthStatusHealthStatus
userClusterControllerManagerHealthStatusHealthStatus

ClusterList

ClusterList represents a list of clusters

[]Cluster

ClusterMetrics

ClusterMetrics defines a metric for the given cluster

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Namestringstring
controlPlaneControlPlaneMetricsControlPlaneMetrics
nodesNodesMetricNodesMetric

ClusterNetworkingConfig

ClusterNetworkingConfig specifies the different networking parameters for a cluster.

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DNSDomainstringstringDomain name for services.
KonnectivityEnabledbooleanboolKonnectivityEnabled enables konnectivity for controlplane to node network communication.
NodeLocalDNSCacheEnabledbooleanboolNodeLocalDNSCacheEnabled controls whether the NodeLocal DNS Cache feature is enabled.
Defaults to true.
ProxyModestringstringProxyMode defines the kube-proxy mode (ipvs/iptables).
Defaults to ipvs.
ipvsIPVSConfigurationIPVSConfiguration
podsNetworkRangesNetworkRanges
servicesNetworkRangesNetworkRanges

ClusterRole

ClusterRole defines cluster RBAC role for the user cluster

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Annotationsmap of stringmap[string]stringAnnotations that can be added to the resource
CreationTimestampdate-time (formatted string)strfmt.DateTimeCreationTimestamp is a timestamp representing the server time when this object was created.
DeletionTimestampdate-time (formatted string)strfmt.DateTimeDeletionTimestamp is a timestamp representing the server time when this object was deleted.
IDstringstringID unique value that identifies the resource generated by the server. Read-Only.
NamestringstringName represents human readable name for the resource
Rules[]PolicyRule[]*PolicyRuleRules holds all the PolicyRules for this ClusterRole

ClusterRoleBinding

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
RoleRefNamestringstring
Subjects[]Subject[]*SubjectSubjects holds references to the objects the role applies to.

ClusterRoleName

ClusterRoleName defines RBAC cluster role name object for the user cluster

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
NamestringstringName of the cluster role.

ClusterRoleUser

ClusterRoleUser defines associated user with cluster role

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Groupstringstring
UserEmailstringstring

ClusterSpec

ClusterSpec defines the cluster specification

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AdmissionPlugins[]string[]stringAdditional Admission Controller plugins
ContainerRuntimestringstringContainerRuntime to use, i.e. Docker or containerd. By default containerd will be used.
EnableUserSSHKeyAgentbooleanboolEnableUserSSHKeyAgent control whether the UserSSHKeyAgent will be deployed in the user cluster or not.
If it was enabled, the agent will be deployed and used to sync the user ssh keys, that the user attach
to the created cluster. If the agent was disabled, it won't be deployed in the user cluster, thus after
the cluster creation any attached ssh keys won't be synced to the worker nodes. Once the agent is enabled/disabled
it cannot be changed after the cluster is being created.
MachineNetworks[]MachineNetworkingConfig[]*MachineNetworkingConfigMachineNetworks optionally specifies the parameters for IPAM.
PodNodeSelectorAdmissionPluginConfigmap of stringmap[string]stringPodNodeSelectorAdmissionPluginConfig provides the configuration for the PodNodeSelector.
It's used by the backend to create a configuration file for this plugin.
The key:value from the map is converted to the namespace: in the file.
The format in a file:
podNodeSelectorPluginConfig:
clusterDefaultNodeSelector:
namespace1:
namespace2:
UsePodNodeSelectorAdmissionPluginbooleanboolIf active the PodNodeSelector admission plugin is configured at the apiserver
UsePodSecurityPolicyAdmissionPluginbooleanboolIf active the PodSecurityPolicy admission plugin is configured at the apiserver
auditLoggingAuditLoggingSettingsAuditLoggingSettings
cloudCloudSpecCloudSpec
clusterNetworkClusterNetworkingConfigClusterNetworkingConfig
mlaMLASettingsMLASettings
oidcOIDCSettingsOIDCSettings
opaIntegrationOPAIntegrationSettingsOPAIntegrationSettings
serviceAccountServiceAccountSettingsServiceAccountSettings
sys11authSys11AuthSettingsSys11AuthSettings
updateWindowUpdateWindowUpdateWindow
versionSemverSemver

ClusterStatus

ClusterStatus defines the cluster status

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
URLstringstringURL specifies the address at which the cluster is available
externalCCMMigrationExternalCCMMigrationStatusExternalCCMMigrationStatus
versionSemverSemver

ClusterTemplate

ClusterTemplate represents a ClusterTemplate object

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
IDstringstring
Namestringstring
ProjectIDstringstring
Scopestringstring
Userstringstring
UserSSHKeys[]ClusterTemplateSSHKey[]*ClusterTemplateSSHKey
clusterClusterCluster
nodeDeploymentNodeDeploymentNodeDeployment

ClusterTemplateInstance

ClusterTemplateInstance represents a ClusterTemplateInstance object

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Namestringstring
specClusterTemplateInstanceSpecClusterTemplateInstanceSpec

ClusterTemplateInstanceSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
ClusterTemplateIDstringstring
ClusterTemplateNamestringstring
ProjectIDstringstring
Replicasint64 (formatted integer)int64

ClusterTemplateList

ClusterTemplateList represents a ClusterTemplate list

[]ClusterTemplate

ClusterTemplateSSHKey

ClusterTemplateSSHKey represents SSH Key object for Cluster Template

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
IDstringstring
Namestringstring

ClusterType

NameTypeGo typeDefaultDescriptionExample
ClusterTypeint8 (formatted integer)int8

ConditionStatus

NameTypeGo typeDefaultDescriptionExample
ConditionStatusstringstring

Constraint

Constraint represents a gatekeeper Constraint

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Labelsmap of stringmap[string]string
Namestringstring
specConstraintSpecConstraintSpec
statusConstraintStatusConstraintStatus

ConstraintSelector

ConstraintSelector is the object holding the cluster selection filters

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Providers[]string[]stringProviders is a list of cloud providers to which the Constraint applies to. Empty means all providers are selected.
labelSelectorLabelSelectorLabelSelector

ConstraintSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
ConstraintTypestringstringConstraintType specifies the type of gatekeeper constraint that the constraint applies to
DisabledbooleanboolDisabled is the flag for disabling OPA constraints
matchMatchMatch
parametersParametersParameters
selectorConstraintSelectorConstraintSelector

ConstraintStatus

ConstraintStatus represents a constraint status which holds audit info

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AuditTimestampstringstring
Enforcementstringstring
Syncedbooleanbool
Violations[]Violation[]*Violation

ConstraintTemplate

ConstraintTemplate represents a gatekeeper ConstraintTemplate

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Namestringstring
specConstraintTemplateSpecConstraintTemplateSpec
statusConstraintTemplateStatusConstraintTemplateStatus

ConstraintTemplateSelector

ConstraintTemplateSelector is the object holding the cluster selection filters

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Providers[]string[]stringProviders is a list of cloud providers to which the Constraint Template applies to. Empty means all providers are selected.
labelSelectorLabelSelectorLabelSelector

ConstraintTemplateSpec

ConstraintTemplateSpec is the object representing the gatekeeper constraint template spec and kubermatic related spec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Targets[]Target[]*Target
crdCRDCRD
selectorConstraintTemplateSelectorConstraintTemplateSelector

ConstraintTemplateStatus

ConstraintTemplateStatus defines the observed state of ConstraintTemplate

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
ByPod[]ByPodStatus[]*ByPodStatus
Createdbooleanbool

ControlPlaneMetrics

ControlPlaneMetrics defines a metric for the user cluster control plane resources

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CPUTotalMillicoresint64 (formatted integer)int64CPUTotalMillicores in m cores
MemoryTotalBytesint64 (formatted integer)int64MemoryTotalBytes in bytes

CreateCRDError

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Codestringstring
Locationstringstring
Messagestringstring

CreateClusterSpec

CreateClusterSpec is the structure that is used to create cluster with its initial node deployment

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DNSDomainstringstring
PodsCIDRstringstring
ServicesCIDRstringstring
clusterClusterCluster
nodeDeploymentNodeDeploymentNodeDeployment

CredentialList

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Names[]string[]string

CustomLink

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Iconstringstring
Labelstringstring
Locationstringstring
URLstringstring

CustomLinks

[]CustomLink

Datacenter

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
metadataDatacenterMetaDatacenterMeta
specDatacenterSpecDatacenterSpec

DatacenterList

DatacenterList represents a list of datacenters

[]Datacenter

DatacenterMeta

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Namestringstring

DatacenterSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CountrystringstringOptional: Country of the seed as ISO-3166 two-letter code, e.g. DE or UK.
It is used for informational purposes.
EnforceAuditLoggingbooleanboolEnforceAuditLogging enforces audit logging on every cluster within the DC,
ignoring cluster-specific settings.
EnforcePodSecurityPolicybooleanboolEnforcePodSecurityPolicy enforces pod security policy plugin on every clusters within the DC,
ignoring cluster-specific settings
LocationstringstringOptional: Detailed location of the cluster, like "Hamburg" or "Datacenter 7".
It is used for informational purposes.
ProviderstringstringName of the datacenter provider. Extracted based on which provider is defined in the spec.
It is used for informational purposes.
RequiredEmailDomainstringstringDeprecated. Automatically migrated to the RequiredEmailDomains field.
RequiredEmailDomains[]string[]string
SeedstringstringName of the seed this datacenter belongs to.
alibabaDatacenterSpecAlibabaDatacenterSpecAlibaba
anexiaDatacenterSpecAnexiaDatacenterSpecAnexia
awsDatacenterSpecAWSDatacenterSpecAWS
azureDatacenterSpecAzureDatacenterSpecAzure
bringyourownDatacenterSpecBringYourOwnDatacenterSpecBringYourOwn
digitaloceanDatacenterSpecDigitaloceanDatacenterSpecDigitalocean
fakeDatacenterSpecFakeDatacenterSpecFake
gcpDatacenterSpecGCPDatacenterSpecGCP
hetznerDatacenterSpecHetznerDatacenterSpecHetzner
kubevirtDatacenterSpecKubevirtDatacenterSpecKubevirt
nodeNodeSettingsNodeSettings
openstackDatacenterSpecOpenstackDatacenterSpecOpenstack
packetDatacenterSpecPacketDatacenterSpecPacket
vsphereDatacenterSpecVSphereDatacenterSpecVSphere

DatacenterSpecAWS

DatacenterSpecAWS describes an AWS datacenter

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
RegionstringstringThe AWS region to use, e.g. "us-east-1". For a list of available regions, see
https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html
imagesImageListImageList

DatacenterSpecAlibaba

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
RegionstringstringRegion to use, for a full list of regions see
https://www.alibabacloud.com/help/doc-detail/40654.htm

DatacenterSpecAnexia

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
LocationIDstringstringLocationID the location of the region

DatacenterSpecAzure

DatacenterSpecAzure describes an Azure cloud datacenter

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
LocationstringstringRegion to use, for example "westeurope". A list of available regions can be
found at https://azure.microsoft.com/en-us/global-infrastructure/locations/

DatacenterSpecBringYourOwn

DatacenterSpecBringYourOwn describes a datacenter our of bring your own nodes

interface{}

DatacenterSpecDigitalocean

DatacenterSpecDigitalocean describes a DigitalOcean datacenter

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
RegionstringstringDatacenter location, e.g. "ams3". A list of existing datacenters can be found
at https://www.digitalocean.com/docs/platform/availability-matrix/

DatacenterSpecFake

DatacenterSpecFake describes a fake datacenter

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
FakePropertystringstring

DatacenterSpecGCP

DatacenterSpecGCP describes a GCP datacenter

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
RegionstringstringRegion to use, for example "europe-west3", for a full list of regions see
https://cloud.google.com/compute/docs/regions-zones/
RegionalbooleanboolOptional: Regional clusters spread their resources across multiple availability zones.
Refer to the official documentation for more details on this:
https://cloud.google.com/kubernetes-engine/docs/concepts/regional-clusters
ZoneSuffixes[]string[]stringList of enabled zones, for example [a, c]. See the link above for the available
zones in your chosen region.

DatacenterSpecHetzner

DatacenterSpecHetzner describes a Hetzner cloud datacenter

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DatacenterstringstringDatacenter location, e.g. "nbg1-dc3". A list of existing datacenters can be found
at https://wiki.hetzner.de/index.php/Rechenzentren_und_Anbindung/en
LocationstringstringOptional: Detailed location of the datacenter, like "Hamburg" or "Datacenter 7".
For informational purposes only.
NetworkstringstringNetwork is the pre-existing Hetzner network in which the machines are running.
While machines can be in multiple networks, a single one must be chosen for the
HCloud CCM to work.

DatacenterSpecKubevirt

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DNSPolicystringstringDNSPolicy represents the dns policy for the pod. Valid values are 'ClusterFirstWithHostNet', 'ClusterFirst',
'Default' or 'None'. Defaults to "ClusterFirst". DNS parameters given in DNSConfig will be merged with the
policy selected with DNSPolicy.
dns_configPodDNSConfigPodDNSConfig

DatacenterSpecOpenstack

DatacenterSpecOpenstack describes an OpenStack datacenter

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AuthURLstringstring
AvailabilityZonestringstring
DNSServers[]string[]stringUsed for automatic network creation
EnabledFlavors[]string[]stringOptional: List of enabled flavors for the given datacenter
EnforceFloatingIPbooleanboolOptional
IgnoreVolumeAZbooleanboolOptional
ManageSecurityGroupsbooleanboolOptional: Gets mapped to the "manage-security-groups" setting in the cloud config.
See https://kubernetes.io/docs/concepts/cluster-administration/cloud-providers/#load-balancer
This setting defaults to true.
NodeVolumeAttachLimituint64 (formatted integer)uint64
Regionstringstring
TrustDevicePathbooleanboolOptional: Gets mapped to the "trust-device-path" setting in the cloud config.
See https://kubernetes.io/docs/concepts/cluster-administration/cloud-providers/#block-storage
This setting defaults to false.
UseOctaviabooleanboolOptional: Gets mapped to the "use-octavia" setting in the cloud config.
use-octavia is enabled by default in CCM since v1.17.0, and disabled by
default with the in-tree cloud provider.
imagesImageListImageList
node_size_requirementsOpenstackNodeSizeRequirementsOpenstackNodeSizeRequirements

DatacenterSpecPacket

DatacenterSpecPacket describes a Packet datacenter

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Facilities[]string[]stringThe list of enabled facilities, for example "ams1", for a full list of available
facilities see https://support.packet.com/kb/articles/data-centers

DatacenterSpecVSphere

DatacenterSpecVSphere describes a vSphere datacenter

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AllowInsecurebooleanboolIf set to true, disables the TLS certificate check against the endpoint.
ClusterstringstringOptional: The name of the vSphere cluster to use.
Cluster is deprecated and may be removed in future releases as it is
currently ignored.
The cluster hosting the VMs will be the same VM used as a template is
located.
DatacenterstringstringThe name of the datacenter to use.
DefaultDatastorestringstringThe default Datastore to be used for provisioning volumes using storage
classes/dynamic provisioning and for storing virtual machine files in
case no Datastore or DatastoreCluster is provided at Cluster level.
DefaultStoragePolicystringstringThe name of the storage policy to use for the storage class created in the user cluster.
EndpointstringstringEndpoint URL to use, including protocol, for example "https://vcenter.example.com".
RootPathstringstringOptional: The root path for cluster specific VM folders. Each cluster gets its own
folder below the root folder. Must be the FQDN (for example
"/datacenter-1/vm/all-kubermatic-vms-in-here") and defaults to the root VM
folder: "/datacenter-1/vm"
infra_management_userVSphereCredentialsVSphereCredentials
templatesImageListImageList

DigitaloceanCloudSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Tokenstringstring
credentialsReferenceGlobalSecretKeySelectorGlobalSecretKeySelector

DigitaloceanNodeSpec

DigitaloceanNodeSpec digitalocean node settings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Backupsbooleanboolenable backups for the droplet
IPv6booleanboolenable ipv6 for the droplet
Monitoringbooleanboolenable monitoring for the droplet
Sizestringstringdroplet size slug
Tags[]string[]stringadditional droplet tags

DigitaloceanSize

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Availablebooleanbool
Diskint64 (formatted integer)int64
Memoryint64 (formatted integer)int64
PriceHourlydouble (formatted number)float64
PriceMonthlydouble (formatted number)float64
Regions[]string[]string
Slugstringstring
Transferdouble (formatted number)float64
VCPUsint64 (formatted integer)int64

DigitaloceanSizeList

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Optimized[]DigitaloceanSize[]*DigitaloceanSize
Standard[]DigitaloceanSize[]*DigitaloceanSize

ErrorDetails

ErrorDetails contains details about the error

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Additional[]string[]stringAdditional error messages
Codeint64 (formatted integer)int64The error code
MessagestringstringThe error message

ErrorResponse

ErrorResponse is the default representation of an error

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
errorErrorDetailsErrorDetails

EtcdBackupConfig

EtcdBackupConfig represents an object holding the configuration for etcd backups

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Annotationsmap of stringmap[string]stringAnnotations that can be added to the resource
CreationTimestampdate-time (formatted string)strfmt.DateTimeCreationTimestamp is a timestamp representing the server time when this object was created.
DeletionTimestampdate-time (formatted string)strfmt.DateTimeDeletionTimestamp is a timestamp representing the server time when this object was deleted.
IDstringstringID unique value that identifies the resource generated by the server. Read-Only.
NamestringstringName represents human readable name for the resource
specEtcdBackupConfigSpecEtcdBackupConfigSpec
statusEtcdBackupConfigStatusEtcdBackupConfigStatus

EtcdBackupConfigCondition

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
MessagestringstringHuman readable message indicating details about last transition.
+optional
Reasonstringstring(brief) reason for the condition's last transition.
+optional
lastHeartbeatTimeTimeTime
lastTransitionTimeTimeTime
statusConditionStatusConditionStatus
typeEtcdBackupConfigConditionTypeEtcdBackupConfigConditionType

EtcdBackupConfigConditionType

EtcdBackupConfigConditionType is used to indicate the type of a EtcdBackupConfig condition. For all condition types, the true value must indicate success. All condition types must be registered within the AllClusterConditionTypes variable.

NameTypeGo typeDefaultDescriptionExample
EtcdBackupConfigConditionTypestringstringEtcdBackupConfigConditionType is used to indicate the type of a EtcdBackupConfig condition. For all condition
types, the true value must indicate success. All condition types must be registered within
the AllClusterConditionTypes variable.

EtcdBackupConfigSpec

EtcdBackupConfigSpec represents an object holding the etcd backup configuration specification

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
ClusterIDstringstringClusterID is the id of the cluster which will be backed up
Keepint64 (formatted integer)int64Keep is the number of backups to keep around before deleting the oldest one
If not set, defaults to DefaultKeptBackupsCount. Only used if Schedule is set.
SchedulestringstringSchedule is a cron expression defining when to perform
the backup. If not set, the backup is performed exactly
once, immediately.

EtcdBackupConfigStatus

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CleanupRunningbooleanboolIf the controller was configured with a cleanupContainer, CleanupRunning keeps track of the corresponding job
Conditions[]EtcdBackupConfigCondition[]*EtcdBackupConfigConditionConditions contains conditions of the EtcdBackupConfig
CurrentBackups[]BackupStatus[]*BackupStatusCurrentBackups tracks the creation and deletion progress if all backups managed by the EtcdBackupConfig

EtcdRestore

EtcdRestore represents an object holding the configuration for etcd backup restore

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Namestringstring
specEtcdRestoreSpecEtcdRestoreSpec
statusEtcdRestoreStatusEtcdRestoreStatus

EtcdRestorePhase

NameTypeGo typeDefaultDescriptionExample
EtcdRestorePhasestringstring

EtcdRestoreSpec

EtcdRestoreSpec represents an object holding the etcd backup restore configuration specification

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
BackupDownloadCredentialsSecretstringstringBackupDownloadCredentialsSecret is the name of a secret in the cluster-xxx namespace containing
credentials needed to download the backup
BackupNamestringstringBackupName is the name of the backup to restore from
ClusterIDstringstringClusterID is the id of the cluster which will be restored from the backup

EtcdRestoreStatus

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
phaseEtcdRestorePhaseEtcdRestorePhase
restoreTimeTimeTime

Event

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Annotationsmap of stringmap[string]stringAnnotations that can be added to the resource
Countint32 (formatted integer)int32The number of times this event has occurred.
CreationTimestampdate-time (formatted string)strfmt.DateTimeCreationTimestamp is a timestamp representing the server time when this object was created.
DeletionTimestampdate-time (formatted string)strfmt.DateTimeDeletionTimestamp is a timestamp representing the server time when this object was deleted.
IDstringstringID unique value that identifies the resource generated by the server. Read-Only.
LastTimestampdate-time (formatted string)strfmt.DateTimeThe time at which the most recent occurrence of this event was recorded.
MessagestringstringA human-readable description of the status of this operation.
NamestringstringName represents human readable name for the resource
TypestringstringType of this event (i.e. normal or warning). New types could be added in the future.
involvedObjectObjectReferenceResourceObjectReferenceResource

ExposeStrategy

NameTypeGo typeDefaultDescriptionExample
ExposeStrategystringstring

ExternalCCMMigrationStatus

NameTypeGo typeDefaultDescriptionExample
ExternalCCMMigrationStatusstringstring

ExternalDocumentation

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Descriptionstringstring
URLstringstring

FakeCloudSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Tokenstringstring

FlatcarSpec

FlatcarSpec contains Flatcar Linux specific settings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DisableAutoUpdatebooleanbooldisable flatcar linux auto-update feature

GCPCloudSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Networkstringstring
ServiceAccountstringstring
Subnetworkstringstring
credentialsReferenceGlobalSecretKeySelectorGlobalSecretKeySelector

GCPDiskType

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Descriptionstringstring
Namestringstring

GCPDiskTypeList

[]GCPDiskType

GCPMachineSize

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Descriptionstringstring
Memoryint64 (formatted integer)int64
Namestringstring
VCPUsint64 (formatted integer)int64

GCPMachineSizeList

[]GCPMachineSize

GCPNetwork

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AutoCreateSubnetworksbooleanbool
IDuint64 (formatted integer)uint64
Kindstringstring
Namestringstring
Pathstringstring
Subnetworks[]string[]string

GCPNetworkList

[]GCPNetwork

GCPNodeSpec

GCPNodeSpec gcp specific node settings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CustomImagestringstring
DiskSizeint64 (formatted integer)int64
DiskTypestringstring
Labelsmap of stringmap[string]string
MachineTypestringstring
Preemptiblebooleanbool
Tags[]string[]string
Zonestringstring

GCPSubnetwork

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
GatewayAddressstringstring
IDuint64 (formatted integer)uint64
IPCidrRangestringstring
Kindstringstring
Namestringstring
Networkstringstring
Pathstringstring
PrivateIPGoogleAccessbooleanbool
Regionstringstring
SelfLinkstringstring

GCPSubnetworkList

[]GCPSubnetwork

GCPZone

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Namestringstring

GCPZoneList

[]GCPZone

GVK

GVK group version kind of a resource

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Groupstringstring
Kindstringstring
Versionstringstring

GatekeeperConfig

GatekeeperConfig represents a gatekeeper config

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
specGatekeeperConfigSpecGatekeeperConfigSpec

GatekeeperConfigSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Match[]MatchEntry[]*MatchEntryConfiguration for namespace exclusion
readinessReadinessSpecReadinessSpec
syncSyncSync
validationValidationValidation

GlobalCustomLinks

GlobalCustomLinks defines custom links for global settings

[]CustomLink

GlobalObjectKeySelector

GlobalObjectKeySelector is needed as we can not use v1.SecretKeySelector because it is not cross namespace

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
APIVersionstringstringAPI version of the referent.
+optional
FieldPathstringstringIf 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.
TODO: this design is not final and this field is subject to change in the future.
+optional
Keystringstring
KindstringstringKind of the referent.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+optional
NamestringstringName of the referent.
More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+optional
NamespacestringstringNamespace of the referent.
More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
+optional
ResourceVersionstringstringSpecific resourceVersion to which this reference is made, if any.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
+optional
uidUIDUID

GlobalSecretKeySelector

GlobalSettings

GlobalSettings defines global settings

HealthStatus

NameTypeGo typeDefaultDescriptionExample
HealthStatusint64 (formatted integer)int64

HetznerCloudSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
NetworkstringstringNetwork is the pre-existing Hetzner network in which the machines are running.
While machines can be in multiple networks, a single one must be chosen for the
HCloud CCM to work.
If this is empty, the network configured on the datacenter will be used.
TokenstringstringToken is used to authenticate with the Hetzner cloud API.
credentialsReferenceGlobalSecretKeySelectorGlobalSecretKeySelector

HetznerNodeSpec

HetznerNodeSpec Hetzner node settings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Networkstringstringnetwork name
Typestringstringserver type

HetznerSize

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Coresint64 (formatted integer)int64
Descriptionstringstring
Diskint64 (formatted integer)int64
IDint64 (formatted integer)int64
Memoryfloat (formatted number)float32
Namestringstring

HetznerSizeList

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Dedicated[]HetznerSize[]*HetznerSize
Standard[]HetznerSize[]*HetznerSize

IPVSConfiguration

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
StrictArpbooleanboolStrictArp configure arp_ignore and arp_announce to avoid answering ARP queries from kube-ipvs0 interface.
defaults to true.

Image

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CreatedstringstringCreated is the date when the image was created.
IDstringstringID is the unique ID of an image.
Metadatamap of anymap[string]interface{}Metadata provides free-form key/value pairs that further describe the
image.
MinDiskint64 (formatted integer)int64MinDisk is the minimum amount of disk a flavor must have to be able
to create a server based on the image, measured in GB.
MinRAMint64 (formatted integer)int64MinRAM is the minimum amount of RAM a flavor must have to be able
to create a server based on the image, measured in MB.
NamestringstringName provides a human-readable moniker for the OS image.
Progressint64 (formatted integer)int64The Progress and Status fields indicate image-creation status.
StatusstringstringStatus is the current status of the image.
UpdatedstringstringUpdate is the date when the image was updated.

ImageList

ImageList defines a map of operating system and the image to use

ImageList

JSON

These types are supported: bool, int64, float64, string, []interface{}, map[string]interface{} and nil.

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Raw[]uint8 (formatted integer)[]uint8

JSONSchemaDefinitions

JSONSchemaDefinitions

JSONSchemaDependencies

JSONSchemaDependencies

JSONSchemaProps

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
$schemaJSONSchemaURLJSONSchemaURL
AllOf[]JSONSchemaProps[]*JSONSchemaProps
AnyOf[]JSONSchemaProps[]*JSONSchemaProps
Descriptionstringstring
Enum[]JSON[]*JSON
ExclusiveMaximumbooleanbool
ExclusiveMinimumbooleanbool
Formatstringstringformat is an OpenAPI v3 format string. Unknown formats are ignored. The following formats are validated:

bsonobjectid: a bson object ID, i.e. a 24 characters hex string uri: an URI as parsed by Golang net/url.ParseRequestURI email: an email address as parsed by Golang net/mail.ParseAddress hostname: a valid representation for an Internet host name, as defined by RFC 1034, section 3.1 [RFC1034]. ipv4: an IPv4 IP as parsed by Golang net.ParseIP ipv6: an IPv6 IP as parsed by Golang net.ParseIP cidr: a CIDR as parsed by Golang net.ParseCIDR mac: a MAC address as parsed by Golang net.ParseMAC uuid: an UUID that allows uppercase defined by the regex (?i)^[0-9a-f]{8}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{12}$ uuid3: an UUID3 that allows uppercase defined by the regex (?i)^[0-9a-f]{8}-?[0-9a-f]{4}-?3[0-9a-f]{3}-?[0-9a-f]{4}-?[0-9a-f]{12}$ uuid4: an UUID4 that allows uppercase defined by the regex (?i)^[0-9a-f]{8}-?[0-9a-f]{4}-?4[0-9a-f]{3}-?[89ab][0-9a-f]{3}-?[0-9a-f]{12}$ uuid5: an UUID5 that allows uppercase defined by the regex (?i)^[0-9a-f]{8}-?[0-9a-f]{4}-?5[0-9a-f]{3}-?[89ab][0-9a-f]{3}-?[0-9a-f]{12}$ isbn: an ISBN10 or ISBN13 number string like "0321751043" or "978-0321751041" isbn10: an ISBN10 number string like "0321751043" isbn13: an ISBN13 number string like "978-0321751041" creditcard: a credit card number defined by the regex ^(?:4[0-9]{12}(?:[0-9]{3})?|5[1-5][0-9]{14}|6(?:011|5[0-9][0-9])[0-9]{12}|3[47][0-9]{13}|3(?:0[0-5]|[68][0-9])[0-9]{11}|(?:2131|1800|35\d{3})\d{11})$ with any non digit characters mixed in ssn: a U.S. social security number following the regex ^\d{3}[- ]?\d{2}[- ]?\d{4}$ hexcolor: an hexadecimal color code like "#FFFFFF: following the regex ^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$ rgbcolor: an RGB color code like rgb like "rgb(255,255,2559" byte: base64 encoded binary data password: any kind of string date: a date string like "2006-01-02" as defined by full-date in RFC3339 duration: a duration string like "22 ns" as parsed by Golang time.ParseDuration or compatible with Scala duration format datetime: a date time string like "2014-12-15T19:30:20.000Z" as defined by date-time in RFC3339. | | | ID | string| string | | | | | | MaxItems | int64 (formatted integer)| int64 | | | | | | MaxLength | int64 (formatted integer)| int64 | | | | | | MaxProperties | int64 (formatted integer)| int64 | | | | | | Maximum | double (formatted number)| float64 | | | | | | MinItems | int64 (formatted integer)| int64 | | | | | | MinLength | int64 (formatted integer)| int64 | | | | | | MinProperties | int64 (formatted integer)| int64 | | | | | | Minimum | double (formatted number)| float64 | | | | | | MultipleOf | double (formatted number)| float64 | | | | | | Nullable | boolean| bool | | | | | | OneOf | []JSONSchemaProps| []*JSONSchemaProps | | | | | | Pattern | string| string | | | | | | PatternProperties | map of JSONSchemaProps| map[string]JSONSchemaProps | | | | | | Properties | map of JSONSchemaProps| map[string]JSONSchemaProps | | | | | | Ref | string| string | | | | | | Required | []string| []string | | | | | | Title | string| string | | | | | | Type | string| string | | | | | | UniqueItems | boolean| bool | | | | | | XEmbeddedResource | boolean| bool | | | x-kubernetes-embedded-resource defines that the value is an embedded Kubernetes runtime.Object, with TypeMeta and ObjectMeta. The type must be object. It is allowed to further restrict the embedded object. kind, apiVersion and metadata are validated automatically. x-kubernetes-preserve-unknown-fields is allowed to be true, but does not have to be if the object is fully specified (up to kind, apiVersion, metadata). | | | XIntOrString | boolean| bool | | | x-kubernetes-int-or-string specifies that this value is either an integer or a string. If this is true, an empty type is allowed and type as child of anyOf is permitted if following one of the following patterns:

  1. anyOf: type: integer type: string
  2. allOf: anyOf: type: integer type: string ... zero or more | | | XListMapKeys | []string| []string | | | x-kubernetes-list-map-keys annotates an array with the x-kubernetes-list-type map by specifying the keys used as the index of the map.

This tag MUST only be used on lists that have the "x-kubernetes-list-type" extension set to "map". Also, the values specified for this attribute must be a scalar typed field of the child structure (no nesting is supported).

The properties specified must either be required or have a default value, to ensure those properties are present for all list items.

+optional | | | XListType | string| string | | | x-kubernetes-list-type annotates an array to further describe its topology. This extension must only be used on lists and may have 3 possible values:

  1. atomic: the list is treated as a single entity, like a scalar. Atomic lists will be entirely replaced when updated. This extension may be used on any type of list (struct, scalar, ...).

  2. set: Sets are lists that must not have multiple items with the same value. Each value must be a scalar, an object with x-kubernetes-map-type atomic or an array with x-kubernetes-list-type atomic.

  3. map: These lists are like maps in that their elements have a non-index key used to identify them. Order is preserved upon merge. The map tag must only be used on a list with elements of type object. Defaults to atomic for arrays. +optional | | | XMapType | string| string | | | x-kubernetes-map-type annotates an object to further describe its topology. This extension must only be used when type is object and may have 2 possible values:

  4. granular: These maps are actual maps (key-value pairs) and each fields are independent from each other (they can each be manipulated by separate actors). This is the default behaviour for all maps.

  5. atomic: the list is treated as a single entity, like a scalar. Atomic maps will be entirely replaced when updated. +optional | | | XPreserveUnknownFields | boolean| bool | | | x-kubernetes-preserve-unknown-fields stops the API server decoding step from pruning fields which are not specified in the validation schema. This affects fields recursively, but switches back to normal pruning behaviour if nested properties or additionalProperties are specified in the schema. This can either be true or undefined. False is forbidden. | | | additionalItems | JSONSchemaPropsOrBool| JSONSchemaPropsOrBool | | | | | | additionalProperties | JSONSchemaPropsOrBool| JSONSchemaPropsOrBool | | | | | | default | JSON| JSON | | | | | | definitions | JSONSchemaDefinitions| JSONSchemaDefinitions | | | | | | dependencies | JSONSchemaDependencies| JSONSchemaDependencies | | | | | | example | JSON| JSON | | | | | | externalDocs | ExternalDocumentation| ExternalDocumentation | | | | | | items | JSONSchemaPropsOrArray| JSONSchemaPropsOrArray | | | | | | not | JSONSchemaProps| JSONSchemaProps | | | | |

JSONSchemaPropsOrArray

JSONSchemaPropsOrArray represents a value that can either be a JSONSchemaProps or an array of JSONSchemaProps. Mainly here for serialization purposes.

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
JSONSchemas[]JSONSchemaProps[]*JSONSchemaProps
SchemaJSONSchemaPropsJSONSchemaProps

JSONSchemaPropsOrBool

Defaults to true for the boolean property.

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Allowsbooleanbool
SchemaJSONSchemaPropsJSONSchemaProps

JSONSchemaPropsOrStringArray

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Property[]string[]string
SchemaJSONSchemaPropsJSONSchemaProps

JSONSchemaURL

NameTypeGo typeDefaultDescriptionExample
JSONSchemaURLstringstring

Kind

Kind specifies the resource Kind and APIGroup

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
APIGroups[]string[]stringAPIGroups specifies the APIGroups of the resources
Kinds[]string[]stringKinds specifies the kinds of the resources

KubermaticVersions

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
APIstringstringVersion of the Kubermatic API server.

KubevirtCloudSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Kubeconfigstringstring
credentialsReferenceGlobalSecretKeySelectorGlobalSecretKeySelector

KubevirtNodeSpec

KubevirtNodeSpec kubevirt specific node settings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CPUsstringstringCPUs states how many cpus the kubevirt node will have.
MemorystringstringMemory states the memory that kubevirt node will have.
NamespacestringstringNamespace states in which namespace kubevirt node will be provisioned.
PVCSizestringstringPVCSize states the size of the provisioned pvc per node.
SourceURLstringstringSourceURL states the url from which the imported image will be downloaded.
StorageClassNamestringstringStorageClassName states the storage class name for the provisioned PVCs.

LBSKU

NameTypeGo typeDefaultDescriptionExample
LBSKUstringstring

LabelKeyList

[]string

LabelSelector

A label selector is a label query over a set of resources. The result of matchLabels and matchExpressions are ANDed. An empty label selector matches all objects. A null label selector matches no objects. +structType=atomic

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
MatchExpressions[]LabelSelectorRequirement[]*LabelSelectorRequirementmatchExpressions is a list of label selector requirements. The requirements are ANDed.
+optional
MatchLabelsmap of stringmap[string]stringmatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions, whose key field is "key", the
operator is "In", and the values array contains only "value". The requirements are ANDed.
+optional

LabelSelectorOperator

NameTypeGo typeDefaultDescriptionExample
LabelSelectorOperatorstringstring

LabelSelectorRequirement

A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Keystringstringkey is the label key that the selector applies to.
+patchMergeKey=key
+patchStrategy=merge
Values[]string[]stringvalues is an array of string values. If the operator is In or NotIn,
the values array must be non-empty. If the operator is Exists or DoesNotExist,
the values array must be empty. This array is replaced during a strategic
merge patch.
+optional
operatorLabelSelectorOperatorLabelSelectorOperator

Limits

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
absoluteAbsoluteAbsolute

LoggingRateLimitSettings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
IngestionBurstSizeint32 (formatted integer)int32IngestionBurstSize represents ingestion burst size in number of requests (nginx burst).
IngestionRateint32 (formatted integer)int32IngestionRate represents ingestion rate limit in requests per second (nginx rate in r/s).
QueryBurstSizeint32 (formatted integer)int32QueryBurstSize represents query burst size in number of requests (nginx burst).
QueryRateint32 (formatted integer)int32QueryRate represents query request rate limit per second (nginx rate in r/s).

MLA

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
UserClusterMLAEnabledbooleanboolwhether the user cluster MLA (Monitoring, Logging & Alerting) stack is enabled in the seed

MLAAdminSetting

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
loggingRateLimitsLoggingRateLimitSettingsLoggingRateLimitSettings
monitoringRateLimitsMonitoringRateLimitSettingsMonitoringRateLimitSettings

MLASettings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
LoggingEnabledbooleanboolLoggingEnabled is the flag for enabling logging in user cluster.
MonitoringEnabledbooleanboolMonitoringEnabled is the flag for enabling monitoring in user cluster.
loggingResourcesResourceRequirementsResourceRequirements
monitoringResourcesResourceRequirementsResourceRequirements

MachineDeploymentStatus

[MachineDeploymentStatus] MachineDeploymentStatus defines the observed state of MachineDeployment

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AvailableReplicasint32 (formatted integer)int32Total number of available machines (ready for at least minReadySeconds)
targeted by this deployment.
+optional
ObservedGenerationint64 (formatted integer)int64The generation observed by the deployment controller.
+optional
ReadyReplicasint32 (formatted integer)int32Total number of ready machines targeted by this deployment.
+optional
Replicasint32 (formatted integer)int32Total number of non-terminated machines targeted by this deployment
(their labels match the selector).
+optional
UnavailableReplicasint32 (formatted integer)int32Total number of unavailable machines targeted by this deployment.
This is the total number of machines that are still required for
the deployment to have 100% available capacity. They may either
be machines that are running but not yet available or machines
that still have not been created.
+optional
UpdatedReplicasint32 (formatted integer)int32Total number of non-terminated machines targeted by this deployment
that have the desired template spec.
+optional

MachineDeploymentVMResourceQuota

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
EnableGPUbooleanbool
MaxCPUint64 (formatted integer)int64Maximal number of vCPU
MaxRAMint64 (formatted integer)int64Maximum RAM size in GB
MinCPUint64 (formatted integer)int64Minimal number of vCPU
MinRAMint64 (formatted integer)int64Minimal RAM size in GB

MachineNetworkingConfig

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CIDRstringstring
DNSServers[]string[]string
Gatewaystringstring

MasterVersion

MasterVersion describes a version of the master components

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Defaultbooleanbool
RestrictedByKubeletVersionbooleanboolIf true, then given version control plane version is not compatible
with one of the kubelets inside cluster and shouldn't be used.
versionVersionVersion

Match

Match contains the constraint to resource matching data

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
ExcludedNamespaces[]string[]stringExcludedNamespaces is a list of namespace names. If defined, a constraint will only apply to resources not in a listed namespace.
Kinds[]Kind[]*KindKinds accepts a list of objects with apiGroups and kinds fields that list the groups/kinds of objects to which
the constraint will apply. If multiple groups/kinds objects are specified, only one match is needed for the resource to be in scope
Namespaces[]string[]stringNamespaces is a list of namespace names. If defined, a constraint will only apply to resources in a listed namespace.
ScopestringstringScope accepts *, Cluster, or Namespaced which determines if cluster-scoped and/or namesapced-scoped resources are selected. (defaults to *)
labelSelectorLabelSelectorLabelSelector
namespaceSelectorLabelSelectorLabelSelector

MatchEntry

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
ExcludedNamespaces[]string[]stringNamespaces which will be excluded
Processes[]string[]stringProcesses which will be excluded in the given namespaces (sync, webhook, audit, *)

MeteringConfigurations

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Enabledbooleanbool
StorageClassNamestringstringStorageClassName is the name of the storage class that the metering tool uses to save processed files before
exporting it to s3 bucket. Default value is kubermatic-fast.
StorageSizestringstringStorageSize is the size of the storage class. Default value is 100Gi.

MeteringReport

MeteringReport holds objects names and metadata for available reports

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
LastModifieddate-time (formatted string)strfmt.DateTime
Namestringstring
Sizeint64 (formatted integer)int64

MlaOptions

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
LoggingEnabledbooleanbool
LoggingEnforcedbooleanbool
MonitoringEnabledbooleanbool
MonitoringEnforcedbooleanbool

MonitoringRateLimitSettings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
IngestionBurstSizeint32 (formatted integer)int32IngestionBurstSize represents ingestion burst size in samples per second (Cortex ingestion_burst_size).
IngestionRateint32 (formatted integer)int32IngestionRate represents the ingestion rate limit in samples per second (Cortex ingestion_rate).
MaxSamplesPerQueryint32 (formatted integer)int32MaxSamplesPerQuery represents maximum number of samples during a query (Cortex max_samples_per_query).
MaxSeriesPerMetricint32 (formatted integer)int32MaxSeriesPerMetric represents maximum number of series per metric (Cortex max_series_per_metric).
MaxSeriesPerQueryint32 (formatted integer)int32MaxSeriesPerQuery represents maximum number of timeseries during a query (Cortex max_series_per_query).
MaxSeriesTotalint32 (formatted integer)int32MaxSeriesTotal represents maximum number of series per this user cluster (Cortex max_series_per_user).
QueryBurstSizeint32 (formatted integer)int32QueryBurstSize represents query burst size in number of requests (nginx burst).
QueryRateint32 (formatted integer)int32QueryRate represents query request rate limit per second (nginx rate in r/s).

Names

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Kindstringstring
ShortNames[]string[]string

Namespace

Namespace defines namespace

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Namestringstring

NetworkRanges

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CIDRBlocks[]string[]string

Node

Node represents a worker node that is part of a cluster

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Annotationsmap of stringmap[string]stringAnnotations that can be added to the resource
CreationTimestampdate-time (formatted string)strfmt.DateTimeCreationTimestamp is a timestamp representing the server time when this object was created.
DeletionTimestampdate-time (formatted string)strfmt.DateTimeDeletionTimestamp is a timestamp representing the server time when this object was deleted.
IDstringstringID unique value that identifies the resource generated by the server. Read-Only.
NamestringstringName represents human readable name for the resource
specNodeSpecNodeSpec
statusNodeStatusNodeStatus

NodeAddress

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Addressstringstring192.168.1.1, node1.my.dns
TypestringstringExternalIP, InternalIP, InternalDNS, ExternalDNS

NodeCloudSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
alibabaAlibabaNodeSpecAlibabaNodeSpec
anexiaAnexiaNodeSpecAnexiaNodeSpec
awsAWSNodeSpecAWSNodeSpec
azureAzureNodeSpecAzureNodeSpec
digitaloceanDigitaloceanNodeSpecDigitaloceanNodeSpec
gcpGCPNodeSpecGCPNodeSpec
hetznerHetznerNodeSpecHetznerNodeSpec
kubevirtKubevirtNodeSpecKubevirtNodeSpec
openstackOpenstackNodeSpecOpenstackNodeSpec
packetPacketNodeSpecPacketNodeSpec
vsphereVSphereNodeSpecVSphereNodeSpec

NodeDeployment

NodeDeployment represents a set of worker nodes that is part of a cluster

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Annotationsmap of stringmap[string]stringAnnotations that can be added to the resource
CreationTimestampdate-time (formatted string)strfmt.DateTimeCreationTimestamp is a timestamp representing the server time when this object was created.
DeletionTimestampdate-time (formatted string)strfmt.DateTimeDeletionTimestamp is a timestamp representing the server time when this object was deleted.
IDstringstringID unique value that identifies the resource generated by the server. Read-Only.
NamestringstringName represents human readable name for the resource
specNodeDeploymentSpecNodeDeploymentSpec
statusMachineDeploymentStatusMachineDeploymentStatus

NodeDeploymentRequest

NodeDeploymentRequest represents an asynchronous request to create a NodeDeployment in a user cluster

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Annotationsmap of stringmap[string]stringAnnotations that can be added to the resource
CreationTimestampdate-time (formatted string)strfmt.DateTimeCreationTimestamp is a timestamp representing the server time when this object was created.
DeletionTimestampdate-time (formatted string)strfmt.DateTimeDeletionTimestamp is a timestamp representing the server time when this object was deleted.
IDstringstringID unique value that identifies the resource generated by the server. Read-Only.
NamestringstringName represents human readable name for the resource
specNodeDeploymentRequestSpecNodeDeploymentRequestSpec

NodeDeploymentRequestSpec

NodeDeploymentRequestSpec node deployment request specification

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
ndNodeDeploymentNodeDeployment

NodeDeploymentSpec

NodeDeploymentSpec node deployment specification

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DynamicConfigbooleanbool
MaxReplicasint32 (formatted integer)int32
MinReplicasint32 (formatted integer)int32
Pausedbooleanbool
Replicasint32 (formatted integer)int32
templateNodeSpecNodeSpec

NodeMetric

NodeMetric defines a metric for the given node

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CPUAvailableMillicoresint64 (formatted integer)int64
CPUTotalMillicoresint64 (formatted integer)int64CPUTotalMillicores in m cores
CPUUsedPercentageint64 (formatted integer)int64CPUUsedPercentage in percentage
MemoryAvailableBytesint64 (formatted integer)int64MemoryAvailableBytes available memory for node
MemoryTotalBytesint64 (formatted integer)int64MemoryTotalBytes current memory usage in bytes
MemoryUsedPercentageint64 (formatted integer)int64MemoryUsedPercentage in percentage
Namestringstring

NodeResources

NodeResources cpu and memory of a node

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CPUstringstring
Memorystringstring

NodeSettings

NodeSettings are node specific flags which can be configured on datacenter level

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
HyperkubeImagestringstringOptional: The hyperkube image to use. Currently only Flatcar
makes use of this option.
InsecureRegistries[]string[]stringOptional: These image registries will be configured as insecure
on the container runtime.
PauseImagestringstringOptional: Translates to --pod-infra-container-image on the kubelet.
If not set, the kubelet will default it.
RegistryMirrors[]string[]stringOptional: These image registries will be configured as registry mirrors
on the container runtime.
http_proxyProxyValueProxyValue
no_proxyProxyValueProxyValue

NodeSpec

NodeSpec node specification

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Labelsmap of stringmap[string]stringMap of string keys and values that can be used to organize and categorize (scope and select) objects.
It will be applied to Nodes allowing users run their apps on specific Node using labelSelector.
SSHUserNamestringstring
Taints[]TaintSpec[]*TaintSpecList of taints to set on new nodes
cloudNodeCloudSpecNodeCloudSpec
operatingSystemOperatingSystemSpecOperatingSystemSpec
versionsNodeVersionInfoNodeVersionInfo

NodeStatus

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Addresses[]NodeAddress[]*NodeAddressdifferent addresses of a node
ErrorMessagestringstringin case of a error this will contain a detailed error explanation
ErrorReasonstringstringin case of a error this will contain a short error message
MachineNamestringstringname of the actual Machine object
allocatableNodeResourcesNodeResources
capacityNodeResourcesNodeResources
nodeInfoNodeSystemInfoNodeSystemInfo

NodeSystemInfo

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Architecturestringstring
ContainerRuntimestringstring
ContainerRuntimeVersionstringstring
KernelVersionstringstring
KubeletVersionstringstring
OperatingSystemstringstring

NodeVersionInfo

NodeVersionInfo node version information

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Kubeletstringstring

NodesMetric

NodesMetric defines a metric for a group of nodes

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CPUAvailableMillicoresint64 (formatted integer)int64
CPUTotalMillicoresint64 (formatted integer)int64CPUTotalMillicores in m cores
CPUUsedPercentageint64 (formatted integer)int64CPUUsedPercentage in percentage
MemoryAvailableBytesint64 (formatted integer)int64MemoryAvailableBytes available memory for node
MemoryTotalBytesint64 (formatted integer)int64MemoryTotalBytes current memory usage in bytes
MemoryUsedPercentageint64 (formatted integer)int64MemoryUsedPercentage in percentage

OIDCSettings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
ClientIDstringstring
ClientSecretstringstring
ExtraScopesstringstring
GroupsClaimstringstring
IssuerURLstringstring
RequiredClaimstringstring
UsernameClaimstringstring

OIDCSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
ClientIDstringstring
ClientSecretstringstring
IssuerURLstringstring

OPAIntegrationSettings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
EnabledbooleanboolEnabled is the flag for enabling OPA integration
ExperimentalEnableMutationbooleanboolEnable mutation
WebhookTimeoutSecondsint32 (formatted integer)int32WebhookTimeout is the timeout that is set for the gatekeeper validating webhook admission review calls.
By default 10 seconds.

ObjectMeta

ObjectMeta defines the set of fields that objects returned from the API have

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Annotationsmap of stringmap[string]stringAnnotations that can be added to the resource
CreationTimestampdate-time (formatted string)strfmt.DateTimeCreationTimestamp is a timestamp representing the server time when this object was created.
DeletionTimestampdate-time (formatted string)strfmt.DateTimeDeletionTimestamp is a timestamp representing the server time when this object was deleted.
IDstringstringID unique value that identifies the resource generated by the server. Read-Only.
NamestringstringName represents human readable name for the resource

ObjectReference

New uses of this type are discouraged because of difficulty describing its usage when embedded in APIs.

  1. Ignored fields. It includes many fields which are not generally honored. For instance, ResourceVersion and FieldPath are both very rarely valid in actual usage.
  2. Invalid usage help. It is impossible to add specific help for individual usage. In most embedded usages, there are particular restrictions like, "must refer only to types A and B" or "UID not honored" or "name must be restricted". Those cannot be well described when embedded.
  3. Inconsistent validation. Because the usages are different, the validation rules are different by usage, which makes it hard for users to predict what will happen.
  4. The fields are both imprecise and overly precise. Kind is not a precise mapping to a URL. This can produce ambiguity during interpretation and require a REST mapping. In most cases, the dependency is on the group,resource tuple and the version of the actual struct is irrelevant.
  5. We cannot easily change it. Because this type is embedded in many locations, updates to this type will affect numerous schemas. Don't make new APIs embed an underspecified API type they do not control. Instead of using this type, create a locally provided and used type that is well-focused on your reference. For example, ServiceReferences for admission registration: https://github.com/kubernetes/api/blob/release-1.17/admissionregistration/v1/types.go#L533 . +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object +structType=atomic

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
APIVersionstringstringAPI version of the referent.
+optional
FieldPathstringstringIf 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.
TODO: this design is not final and this field is subject to change in the future.
+optional
KindstringstringKind of the referent.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+optional
NamestringstringName of the referent.
More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+optional
NamespacestringstringNamespace of the referent.
More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
+optional
ResourceVersionstringstringSpecific resourceVersion to which this reference is made, if any.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
+optional
uidUIDUID

ObjectReferenceResource

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
NamestringstringName of the referent.
More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
+optional
NamespacestringstringNamespace of the referent.
More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
+optional
TypestringstringType of the referent.

OpaOptions

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Enabledbooleanbool
Enforcedbooleanbool

OpenstackAvailabilityZone

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
NamestringstringName is the name of the availability zone

OpenstackCloudSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
ApplicationCredentialIDstringstring
ApplicationCredentialSecretstringstring
Domainstringstring
FloatingIPPoolstringstringFloatingIPPool holds the name of the public network
The public network is reachable from the outside world
and should provide the pool of IP addresses to choose from.

When specified, all worker nodes will receive a public ip from this floating ip pool

Note that the network is external if the "External" field is set to true | | | Network | string| string | | | Network holds the name of the internal network When specified, all worker nodes will be attached to this network. If not specified, a network, subnet & router will be created

Note that the network is internal if the "External" field is set to false | | | Password | string| string | | | | | | RouterID | string| string | | | | | | SecurityGroups | string| string | | | | | | ServerGroupID | string| string | | | ServerGroupID used as schedule hint shared between all machines in the cluster, When not specified, soft-anti-affinity server group will be automatically created | | | SubnetCIDR | string| string | | | | | | SubnetID | string| string | | | | | | Tenant | string| string | | | | | | TenantID | string| string | | | | | | Token | string| string | | | Used internally during cluster creation | | | UseOctavia | boolean| bool | | | Whether or not to use Octavia for LoadBalancer type of Service implementation instead of using Neutron-LBaaS. Attention:Openstack CCM use Octavia as default load balancer implementation since v1.17.0

Takes precedence over the 'use_octavia' flag provided at datacenter level if both are specified. +optional | | | UseToken | boolean| bool | | | | | | Username | string| string | | | | | | credentialsReference | GlobalSecretKeySelector| GlobalSecretKeySelector | | | | |

OpenstackNetwork

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
ExternalbooleanboolExternal set if network is the external network
IDstringstringId uniquely identifies the current network
NamestringstringName is the name of the network

OpenstackNodeSizeRequirements

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
MinimumMemoryint64 (formatted integer)int64MinimumMemory is the minimum required amount of memory, measured in MB
MinimumVCPUsint64 (formatted integer)int64VCPUs is the minimum required amount of (virtual) CPUs

OpenstackNodeSpec

OpenstackNodeSpec openstack node settings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AvailabilityZonestringstringif not set, the default AZ from the Datacenter spec will be used
Flavorstringstringinstance flavor
Imagestringstringimage to use
InstanceReadyCheckPeriodstringstringPeriod of time to check for instance ready status, i.e. 10s/1m
InstanceReadyCheckTimeoutstringstringMax time to wait for the instance to be ready, i.e. 10s/1m
RootDiskSizeGBint64 (formatted integer)int64if set, the rootDisk will be a volume. If not, the rootDisk will be on ephemeral storage and its size will be derived from the flavor
Tagsmap of stringmap[string]stringAdditional metadata to set
UseFloatingIPbooleanboolDefines whether floating ip should be used

OpenstackSecurityGroup

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
IDstringstringId uniquely identifies the current security group
NamestringstringName is the name of the security group

OpenstackSize

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Diskint64 (formatted integer)int64Disk is the amount of root disk, measured in GB
IsPublicbooleanboolIsPublic indicates whether the size is public (available to all projects) or scoped to a set of projects
Memoryint64 (formatted integer)int64MemoryTotalBytes is the amount of memory, measured in MB
RegionstringstringRegion specifies the geographic region in which the size resides
SlugstringstringSlug holds the name of the size
Swapint64 (formatted integer)int64Swap is the amount of swap space, measured in MB
VCPUsint64 (formatted integer)int64VCPUs indicates how many (virtual) CPUs are available for this flavor

OpenstackSubnet

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
IDstringstringId uniquely identifies the subnet
NamestringstringName is human-readable name for the subnet

OpenstackTenant

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
IDstringstringId uniquely identifies the current tenant
NamestringstringName is the name of the tenant

OperatingSystemSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
centosCentOSSpecCentOSSpec
flatcarFlatcarSpecFlatcarSpec
rhelRHELSpecRHELSpec
slesSLESSpecSLESSpec
ubuntuUbuntuSpecUbuntuSpec

PacketCPU

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Countint64 (formatted integer)int64
Typestringstring

PacketCloudSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
APIKeystringstring
BillingCyclestringstring
ProjectIDstringstring
credentialsReferenceGlobalSecretKeySelectorGlobalSecretKeySelector

PacketDrive

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Countint64 (formatted integer)int64
Sizestringstring
Typestringstring

PacketNodeSpec

PacketNodeSpec specifies packet specific node settings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
InstanceTypestringstringInstanceType denotes the plan to which the device will be provisioned.
Tags[]string[]stringadditional instance tags

PacketSize

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CPUs[]PacketCPU[]*PacketCPU
Drives[]PacketDrive[]*PacketDrive
Memorystringstring
Namestringstring

PacketSizeList

[]PacketSize

Parameters

Parameters

PodDNSConfig

PodDNSConfig defines the DNS parameters of a pod in addition to those generated from DNSPolicy.

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Nameservers[]string[]stringA list of DNS name server IP addresses.
This will be appended to the base nameservers generated from DNSPolicy.
Duplicated nameservers will be removed.
+optional
Options[]PodDNSConfigOption[]*PodDNSConfigOptionA list of DNS resolver options.
This will be merged with the base options generated from DNSPolicy.
Duplicated entries will be removed. Resolution options given in Options
will override those that appear in the base DNSPolicy.
+optional
Searches[]string[]stringA list of DNS search domains for host-name lookup.
This will be appended to the base search paths generated from DNSPolicy.
Duplicated search paths will be removed.
+optional

PodDNSConfigOption

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
NamestringstringRequired.
Valuestringstring+optional

PolicyRule

PolicyRule holds information that describes a policy rule, but does not contain information about who the rule applies to or which namespace the rule applies to.

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
APIGroups[]string[]stringAPIGroups is the name of the APIGroup that contains the resources. If multiple API groups are specified, any action requested against one of
the enumerated resources in any API group will be allowed.
+optional
NonResourceURLs[]string[]stringNonResourceURLs is a set of partial urls that a user should have access to. *s are allowed, but only as the full, final step in the path
Since non-resource URLs are not namespaced, this field is only applicable for ClusterRoles referenced from a ClusterRoleBinding.
Rules can either apply to API resources (such as "pods" or "secrets") or non-resource URL paths (such as "/api"), but not both.
+optional
ResourceNames[]string[]stringResourceNames is an optional white list of names that the rule applies to. An empty set means that everything is allowed.
+optional
Resources[]string[]stringResources is a list of resources this rule applies to. '*' represents all resources.
+optional
Verbs[]string[]stringVerbs is a list of Verbs that apply to ALL the ResourceKinds and AttributeRestrictions contained in this rule. '*' represents all verbs.

Preset

Preset represents a preset

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Enabledbooleanbool
Namestringstring
Providers[]PresetProvider[]*PresetProvider

PresetList

PresetList represents a list of presets

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Items[]Preset[]*Preset

PresetProvider

PresetProvider represents a preset provider

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Enabledbooleanbool
nameProviderTypeProviderType

Project

Project is a top-level container for a set of resources

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Annotationsmap of stringmap[string]stringAnnotations that can be added to the resource
ClustersNumberint64 (formatted integer)int64
CreationTimestampdate-time (formatted string)strfmt.DateTimeCreationTimestamp is a timestamp representing the server time when this object was created.
DeletionTimestampdate-time (formatted string)strfmt.DateTimeDeletionTimestamp is a timestamp representing the server time when this object was deleted.
IDstringstringID unique value that identifies the resource generated by the server. Read-Only.
Labelsmap of stringmap[string]string
NamestringstringName represents human readable name for the resource
Owners[]User[]*UserOwners an optional owners list for the given project
Statusstringstring

ProjectGroup

ProjectGroup is a helper data structure that stores the information about a project and a group prefix that a user belongs to

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
GroupPrefixstringstring
IDstringstring

ProviderType

NameTypeGo typeDefaultDescriptionExample
ProviderTypestringstring

ProxySettings

ProxySettings allow configuring a HTTP proxy for the controlplanes and nodes

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
http_proxyProxyValueProxyValue
no_proxyProxyValueProxyValue

ProxyValue

NameTypeGo typeDefaultDescriptionExample
ProxyValuestringstring

PublicAWSCloudSpec

interface{}

PublicAlibabaCloudSpec

interface{}

PublicAnexiaCloudSpec

interface{}

PublicAzureCloudSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AssignAvailabilitySetbooleanbool

PublicBringYourOwnCloudSpec

interface{}

PublicCloudSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DatacenterNamestringstring
alibabaPublicAlibabaCloudSpecPublicAlibabaCloudSpec
anexiaPublicAnexiaCloudSpecPublicAnexiaCloudSpec
awsPublicAWSCloudSpecPublicAWSCloudSpec
azurePublicAzureCloudSpecPublicAzureCloudSpec
bringyourownPublicBringYourOwnCloudSpecPublicBringYourOwnCloudSpec
digitaloceanPublicDigitaloceanCloudSpecPublicDigitaloceanCloudSpec
fakePublicFakeCloudSpecPublicFakeCloudSpec
gcpPublicGCPCloudSpecPublicGCPCloudSpec
hetznerPublicHetznerCloudSpecPublicHetznerCloudSpec
kubevirtPublicKubevirtCloudSpecPublicKubevirtCloudSpec
openstackPublicOpenstackCloudSpecPublicOpenstackCloudSpec
packetPublicPacketCloudSpecPublicPacketCloudSpec
vspherePublicVSphereCloudSpecPublicVSphereCloudSpec

PublicDigitaloceanCloudSpec

interface{}

PublicFakeCloudSpec

interface{}

PublicGCPCloudSpec

interface{}

PublicHetznerCloudSpec

interface{}

PublicKubevirtCloudSpec

interface{}

PublicOpenstackCloudSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Domainstringstring
FloatingIPPoolstringstring
Networkstringstring
RouterIDstringstring
SecurityGroupsstringstring
SubnetCIDRstringstring
SubnetIDstringstring
Tenantstringstring
TenantIDstringstring

PublicPacketCloudSpec

interface{}

PublicServiceAccountToken

PublicServiceAccountToken represent an API service account token without secret fields

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Annotationsmap of stringmap[string]stringAnnotations that can be added to the resource
CreationTimestampdate-time (formatted string)strfmt.DateTimeCreationTimestamp is a timestamp representing the server time when this object was created.
DeletionTimestampdate-time (formatted string)strfmt.DateTimeDeletionTimestamp is a timestamp representing the server time when this object was deleted.
Expirydate-time (formatted string)strfmt.DateTimeExpiry is a timestamp representing the time when this token will expire.
IDstringstringID unique value that identifies the resource generated by the server. Read-Only.
NamestringstringName represents human readable name for the resource

PublicVSphereCloudSpec

interface{}

Quantity

The serialization format is:

::= (Note that may be empty, from the "" case in .) ::= 0 | 1 | ... | 9 ::= | ::= | . | . | . ::= "+" | "-" ::= | ::= | | ::= Ki | Mi | Gi | Ti | Pi | Ei (International System of units; See: http://physics.nist.gov/cuu/Units/binary.html) ::= m | "" | k | M | G | T | P | E (Note that 1024 = 1Ki but 1000 = 1k; I didn't choose the capitalization.) ::= "e" | "E"

No matter which of the three exponent forms is used, no quantity may represent a number greater than 2^63-1 in magnitude, nor may it have more than 3 decimal places. Numbers larger or more precise will be capped or rounded up. (E.g.: 0.1m will rounded up to 1m.) This may be extended in the future if we require larger or smaller quantities.

When a Quantity is parsed from a string, it will remember the type of suffix it had, and will use the same type again when it is serialized.

Before serializing, Quantity will be put in "canonical form". This means that Exponent/suffix will be adjusted up or down (with a corresponding increase or decrease in Mantissa) such that: a. No precision is lost b. No fractional digits will be emitted c. The exponent (or suffix) is as large as possible. The sign will be omitted unless the number is negative.

Examples: 1.5 will be serialized as "1500m" 1.5Gi will be serialized as "1536Mi"

Note that the quantity will NEVER be internally represented by a floating point number. That is the whole point of this exercise.

Non-canonical values will still parse as long as they are well formed, but will be re-emitted in their canonical form. (So always use canonical form, or don't diff.)

This format is intended to make it difficult to use these numbers without writing some sort of special handling code in the hopes that that will cause implementors to also use a fixed point implementation.

+protobuf=true +protobuf.embed=string +protobuf.options.marshal=false +protobuf.options.(gogoproto.goproto_stringer)=false +k8s:deepcopy-gen=true +k8s:openapi-gen=true

interface{}

Quotas

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
FloatingIPQuotaint64 (formatted integer)int64FloatingIpQuota Sys11 addition with the amount of used and attached floating ips
UsedFloatingIPCountint64 (formatted integer)int64UsedFloatingIpCount is the floating IP quota
limitsLimitsLimits

RHELSpec

RHELSpec contains rhel specific settings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DistUpgradeOnBootbooleanbooldo a dist-upgrade on boot and reboot it required afterwards
RHELSubscriptionManagerPasswordstringstring
RHELSubscriptionManagerUserstringstring
RHSMOfflineTokenstringstring

ReadinessSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
StatsEnabledbooleanboolenables stats for gatekeeper audit

ReportURL

ReportURL represent an S3 pre signed URL to download a report

NameTypeGo typeDefaultDescriptionExample
ReportURLstringstringReportURL represent an S3 pre signed URL to download a report

ResourceLabelMap

ResourceLabelMap

ResourceList

ResourceList

ResourceRequirements

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
limitsResourceListResourceList
requestsResourceListResourceList

ResourceType

NameTypeGo typeDefaultDescriptionExample
ResourceTypestringstring

Role

Role defines RBAC role for the user cluster

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Annotationsmap of stringmap[string]stringAnnotations that can be added to the resource
CreationTimestampdate-time (formatted string)strfmt.DateTimeCreationTimestamp is a timestamp representing the server time when this object was created.
DeletionTimestampdate-time (formatted string)strfmt.DateTimeDeletionTimestamp is a timestamp representing the server time when this object was deleted.
IDstringstringID unique value that identifies the resource generated by the server. Read-Only.
NamestringstringName represents human readable name for the resource
NamespacestringstringIndicates the scope of this role.
Rules[]PolicyRule[]*PolicyRuleRules holds all the PolicyRules for this Role

RoleBinding

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
NamespacestringstringIndicates the scope of this binding.
RoleRefNamestringstring
Subjects[]Subject[]*SubjectSubjects holds references to the objects the role applies to.

RoleName

RoleName defines RBAC role name object for the user cluster

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
NamestringstringName of the role.
Namespace[]string[]stringIndicates the scopes of this role.

RoleUser

RoleUser defines associated user with role

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Groupstringstring
UserEmailstringstring

RuleGroup

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Data[]uint8 (formatted integer)[]uint8contains the RuleGroup data. Ref: https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/#rule_group
typeRuleGroupTypeRuleGroupType

RuleGroupType

NameTypeGo typeDefaultDescriptionExample
RuleGroupTypestringstring

S3BackupCredentials

S3BackupCredentials contains credentials for S3 etcd backups

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AccessKeyIDstringstring
SecretAccessKeystringstring

SLESSpec

SLESSpec contains SLES specific settings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DistUpgradeOnBootbooleanbooldo a dist-upgrade on boot and reboot it required afterwards

SSHKey

SSHKey represents a ssh key

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Annotationsmap of stringmap[string]stringAnnotations that can be added to the resource
CreationTimestampdate-time (formatted string)strfmt.DateTimeCreationTimestamp is a timestamp representing the server time when this object was created.
DeletionTimestampdate-time (formatted string)strfmt.DateTimeDeletionTimestamp is a timestamp representing the server time when this object was deleted.
IDstringstringID unique value that identifies the resource generated by the server. Read-Only.
NamestringstringName represents human readable name for the resource
specSSHKeySpecSSHKeySpec

SSHKeySpec

SSHKeySpec represents the details of a ssh key

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Fingerprintstringstring
PublicKeystringstring

Seed

Seed represents a seed object

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CountrystringstringOptional: Country of the seed as ISO-3166 two-letter code, e.g. DE or UK.
For informational purposes in the Kubermatic dashboard only.
LocationstringstringOptional: Detailed location of the cluster, like "Hamburg" or "Datacenter 7".
For informational purposes in the Kubermatic dashboard only.
NamestringstringName represents human readable name for the resource
SeedDNSOverwritestringstringOptional: This can be used to override the DNS name used for this seed.
By default the seed name is used.
SeedDatacentersmap of Datacentermap[string]DatacenterDatacenters contains a map of the possible datacenters (DCs) in this seed.
Each DC must have a globally unique identifier (i.e. names must be unique
across all seeds).
backupRestoreSeedBackupRestoreConfigurationSeedBackupRestoreConfiguration
expose_strategyExposeStrategyExposeStrategy
kubeconfigObjectReferenceObjectReference
mlaSeedMLASettingsSeedMLASettings
proxy_settingsProxySettingsProxySettings

SeedBackupRestoreConfiguration

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
S3BucketNamestringstringS3BucketName is the S3 bucket name to use for backup and restore.
S3EndpointstringstringS3Endpoint is the S3 API endpoint to use for backup and restore. Defaults to s3.amazonaws.com.

SeedMLASettings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
UserClusterMLAEnabledbooleanboolOptional: UserClusterMLAEnabled controls whether the user cluster MLA (Monitoring, Logging & Alerting) stack is enabled in the seed.

SeedNamesList

[]string

SeedSettings

SeedSettings represents settings for a Seed cluster

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
SeedDNSOverwritestringstringthe Seed level seed dns overwrite
meteringMeteringConfigurationsMeteringConfigurations
mlaMLAMLA

SeedSpec

The spec for a seed data

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CountrystringstringOptional: Country of the seed as ISO-3166 two-letter code, e.g. DE or UK.
For informational purposes in the Kubermatic dashboard only.
LocationstringstringOptional: Detailed location of the cluster, like "Hamburg" or "Datacenter 7".
For informational purposes in the Kubermatic dashboard only.
SeedDNSOverwritestringstringOptional: This can be used to override the DNS name used for this seed.
By default the seed name is used.
SeedDatacentersmap of Datacentermap[string]DatacenterDatacenters contains a map of the possible datacenters (DCs) in this seed.
Each DC must have a globally unique identifier (i.e. names must be unique
across all seeds).
backupRestoreSeedBackupRestoreConfigurationSeedBackupRestoreConfiguration
expose_strategyExposeStrategyExposeStrategy
kubeconfigObjectReferenceObjectReference
mlaSeedMLASettingsSeedMLASettings
proxy_settingsProxySettingsProxySettings

Semver

Semver is struct that encapsulates semver.Semver struct so we can use it in API +k8s:deepcopy-gen=true

interface{}

ServiceAccount

ServiceAccount represent an API service account

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Annotationsmap of stringmap[string]stringAnnotations that can be added to the resource
CreationTimestampdate-time (formatted string)strfmt.DateTimeCreationTimestamp is a timestamp representing the server time when this object was created.
DeletionTimestampdate-time (formatted string)strfmt.DateTimeDeletionTimestamp is a timestamp representing the server time when this object was deleted.
GroupstringstringGroup that a service account belongs to
IDstringstringID unique value that identifies the resource generated by the server. Read-Only.
NamestringstringName represents human readable name for the resource
StatusstringstringStatus describes three stages of ServiceAccount life including Active, Inactive and Terminating

ServiceAccountSettings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
APIAudiences[]string[]stringAPIAudiences are the Identifiers of the API
If this is not specified, it will be set to a single element list containing the issuer URL
IssuerstringstringIssuer is the identifier of the service account token issuer
If this is not specified, it will be set to the URL of apiserver by default
TokenVolumeProjectionEnabledbooleanbool

ServiceAccountToken

ServiceAccountToken represent an API service account token

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Annotationsmap of stringmap[string]stringAnnotations that can be added to the resource
CreationTimestampdate-time (formatted string)strfmt.DateTimeCreationTimestamp is a timestamp representing the server time when this object was created.
DeletionTimestampdate-time (formatted string)strfmt.DateTimeDeletionTimestamp is a timestamp representing the server time when this object was deleted.
Expirydate-time (formatted string)strfmt.DateTimeExpiry is a timestamp representing the time when this token will expire.
IDstringstringID unique value that identifies the resource generated by the server. Read-Only.
NamestringstringName represents human readable name for the resource
TokenstringstringToken the JWT token

SettingSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DefaultNodeCountint8 (formatted integer)int8
DisplayAPIDocsbooleanbool
DisplayDemoInfobooleanbool
DisplayTermsOfServicebooleanbool
EnableDashboardbooleanbool
EnableExternalClusterImportbooleanbool
EnableOIDCKubeconfigbooleanbool
MlaAlertmanagerPrefixstringstring
MlaGrafanaPrefixstringstring
RestrictProjectCreationbooleanbool
UserProjectsLimitint64 (formatted integer)int64
cleanupOptionsCleanupOptionsCleanupOptions
clusterTypeOptionsClusterTypeClusterType
customLinksCustomLinksCustomLinks
machineDeploymentVMResourceQuotaMachineDeploymentVMResourceQuotaMachineDeploymentVMResourceQuota
mlaOptionsMlaOptionsMlaOptions
opaOptionsOpaOptionsOpaOptions

Subject

or a value for non-objects such as user and group names. +structType=atomic

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
APIGroupstringstringAPIGroup holds the API group of the referenced subject.
Defaults to "" for ServiceAccount subjects.
Defaults to "rbac.authorization.k8s.io" for User and Group subjects.
+optional
KindstringstringKind of object being referenced. Values defined by this API group are "User", "Group", and "ServiceAccount".
If the Authorizer does not recognized the kind value, the Authorizer should report an error.
NamestringstringName of the object being referenced.
NamespacestringstringNamespace of the referenced object. If the object kind is non-namespace, such as "User" or "Group", and this value is not empty
the Authorizer should report an error.
+optional

Sync

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
SyncOnly[]GVK[]*GVKIf non-empty, entries on this list will be replicated into OPA

Sys11AuthSettings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Realmstringstring

TaintSpec

TaintSpec defines a node taint

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Effectstringstring
Keystringstring
Valuestringstring

Target

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Libs[]string[]string
Regostringstring
Targetstringstring

Time

Programs using times should typically store and pass them as values, not pointers. That is, time variables and struct fields should be of type time.Time, not *time.Time.

A Time value can be used by multiple goroutines simultaneously except that the methods GobDecode, UnmarshalBinary, UnmarshalJSON and UnmarshalText are not concurrency-safe.

Time instants can be compared using the Before, After, and Equal methods. The Sub method subtracts two instants, producing a Duration. The Add method adds a Time and a Duration, producing a Time.

The zero value of type Time is January 1, year 1, 00:00:00.000000000 UTC. As this time is unlikely to come up in practice, the IsZero method gives a simple way of detecting a time that has not been initialized explicitly.

Each Time has associated with it a Location, consulted when computing the presentation form of the time, such as in the Format, Hour, and Year methods. The methods Local, UTC, and In return a Time with a specific location. Changing the location in this way changes only the presentation; it does not change the instant in time being denoted and therefore does not affect the computations described in earlier paragraphs.

Representations of a Time value saved by the GobEncode, MarshalBinary, MarshalJSON, and MarshalText methods store the Time.Location's offset, but not the location name. They therefore lose information about Daylight Saving Time.

In addition to the required “wall clock” reading, a Time may contain an optional reading of the current process's monotonic clock, to provide additional precision for comparison or subtraction. See the “Monotonic Clocks” section in the package documentation for details.

Note that the Go == operator compares not just the time instant but also the Location and the monotonic clock reading. Therefore, Time values should not be used as map or database keys without first guaranteeing that the identical Location has been set for all values, which can be achieved through use of the UTC or Local method, and that the monotonic clock reading has been stripped by setting t = t.Round(0). In general, prefer t.Equal(u) to t == u, since t.Equal uses the most accurate comparison available and correctly handles the case when only one of its arguments has a monotonic clock reading.

NameTypeGo typeDefaultDescriptionExample
Timedate-time (formatted string)strfmt.DateTimePrograms using times should typically store and pass them as values,
not pointers. That is, time variables and struct fields should be of
type time.Time, not *time.Time.

A Time value can be used by multiple goroutines simultaneously except that the methods GobDecode, UnmarshalBinary, UnmarshalJSON and UnmarshalText are not concurrency-safe.

Time instants can be compared using the Before, After, and Equal methods. The Sub method subtracts two instants, producing a Duration. The Add method adds a Time and a Duration, producing a Time.

The zero value of type Time is January 1, year 1, 00:00:00.000000000 UTC. As this time is unlikely to come up in practice, the IsZero method gives a simple way of detecting a time that has not been initialized explicitly.

Each Time has associated with it a Location, consulted when computing the presentation form of the time, such as in the Format, Hour, and Year methods. The methods Local, UTC, and In return a Time with a specific location. Changing the location in this way changes only the presentation; it does not change the instant in time being denoted and therefore does not affect the computations described in earlier paragraphs.

Representations of a Time value saved by the GobEncode, MarshalBinary, MarshalJSON, and MarshalText methods store the Time.Location's offset, but not the location name. They therefore lose information about Daylight Saving Time.

In addition to the required “wall clock” reading, a Time may contain an optional reading of the current process's monotonic clock, to provide additional precision for comparison or subtraction. See the “Monotonic Clocks” section in the package documentation for details.

Note that the Go == operator compares not just the time instant but also the Location and the monotonic clock reading. Therefore, Time values should not be used as map or database keys without first guaranteeing that the identical Location has been set for all values, which can be achieved through use of the UTC or Local method, and that the monotonic clock reading has been stripped by setting t = t.Round(0). In general, prefer t.Equal(u) to t == u, since t.Equal uses the most accurate comparison available and correctly handles the case when only one of its arguments has a monotonic clock reading. | |

Trace

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DumpstringstringAlso dump the state of OPA with the trace. Set to All to dump everything.
UserstringstringOnly trace requests from the specified user
kindGVKGVK

UID

UID is a type that holds unique ID values, including UUIDs. Because we don't ONLY use UUIDs, this is an alias to string. Being a type captures intent and helps make sure that UIDs and names do not get conflated.

NameTypeGo typeDefaultDescriptionExample
UIDstringstringUID is a type that holds unique ID values, including UUIDs. Because we
don't ONLY use UUIDs, this is an alias to string. Being a type captures
intent and helps make sure that UIDs and names do not get conflated.

UbuntuSpec

UbuntuSpec ubuntu specific settings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DistUpgradeOnBootbooleanbooldo a dist-upgrade on boot and reboot it required afterwards

UpdateWindow

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Lengthstringstring
Startstringstring

User

User represent an API user

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Annotationsmap of stringmap[string]stringAnnotations that can be added to the resource
CreationTimestampdate-time (formatted string)strfmt.DateTimeCreationTimestamp is a timestamp representing the server time when this object was created.
DeletionTimestampdate-time (formatted string)strfmt.DateTimeDeletionTimestamp is a timestamp representing the server time when this object was deleted.
EmailstringstringEmail an email address of the user
IDstringstringID unique value that identifies the resource generated by the server. Read-Only.
IsAdminbooleanboolIsAdmin indicates admin role
NamestringstringName represents human readable name for the resource
Projects[]ProjectGroup[]*ProjectGroupProjects holds the list of project the user belongs to
along with the group names
userSettingsUserSettingsUserSettings

UserSettings

UserSettings represent an user settings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CollapseSidenavbooleanbool
DisplayAllProjectsForAdminbooleanbool
ItemsPerPageint8 (formatted integer)int8
LastSeenChangelogVersionstringstring
SelectProjectTableViewbooleanbool
SelectedProjectIDstringstring
SelectedThemestringstring

VSphereCloudSpec

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
DatastorestringstringDatastore to be used for storing virtual machines and as a default for
dynamic volume provisioning, it is mutually exclusive with
DatastoreCluster.
+optional
DatastoreClusterstringstringDatastoreCluster to be used for storing virtual machines, it is mutually
exclusive with Datastore.
+optional
FolderstringstringFolder is the folder to be used to group the provisioned virtual
machines.
+optional
PasswordstringstringPassword is the vSphere user password.
+optional
ResourcePoolstringstringResourcePool is used to manage resources such as cpu and memory for vSphere virtual machines. The resource pool
should be defined on vSphere cluster level.
+optional
StoragePolicystringstringStoragePolicy to be used for storage provisioning
UsernamestringstringUsername is the vSphere user name.
+optional
VMNetNamestringstringVMNetName is the name of the vSphere network.
credentialsReferenceGlobalSecretKeySelectorGlobalSecretKeySelector
infraManagementUserVSphereCredentialsVSphereCredentials

VSphereCredentials

VSphereCredentials credentials represents a credential for accessing vSphere

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Passwordstringstring
Usernamestringstring

VSphereDatastoreList

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Datastores[]string[]string

VSphereFolder

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
PathstringstringPath is the path of the folder

VSphereNetwork

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
AbsolutePathstringstringAbsolutePath is the absolute path inside vCenter
NamestringstringName is the name of the network
RelativePathstringstringRelativePath is the relative path inside the datacenter
TypestringstringType defines the type of network

VSphereNodeSpec

VSphereNodeSpec VSphere node settings

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
CPUsint64 (formatted integer)int64
DiskSizeGBint64 (formatted integer)int64
Memoryint64 (formatted integer)int64
Templatestringstring

Validation

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
LegacySchemabooleanbool+kubebuilder:default=true
openAPIV3SchemaJSONSchemaPropsJSONSchemaProps

Version

interface{}

VersionList

VersionList represents a list of versions

[]MasterVersion

Violation

Violation represents a gatekeeper constraint violation

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
EnforcementActionstringstring
Kindstringstring
Messagestringstring
Namestringstring
Namespacestringstring

bcBody

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
backup_credentialsBackupCredentialsBackupCredentials

body

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
KubeconfigstringstringKubeconfig Base64 encoded kubeconfig
NamestringstringName is human readable name for the external cluster

constraintBody

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
NamestringstringName is the name for the constraint
SpecConstraintSpecConstraintSpec

ctBody

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
NamestringstringName of the constraint template
specConstraintTemplateSpecConstraintTemplateSpec

ebcBody

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
NamestringstringName of the etcd backup config
specEtcdBackupConfigSpecEtcdBackupConfigSpec

erBody

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
NamestringstringName of the etcd backup restore. If not set, it will be generated
specEtcdRestoreSpecEtcdRestoreSpec

unsealKeys

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
Keys[]string[]string

wrBody

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
NamestringstringName of the allowed registry
specAllowedRegistrySpecAllowedRegistrySpec

# Packages

No description provided by the author