Clusters
On this page
- List clusters in an organisation.
- List clusters inside an environment for an organisation.
- Create cluster inside an environment.
- Get clusters inside an environment.
- Update a cluster.
- Get cluster join configuration.
- Move cluster to a different environment.
- Get cluster OIDC configuration.
- List cluster node pools.
- Create node pool inside a cluster.
- Update node pool inside a cluster.
- Get node pool join configuration.
- Delete a node pool from a cluster.
- Update Prometheus rules inheritance.
Cloud provider agnostic AME cluster configuration. Translated to a Kubernetes cluster for any supported Cloud Provider.
List clusters in an organisation.
Path Parameters:
organisationSlug
Query Parameters:
includeDetails
(Optional. Default false. If true, returns actual cluster status in response.)pageable
(Optional. When omitted: pageSize=50, pageNumber=0, sortDirection=ASC)
HTTP Responses codes for "List clusters in an organisation."
Status Code | Description |
---|---|
200 | Request was successfully processed. The response body contains the requested data. |
400 | Invalid request parameters. Please review the documentation for valid parameter values. |
403 | You do not have the necessary permissions to access this resource. |
404 | The requested resource could not be found. Please check the resource URL or identifier. |
500 | An internal error occurred on the server. |
Related Objects
ClusterResponse
actualState
objectOne of#/components/schemas/ActualClusterStateResponse
addons
objectameOIDC
booleanautoUpgrade
booleancloudAccount
objectOne of#/components/schemas/CloudAccountReference
cloudCredentials
objectOne of#/components/schemas/CloudCredentialsReference
cloudProvider
stringclusterPodSubnet
stringcni
stringOne ofcustom
cilium
calico
cpu
int64createdAt
date-timecustomerIdentity
uuidcustomerSlug
objectOne of#/components/schemas/Slug
deleteProtection
booleandeletedAt
date-timedescription
stringdesiredStatus
stringOne ofstarting
stopping
deleting
enableMultiAvailabilityZones
booleanenableNATGateway
booleanenableNetworkEncryption
booleanenvironmentIdentity
uuidenvironmentPrometheusRules
booleanenvironmentSlug
objectOne of#/components/schemas/Slug
highlyAvailable
booleanidentity
uuidipWhitelist
arrayList of#/components/schemas/IpWhitelistResponse
maintenanceSchedule
objectOne of#/components/schemas/MaintenanceScheduleResponse
memory
int64modifiedAt
date-timename
stringobservabilityTenant
objectOne of#/components/schemas/ObservabilityTenant
podSecurityStandardsProfile
stringOne ofprivileged
baseline
restricted
poolID
int64poolName
stringprovisionStatus
stringOne ofUNKNOWN
ACCEPTED
OIDC_PROVISIONED
CLUSTER_PROVISIONED
INITIAL_NODE_POOLS_PROVISIONED
INITIAL_ADDONS_PROVISIONED
DONE
region
stringserviceSubnet
stringslug
objectOne of#/components/schemas/Slug
status
stringOne ofnew
provisioning
provisioned
starting
started
stopping
stopped
deleting
deleted
unknown
updateChannel
objectOne of#/components/schemas/UpdateChannelResponse
version
string
PageableObject
offset
int64pageNumber
int32pageSize
int32paged
booleansort
arrayList of#/components/schemas/SortObject
unpaged
boolean
SortObject
ascending
booleandirection
stringignoreCase
booleannullHandling
stringproperty
string
GET /api/v1/orgs/{organisationSlug}/clusters
Response
content
arrayList of#/components/schemas/ClusterResponse
empty
booleanfirst
booleanlast
booleannumber
int32numberOfElements
int32pageable
objectOne of#/components/schemas/PageableObject
size
int32sort
arrayList of#/components/schemas/SortObject
totalElements
int64totalPages
int32
{ "properties": { "content": { "items": { "$ref": "#/components/schemas/ClusterResponse" }, "type": "array" }, "empty": { "type": "boolean" }, "first": { "type": "boolean" }, "last": { "type": "boolean" }, "number": { "format": "int32", "type": "integer" }, "numberOfElements": { "format": "int32", "type": "integer" }, "pageable": { "$ref": "#/components/schemas/PageableObject" }, "size": { "format": "int32", "type": "integer" }, "sort": { "items": { "$ref": "#/components/schemas/SortObject" }, "type": "array" }, "totalElements": { "format": "int64", "type": "integer" }, "totalPages": { "format": "int32", "type": "integer" } }, "type": "object" }
List clusters inside an environment for an organisation.
Path Parameters:
organisationSlug
environmentSlug
Query Parameters:
show-compute
(Optional. Default false. If true, returns accumulated compute information of environment in response.)includeDetails
(Optional. Default false. If true, returns actual cluster status in response.)pageable
(Optional. When omitted: pageSize=50, pageNumber=0, sortDirection=ASC)
HTTP Responses codes for "List clusters inside an environment for an organisation."
Status Code | Description |
---|---|
200 | Request was successfully processed. The response body contains the requested data. |
400 | Invalid request parameters. Please review the documentation for valid parameter values. |
403 | You do not have the necessary permissions to access this resource. |
404 | The requested resource could not be found. Please check the resource URL or identifier. |
500 | An internal error occurred on the server. |
Related Objects
ClusterResponse
actualState
objectOne of#/components/schemas/ActualClusterStateResponse
addons
objectameOIDC
booleanautoUpgrade
booleancloudAccount
objectOne of#/components/schemas/CloudAccountReference
cloudCredentials
objectOne of#/components/schemas/CloudCredentialsReference
cloudProvider
stringclusterPodSubnet
stringcni
stringOne ofcustom
cilium
calico
cpu
int64createdAt
date-timecustomerIdentity
uuidcustomerSlug
objectOne of#/components/schemas/Slug
deleteProtection
booleandeletedAt
date-timedescription
stringdesiredStatus
stringOne ofstarting
stopping
deleting
enableMultiAvailabilityZones
booleanenableNATGateway
booleanenableNetworkEncryption
booleanenvironmentIdentity
uuidenvironmentPrometheusRules
booleanenvironmentSlug
objectOne of#/components/schemas/Slug
highlyAvailable
booleanidentity
uuidipWhitelist
arrayList of#/components/schemas/IpWhitelistResponse
maintenanceSchedule
objectOne of#/components/schemas/MaintenanceScheduleResponse
memory
int64modifiedAt
date-timename
stringobservabilityTenant
objectOne of#/components/schemas/ObservabilityTenant
podSecurityStandardsProfile
stringOne ofprivileged
baseline
restricted
poolID
int64poolName
stringprovisionStatus
stringOne ofUNKNOWN
ACCEPTED
OIDC_PROVISIONED
CLUSTER_PROVISIONED
INITIAL_NODE_POOLS_PROVISIONED
INITIAL_ADDONS_PROVISIONED
DONE
region
stringserviceSubnet
stringslug
objectOne of#/components/schemas/Slug
status
stringOne ofnew
provisioning
provisioned
starting
started
stopping
stopped
deleting
deleted
unknown
updateChannel
objectOne of#/components/schemas/UpdateChannelResponse
version
string
PageableObject
offset
int64pageNumber
int32pageSize
int32paged
booleansort
arrayList of#/components/schemas/SortObject
unpaged
boolean
SortObject
ascending
booleandirection
stringignoreCase
booleannullHandling
stringproperty
string
GET /api/v1/orgs/{organisationSlug}/clusters/{environmentSlug}
Response
content
arrayList of#/components/schemas/ClusterResponse
empty
booleanfirst
booleanlast
booleannumber
int32numberOfElements
int32pageable
objectOne of#/components/schemas/PageableObject
size
int32sort
arrayList of#/components/schemas/SortObject
totalElements
int64totalPages
int32
{ "properties": { "content": { "items": { "$ref": "#/components/schemas/ClusterResponse" }, "type": "array" }, "empty": { "type": "boolean" }, "first": { "type": "boolean" }, "last": { "type": "boolean" }, "number": { "format": "int32", "type": "integer" }, "numberOfElements": { "format": "int32", "type": "integer" }, "pageable": { "$ref": "#/components/schemas/PageableObject" }, "size": { "format": "int32", "type": "integer" }, "sort": { "items": { "$ref": "#/components/schemas/SortObject" }, "type": "array" }, "totalElements": { "format": "int64", "type": "integer" }, "totalPages": { "format": "int32", "type": "integer" } }, "type": "object" }
Create cluster inside an environment.
Path Parameters:
organisationSlug
environmentSlug
HTTP Responses codes for "Create cluster inside an environment."
Status Code | Description |
---|---|
200 | Request was successfully processed. The response body contains the requested data. |
400 | Invalid request parameters. Please review the documentation for valid parameter values. |
403 | You do not have the necessary permissions to access this resource. |
404 | The requested resource could not be found. Please check the resource URL or identifier. |
500 | An internal error occurred on the server. |
Request Body Parameters
addons
objectcloudAccountIdentity
uuid RequiredclusterPodSubnet
objectOne of#/components/schemas/IPRange
cni
stringOne ofcustom
cilium
calico
description
stringenableAutoUpgrade
booleanenableHA
booleanenableHighAvailability
booleanenableMultiAvailabilityZones
booleanenableNATGateway
booleanenableNetworkEncryption
booleanenablePodSecurityStandards
booleanDeprecated
ipWhitelist
arrayList of#/components/schemas/IpWhitelistRequest
maintenanceScheduleIdentity
uuidname
string RequirednodePools
array RequiredList of#/components/schemas/CreateClusterNodePool
podSecurityStandardsProfile
stringOne ofprivileged
baseline
restricted
region
string RequiredserviceSubnet
objectOne of#/components/schemas/IPRange
updateChannel
stringversion
string Required
Related Objects
ActualClusterStateResponse
collectedAt
date-timestatus
stringversion
string
CloudAccountReference
displayName
stringidentity
uuidprimaryCloudCredentials
objectOne of#/components/schemas/CloudCredentialsReference
CloudCredentialsReference
displayName
stringidentity
uuidisPrimary
boolean
CreateClusterNodePool
annotations
objectautoScaling
booleanavailabilityZone
stringenableNodeAutoReplacement
booleanenableNodeReboots
booleanlabels
objectmaxSize
int64minSize
int64name
stringPattern: ^[a-z0-9-]+$
min length: 1
max length: 25
nodeSize
stringtaints
arrayList of#/components/schemas/NodeTaint
upgradeStrategy
stringOne ofREPLACE
INPLACE
INPLACE_WITHOUT_DRAIN
REPLACE_MINOR_INPLACE_PATCH
REPLACE_MINOR_INPLACE_PATCH_WITHOUT_DRAIN
IPRange
ipRange
string
IpWhitelistRequest
cidr
object RequiredOne of#/components/schemas/IPRange
description
string Required
IpWhitelistResponse
cidr
stringdescription
string
MaintenanceScheduleResponse
identity
uuidname
stringwindows
arrayList of#/components/schemas/MaintenanceWindowResponse
ObservabilityTenant
available
booleancluster
objectOne of#/components/schemas/ObservabilityTenantClusterRef
createdAt
date-timecustomer
stringdeletedAt
date-timeenvironment
objectOne of#/components/schemas/ObservabilityTenantEnvironmentRef
id
int64identity
uuidipWhiteList
stringmodifiedAt
date-timename
stringslug
string
Slug
slugValue
string
UpdateChannelResponse
available
booleankubernetesClusterVersion
stringname
string
POST /api/v1/orgs/{organisationSlug}/clusters/{environmentSlug}
Response
actualState
objectOne of#/components/schemas/ActualClusterStateResponse
addons
objectameOIDC
booleanautoUpgrade
booleancloudAccount
objectOne of#/components/schemas/CloudAccountReference
cloudCredentials
objectOne of#/components/schemas/CloudCredentialsReference
cloudProvider
stringclusterPodSubnet
stringcni
stringcpu
int64createdAt
date-timecustomerIdentity
uuidcustomerSlug
objectOne of#/components/schemas/Slug
deleteProtection
booleandeletedAt
date-timedescription
stringdesiredStatus
stringenableMultiAvailabilityZones
booleanenableNATGateway
booleanenableNetworkEncryption
booleanenvironmentIdentity
uuidenvironmentPrometheusRules
booleanenvironmentSlug
objectOne of#/components/schemas/Slug
highlyAvailable
booleanidentity
uuidipWhitelist
arrayList of#/components/schemas/IpWhitelistResponse
maintenanceSchedule
objectOne of#/components/schemas/MaintenanceScheduleResponse
memory
int64modifiedAt
date-timename
stringobservabilityTenant
objectOne of#/components/schemas/ObservabilityTenant
podSecurityStandardsProfile
stringpoolID
int64poolName
stringprovisionStatus
stringregion
stringserviceSubnet
stringslug
objectOne of#/components/schemas/Slug
status
stringupdateChannel
objectOne of#/components/schemas/UpdateChannelResponse
version
string
{ "properties": { "actualState": { "$ref": "#/components/schemas/ActualClusterStateResponse" }, "addons": { "additionalProperties": { "$ref": "#/components/schemas/APIAddon" }, "type": "object" }, "ameOIDC": { "type": "boolean" }, "autoUpgrade": { "type": "boolean" }, "cloudAccount": { "$ref": "#/components/schemas/CloudAccountReference" }, "cloudCredentials": { "$ref": "#/components/schemas/CloudCredentialsReference" }, "cloudProvider": { "type": "string" }, "clusterPodSubnet": { "type": "string" }, "cni": { "enum": [ "custom", "cilium", "calico" ], "type": "string" }, "cpu": { "format": "int64", "type": "integer" }, "createdAt": { "format": "date-time", "type": "string" }, "customerIdentity": { "format": "uuid", "type": "string" }, "customerSlug": { "$ref": "#/components/schemas/Slug" }, "deleteProtection": { "type": "boolean" }, "deletedAt": { "format": "date-time", "type": "string" }, "description": { "type": "string" }, "desiredStatus": { "enum": [ "starting", "stopping", "deleting" ], "type": "string" }, "enableMultiAvailabilityZones": { "type": "boolean" }, "enableNATGateway": { "type": "boolean" }, "enableNetworkEncryption": { "type": "boolean" }, "environmentIdentity": { "format": "uuid", "type": "string" }, "environmentPrometheusRules": { "type": "boolean" }, "environmentSlug": { "$ref": "#/components/schemas/Slug" }, "highlyAvailable": { "type": "boolean" }, "identity": { "format": "uuid", "type": "string" }, "ipWhitelist": { "items": { "$ref": "#/components/schemas/IpWhitelistResponse" }, "type": "array" }, "maintenanceSchedule": { "$ref": "#/components/schemas/MaintenanceScheduleResponse" }, "memory": { "format": "int64", "type": "integer" }, "modifiedAt": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "observabilityTenant": { "$ref": "#/components/schemas/ObservabilityTenant" }, "podSecurityStandardsProfile": { "enum": [ "privileged", "baseline", "restricted" ], "type": "string" }, "poolID": { "format": "int64", "type": "integer" }, "poolName": { "type": "string" }, "provisionStatus": { "enum": [ "UNKNOWN", "ACCEPTED", "OIDC_PROVISIONED", "CLUSTER_PROVISIONED", "INITIAL_NODE_POOLS_PROVISIONED", "INITIAL_ADDONS_PROVISIONED", "DONE" ], "type": "string" }, "region": { "type": "string" }, "serviceSubnet": { "type": "string" }, "slug": { "$ref": "#/components/schemas/Slug" }, "status": { "enum": [ "new", "provisioning", "provisioned", "starting", "started", "stopping", "stopped", "deleting", "deleted", "unknown" ], "type": "string" }, "updateChannel": { "$ref": "#/components/schemas/UpdateChannelResponse" }, "version": { "type": "string" } }, "type": "object" }
Get clusters inside an environment.
Path Parameters:
organisationSlug
environmentSlug
clusterSlug
Query Parameters:
show-compute
(Optional. Default false. If true, returns accumulated compute information of cluster in response.)includeDetails
(Optional. Default false. If true, returns actual cluster status in response.)
HTTP Responses codes for "Get clusters inside an environment."
Status Code | Description |
---|---|
200 | Request was successfully processed. The response body contains the requested data. |
400 | Invalid request parameters. Please review the documentation for valid parameter values. |
403 | You do not have the necessary permissions to access this resource. |
404 | The requested resource could not be found. Please check the resource URL or identifier. |
500 | An internal error occurred on the server. |
Related Objects
ActualClusterStateResponse
collectedAt
date-timestatus
stringversion
string
CloudAccountReference
displayName
stringidentity
uuidprimaryCloudCredentials
objectOne of#/components/schemas/CloudCredentialsReference
CloudCredentialsReference
displayName
stringidentity
uuidisPrimary
boolean
IpWhitelistResponse
cidr
stringdescription
string
MaintenanceScheduleResponse
identity
uuidname
stringwindows
arrayList of#/components/schemas/MaintenanceWindowResponse
ObservabilityTenant
available
booleancluster
objectOne of#/components/schemas/ObservabilityTenantClusterRef
createdAt
date-timecustomer
stringdeletedAt
date-timeenvironment
objectOne of#/components/schemas/ObservabilityTenantEnvironmentRef
id
int64identity
uuidipWhiteList
stringmodifiedAt
date-timename
stringslug
string
Slug
slugValue
string
UpdateChannelResponse
available
booleankubernetesClusterVersion
stringname
string
GET /api/v1/orgs/{organisationSlug}/clusters/{environmentSlug}/{clusterSlug}
Response
actualState
objectOne of#/components/schemas/ActualClusterStateResponse
addons
objectameOIDC
booleanautoUpgrade
booleancloudAccount
objectOne of#/components/schemas/CloudAccountReference
cloudCredentials
objectOne of#/components/schemas/CloudCredentialsReference
cloudProvider
stringclusterPodSubnet
stringcni
stringcpu
int64createdAt
date-timecustomerIdentity
uuidcustomerSlug
objectOne of#/components/schemas/Slug
deleteProtection
booleandeletedAt
date-timedescription
stringdesiredStatus
stringenableMultiAvailabilityZones
booleanenableNATGateway
booleanenableNetworkEncryption
booleanenvironmentIdentity
uuidenvironmentPrometheusRules
booleanenvironmentSlug
objectOne of#/components/schemas/Slug
highlyAvailable
booleanidentity
uuidipWhitelist
arrayList of#/components/schemas/IpWhitelistResponse
maintenanceSchedule
objectOne of#/components/schemas/MaintenanceScheduleResponse
memory
int64modifiedAt
date-timename
stringobservabilityTenant
objectOne of#/components/schemas/ObservabilityTenant
podSecurityStandardsProfile
stringpoolID
int64poolName
stringprovisionStatus
stringregion
stringserviceSubnet
stringslug
objectOne of#/components/schemas/Slug
status
stringupdateChannel
objectOne of#/components/schemas/UpdateChannelResponse
version
string
{ "properties": { "actualState": { "$ref": "#/components/schemas/ActualClusterStateResponse" }, "addons": { "additionalProperties": { "$ref": "#/components/schemas/APIAddon" }, "type": "object" }, "ameOIDC": { "type": "boolean" }, "autoUpgrade": { "type": "boolean" }, "cloudAccount": { "$ref": "#/components/schemas/CloudAccountReference" }, "cloudCredentials": { "$ref": "#/components/schemas/CloudCredentialsReference" }, "cloudProvider": { "type": "string" }, "clusterPodSubnet": { "type": "string" }, "cni": { "enum": [ "custom", "cilium", "calico" ], "type": "string" }, "cpu": { "format": "int64", "type": "integer" }, "createdAt": { "format": "date-time", "type": "string" }, "customerIdentity": { "format": "uuid", "type": "string" }, "customerSlug": { "$ref": "#/components/schemas/Slug" }, "deleteProtection": { "type": "boolean" }, "deletedAt": { "format": "date-time", "type": "string" }, "description": { "type": "string" }, "desiredStatus": { "enum": [ "starting", "stopping", "deleting" ], "type": "string" }, "enableMultiAvailabilityZones": { "type": "boolean" }, "enableNATGateway": { "type": "boolean" }, "enableNetworkEncryption": { "type": "boolean" }, "environmentIdentity": { "format": "uuid", "type": "string" }, "environmentPrometheusRules": { "type": "boolean" }, "environmentSlug": { "$ref": "#/components/schemas/Slug" }, "highlyAvailable": { "type": "boolean" }, "identity": { "format": "uuid", "type": "string" }, "ipWhitelist": { "items": { "$ref": "#/components/schemas/IpWhitelistResponse" }, "type": "array" }, "maintenanceSchedule": { "$ref": "#/components/schemas/MaintenanceScheduleResponse" }, "memory": { "format": "int64", "type": "integer" }, "modifiedAt": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "observabilityTenant": { "$ref": "#/components/schemas/ObservabilityTenant" }, "podSecurityStandardsProfile": { "enum": [ "privileged", "baseline", "restricted" ], "type": "string" }, "poolID": { "format": "int64", "type": "integer" }, "poolName": { "type": "string" }, "provisionStatus": { "enum": [ "UNKNOWN", "ACCEPTED", "OIDC_PROVISIONED", "CLUSTER_PROVISIONED", "INITIAL_NODE_POOLS_PROVISIONED", "INITIAL_ADDONS_PROVISIONED", "DONE" ], "type": "string" }, "region": { "type": "string" }, "serviceSubnet": { "type": "string" }, "slug": { "$ref": "#/components/schemas/Slug" }, "status": { "enum": [ "new", "provisioning", "provisioned", "starting", "started", "stopping", "stopped", "deleting", "deleted", "unknown" ], "type": "string" }, "updateChannel": { "$ref": "#/components/schemas/UpdateChannelResponse" }, "version": { "type": "string" } }, "type": "object" }
Update a cluster.
Path Parameters:
organisationSlug
environmentSlug
clusterSlug
HTTP Responses codes for "Update a cluster."
Status Code | Description |
---|---|
200 | Request was successfully processed. The response body contains the requested data. |
400 | Invalid request parameters. Please review the documentation for valid parameter values. |
403 | You do not have the necessary permissions to access this resource. |
404 | The requested resource could not be found. Please check the resource URL or identifier. |
500 | An internal error occurred on the server. |
Request Body Parameters
addons
objectcloudCredentialsIdentity
uuidcni
stringOne ofcustom
cilium
calico
deleteProtection
booleanenableAutoUpgrade
booleanenableHighAvailability
booleanenableNetworkEncryption
booleanenvironmentSlug
stringipWhitelist
arrayList of#/components/schemas/IpWhitelistRequest
maintenanceScheduleIdentity
uuidpodSecurityStandardsProfile
stringOne ofprivileged
baseline
restricted
status
stringOne ofstarting
stopping
deleting
updateChannel
stringversion
string
Related Objects
ActualClusterStateResponse
collectedAt
date-timestatus
stringversion
string
CloudAccountReference
displayName
stringidentity
uuidprimaryCloudCredentials
objectOne of#/components/schemas/CloudCredentialsReference
CloudCredentialsReference
displayName
stringidentity
uuidisPrimary
boolean
IpWhitelistRequest
cidr
object RequiredOne of#/components/schemas/IPRange
description
string Required
IpWhitelistResponse
cidr
stringdescription
string
MaintenanceScheduleResponse
identity
uuidname
stringwindows
arrayList of#/components/schemas/MaintenanceWindowResponse
ObservabilityTenant
available
booleancluster
objectOne of#/components/schemas/ObservabilityTenantClusterRef
createdAt
date-timecustomer
stringdeletedAt
date-timeenvironment
objectOne of#/components/schemas/ObservabilityTenantEnvironmentRef
id
int64identity
uuidipWhiteList
stringmodifiedAt
date-timename
stringslug
string
Slug
slugValue
string
UpdateChannelResponse
available
booleankubernetesClusterVersion
stringname
string
PATCH /api/v1/orgs/{organisationSlug}/clusters/{environmentSlug}/{clusterSlug}
Response
actualState
objectOne of#/components/schemas/ActualClusterStateResponse
addons
objectameOIDC
booleanautoUpgrade
booleancloudAccount
objectOne of#/components/schemas/CloudAccountReference
cloudCredentials
objectOne of#/components/schemas/CloudCredentialsReference
cloudProvider
stringclusterPodSubnet
stringcni
stringcpu
int64createdAt
date-timecustomerIdentity
uuidcustomerSlug
objectOne of#/components/schemas/Slug
deleteProtection
booleandeletedAt
date-timedescription
stringdesiredStatus
stringenableMultiAvailabilityZones
booleanenableNATGateway
booleanenableNetworkEncryption
booleanenvironmentIdentity
uuidenvironmentPrometheusRules
booleanenvironmentSlug
objectOne of#/components/schemas/Slug
highlyAvailable
booleanidentity
uuidipWhitelist
arrayList of#/components/schemas/IpWhitelistResponse
maintenanceSchedule
objectOne of#/components/schemas/MaintenanceScheduleResponse
memory
int64modifiedAt
date-timename
stringobservabilityTenant
objectOne of#/components/schemas/ObservabilityTenant
podSecurityStandardsProfile
stringpoolID
int64poolName
stringprovisionStatus
stringregion
stringserviceSubnet
stringslug
objectOne of#/components/schemas/Slug
status
stringupdateChannel
objectOne of#/components/schemas/UpdateChannelResponse
version
string
{ "properties": { "actualState": { "$ref": "#/components/schemas/ActualClusterStateResponse" }, "addons": { "additionalProperties": { "$ref": "#/components/schemas/APIAddon" }, "type": "object" }, "ameOIDC": { "type": "boolean" }, "autoUpgrade": { "type": "boolean" }, "cloudAccount": { "$ref": "#/components/schemas/CloudAccountReference" }, "cloudCredentials": { "$ref": "#/components/schemas/CloudCredentialsReference" }, "cloudProvider": { "type": "string" }, "clusterPodSubnet": { "type": "string" }, "cni": { "enum": [ "custom", "cilium", "calico" ], "type": "string" }, "cpu": { "format": "int64", "type": "integer" }, "createdAt": { "format": "date-time", "type": "string" }, "customerIdentity": { "format": "uuid", "type": "string" }, "customerSlug": { "$ref": "#/components/schemas/Slug" }, "deleteProtection": { "type": "boolean" }, "deletedAt": { "format": "date-time", "type": "string" }, "description": { "type": "string" }, "desiredStatus": { "enum": [ "starting", "stopping", "deleting" ], "type": "string" }, "enableMultiAvailabilityZones": { "type": "boolean" }, "enableNATGateway": { "type": "boolean" }, "enableNetworkEncryption": { "type": "boolean" }, "environmentIdentity": { "format": "uuid", "type": "string" }, "environmentPrometheusRules": { "type": "boolean" }, "environmentSlug": { "$ref": "#/components/schemas/Slug" }, "highlyAvailable": { "type": "boolean" }, "identity": { "format": "uuid", "type": "string" }, "ipWhitelist": { "items": { "$ref": "#/components/schemas/IpWhitelistResponse" }, "type": "array" }, "maintenanceSchedule": { "$ref": "#/components/schemas/MaintenanceScheduleResponse" }, "memory": { "format": "int64", "type": "integer" }, "modifiedAt": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "observabilityTenant": { "$ref": "#/components/schemas/ObservabilityTenant" }, "podSecurityStandardsProfile": { "enum": [ "privileged", "baseline", "restricted" ], "type": "string" }, "poolID": { "format": "int64", "type": "integer" }, "poolName": { "type": "string" }, "provisionStatus": { "enum": [ "UNKNOWN", "ACCEPTED", "OIDC_PROVISIONED", "CLUSTER_PROVISIONED", "INITIAL_NODE_POOLS_PROVISIONED", "INITIAL_ADDONS_PROVISIONED", "DONE" ], "type": "string" }, "region": { "type": "string" }, "serviceSubnet": { "type": "string" }, "slug": { "$ref": "#/components/schemas/Slug" }, "status": { "enum": [ "new", "provisioning", "provisioned", "starting", "started", "stopping", "stopped", "deleting", "deleted", "unknown" ], "type": "string" }, "updateChannel": { "$ref": "#/components/schemas/UpdateChannelResponse" }, "version": { "type": "string" } }, "type": "object" }
Get cluster join configuration.
Path Parameters:
organisationSlug
environmentSlug
clusterSlug
HTTP Responses codes for "Get cluster join configuration."
Status Code | Description |
---|---|
200 | Request was successfully processed. The response body contains the requested data. |
400 | Invalid request parameters. Please review the documentation for valid parameter values. |
403 | You do not have the necessary permissions to access this resource. |
404 | The requested resource could not be found. Please check the resource URL or identifier. |
500 | An internal error occurred on the server. |
Related Objects
JoinConfigVersions
containerd
stringcrictl
stringkubernetes
string
GET /api/v1/orgs/{organisationSlug}/clusters/{environmentSlug}/{clusterSlug}/join-config
Response
cloudInitUserDataBase64
stringinstallScriptBase64
stringjoinCommand
stringkubeletConfigBase64
stringupgradeScriptBase64
stringversions
objectOne of#/components/schemas/JoinConfigVersions
{ "properties": { "cloudInitUserDataBase64": { "type": "string" }, "installScriptBase64": { "type": "string" }, "joinCommand": { "type": "string" }, "kubeletConfigBase64": { "type": "string" }, "upgradeScriptBase64": { "type": "string" }, "versions": { "$ref": "#/components/schemas/JoinConfigVersions" } }, "type": "object" }
Move cluster to a different environment.
Path Parameters:
organisationSlug
clusterSlug
HTTP Responses codes for "Move cluster to a different environment."
Status Code | Description |
---|---|
200 | Request was successfully processed. The response body contains the requested data. |
400 | Invalid request parameters. Please review the documentation for valid parameter values. |
403 | You do not have the necessary permissions to access this resource. |
404 | The requested resource could not be found. Please check the resource URL or identifier. |
500 | An internal error occurred on the server. |
Request Body Parameters
currentEnvironment
string Requiredmax length: 100
newEnvironment
string Requiredmax length: 100
Related Objects
ActualClusterStateResponse
collectedAt
date-timestatus
stringversion
string
CloudAccountReference
displayName
stringidentity
uuidprimaryCloudCredentials
objectOne of#/components/schemas/CloudCredentialsReference
CloudCredentialsReference
displayName
stringidentity
uuidisPrimary
boolean
IpWhitelistResponse
cidr
stringdescription
string
MaintenanceScheduleResponse
identity
uuidname
stringwindows
arrayList of#/components/schemas/MaintenanceWindowResponse
ObservabilityTenant
available
booleancluster
objectOne of#/components/schemas/ObservabilityTenantClusterRef
createdAt
date-timecustomer
stringdeletedAt
date-timeenvironment
objectOne of#/components/schemas/ObservabilityTenantEnvironmentRef
id
int64identity
uuidipWhiteList
stringmodifiedAt
date-timename
stringslug
string
Slug
slugValue
string
UpdateChannelResponse
available
booleankubernetesClusterVersion
stringname
string
PUT /api/v1/orgs/{organisationSlug}/clusters/{environmentSlug}/{clusterSlug}/move-environment
Response
actualState
objectOne of#/components/schemas/ActualClusterStateResponse
addons
objectameOIDC
booleanautoUpgrade
booleancloudAccount
objectOne of#/components/schemas/CloudAccountReference
cloudCredentials
objectOne of#/components/schemas/CloudCredentialsReference
cloudProvider
stringclusterPodSubnet
stringcni
stringcpu
int64createdAt
date-timecustomerIdentity
uuidcustomerSlug
objectOne of#/components/schemas/Slug
deleteProtection
booleandeletedAt
date-timedescription
stringdesiredStatus
stringenableMultiAvailabilityZones
booleanenableNATGateway
booleanenableNetworkEncryption
booleanenvironmentIdentity
uuidenvironmentPrometheusRules
booleanenvironmentSlug
objectOne of#/components/schemas/Slug
highlyAvailable
booleanidentity
uuidipWhitelist
arrayList of#/components/schemas/IpWhitelistResponse
maintenanceSchedule
objectOne of#/components/schemas/MaintenanceScheduleResponse
memory
int64modifiedAt
date-timename
stringobservabilityTenant
objectOne of#/components/schemas/ObservabilityTenant
podSecurityStandardsProfile
stringpoolID
int64poolName
stringprovisionStatus
stringregion
stringserviceSubnet
stringslug
objectOne of#/components/schemas/Slug
status
stringupdateChannel
objectOne of#/components/schemas/UpdateChannelResponse
version
string
{ "properties": { "actualState": { "$ref": "#/components/schemas/ActualClusterStateResponse" }, "addons": { "additionalProperties": { "$ref": "#/components/schemas/APIAddon" }, "type": "object" }, "ameOIDC": { "type": "boolean" }, "autoUpgrade": { "type": "boolean" }, "cloudAccount": { "$ref": "#/components/schemas/CloudAccountReference" }, "cloudCredentials": { "$ref": "#/components/schemas/CloudCredentialsReference" }, "cloudProvider": { "type": "string" }, "clusterPodSubnet": { "type": "string" }, "cni": { "enum": [ "custom", "cilium", "calico" ], "type": "string" }, "cpu": { "format": "int64", "type": "integer" }, "createdAt": { "format": "date-time", "type": "string" }, "customerIdentity": { "format": "uuid", "type": "string" }, "customerSlug": { "$ref": "#/components/schemas/Slug" }, "deleteProtection": { "type": "boolean" }, "deletedAt": { "format": "date-time", "type": "string" }, "description": { "type": "string" }, "desiredStatus": { "enum": [ "starting", "stopping", "deleting" ], "type": "string" }, "enableMultiAvailabilityZones": { "type": "boolean" }, "enableNATGateway": { "type": "boolean" }, "enableNetworkEncryption": { "type": "boolean" }, "environmentIdentity": { "format": "uuid", "type": "string" }, "environmentPrometheusRules": { "type": "boolean" }, "environmentSlug": { "$ref": "#/components/schemas/Slug" }, "highlyAvailable": { "type": "boolean" }, "identity": { "format": "uuid", "type": "string" }, "ipWhitelist": { "items": { "$ref": "#/components/schemas/IpWhitelistResponse" }, "type": "array" }, "maintenanceSchedule": { "$ref": "#/components/schemas/MaintenanceScheduleResponse" }, "memory": { "format": "int64", "type": "integer" }, "modifiedAt": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "observabilityTenant": { "$ref": "#/components/schemas/ObservabilityTenant" }, "podSecurityStandardsProfile": { "enum": [ "privileged", "baseline", "restricted" ], "type": "string" }, "poolID": { "format": "int64", "type": "integer" }, "poolName": { "type": "string" }, "provisionStatus": { "enum": [ "UNKNOWN", "ACCEPTED", "OIDC_PROVISIONED", "CLUSTER_PROVISIONED", "INITIAL_NODE_POOLS_PROVISIONED", "INITIAL_ADDONS_PROVISIONED", "DONE" ], "type": "string" }, "region": { "type": "string" }, "serviceSubnet": { "type": "string" }, "slug": { "$ref": "#/components/schemas/Slug" }, "status": { "enum": [ "new", "provisioning", "provisioned", "starting", "started", "stopping", "stopped", "deleting", "deleted", "unknown" ], "type": "string" }, "updateChannel": { "$ref": "#/components/schemas/UpdateChannelResponse" }, "version": { "type": "string" } }, "type": "object" }
Get cluster OIDC configuration.
Path Parameters:
organisationSlug
environmentSlug
clusterSlug
HTTP Responses codes for "Get cluster OIDC configuration."
Status Code | Description |
---|---|
200 | Request was successfully processed. The response body contains the requested data. |
400 | Invalid request parameters. Please review the documentation for valid parameter values. |
403 | You do not have the necessary permissions to access this resource. |
404 | The requested resource could not be found. Please check the resource URL or identifier. |
500 | An internal error occurred on the server. |
GET /api/v1/orgs/{organisationSlug}/clusters/{environmentSlug}/{clusterSlug}/oidc-config
Response
caCertificate
stringclientId
stringclientSecret
stringendpoint
stringissuerUrl
string
{ "properties": { "caCertificate": { "type": "string" }, "clientId": { "type": "string" }, "clientSecret": { "type": "string" }, "endpoint": { "type": "string" }, "issuerUrl": { "type": "string" } }, "type": "object" }
List cluster node pools.
Path Parameters:
organisationSlug
environmentSlug
clusterSlug
HTTP Responses codes for "List cluster node pools."
Status Code | Description |
---|---|
200 | Request was successfully processed. The response body contains the requested data. |
400 | Invalid request parameters. Please review the documentation for valid parameter values. |
403 | You do not have the necessary permissions to access this resource. |
404 | The requested resource could not be found. Please check the resource URL or identifier. |
500 | An internal error occurred on the server. |
GET /api/v1/orgs/{organisationSlug}/clusters/{environmentSlug}/{clusterSlug}/pools
Response
No Content
{ "items": { "$ref": "#/components/schemas/ClusterNodePoolResponse" }, "type": "array" }
Create node pool inside a cluster.
Path Parameters:
organisationSlug
environmentSlug
clusterSlug
HTTP Responses codes for "Create node pool inside a cluster."
Status Code | Description |
---|---|
200 | Request was successfully processed. The response body contains the requested data. |
400 | Invalid request parameters. Please review the documentation for valid parameter values. |
403 | You do not have the necessary permissions to access this resource. |
404 | The requested resource could not be found. Please check the resource URL or identifier. |
500 | An internal error occurred on the server. |
Request Body Parameters
annotations
objectautoScaling
booleanavailabilityZone
stringenableNodeAutoReplacement
booleanenableNodeReboots
booleanlabels
objectmaxSize
int64minSize
int64name
stringPattern: ^[a-z0-9-]+$
min length: 1
max length: 25
nodeSize
stringtaints
arrayList of#/components/schemas/NodeTaint
upgradeStrategy
stringOne ofREPLACE
INPLACE
INPLACE_WITHOUT_DRAIN
REPLACE_MINOR_INPLACE_PATCH
REPLACE_MINOR_INPLACE_PATCH_WITHOUT_DRAIN
Related Objects
NodeTaint
effect
stringkey
stringvalue
string
POST /api/v1/orgs/{organisationSlug}/clusters/{environmentSlug}/{clusterSlug}/pools
Response
annotations
objectautoScaling
booleanavailabilityZone
stringcreatedAt
date-timeenableNodeAutoReplacement
booleanenableNodeReboots
booleanid
int64identity
uuidlabels
objectmaxSize
int64minSize
int64modifiedAt
date-timename
stringnodeSize
stringprovisionStatus
stringtaints
arrayList of#/components/schemas/NodeTaint
upgradeStrategy
string
{ "properties": { "annotations": { "additionalProperties": { "type": "string" }, "type": "object" }, "autoScaling": { "type": "boolean" }, "availabilityZone": { "type": "string" }, "createdAt": { "format": "date-time", "type": "string" }, "enableNodeAutoReplacement": { "type": "boolean" }, "enableNodeReboots": { "type": "boolean" }, "id": { "format": "int64", "type": "integer" }, "identity": { "format": "uuid", "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, "type": "object" }, "maxSize": { "format": "int64", "type": "integer" }, "minSize": { "format": "int64", "type": "integer" }, "modifiedAt": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "nodeSize": { "type": "string" }, "provisionStatus": { "enum": [ "UNKNOWN", "ACCEPTED", "PROVISIONED" ], "type": "string" }, "taints": { "items": { "$ref": "#/components/schemas/NodeTaint" }, "type": "array" }, "upgradeStrategy": { "enum": [ "REPLACE", "INPLACE", "INPLACE_WITHOUT_DRAIN", "REPLACE_MINOR_INPLACE_PATCH", "REPLACE_MINOR_INPLACE_PATCH_WITHOUT_DRAIN" ], "type": "string" } }, "type": "object" }
Update node pool inside a cluster.
Path Parameters:
organisationSlug
environmentSlug
clusterSlug
nodePoolId
HTTP Responses codes for "Update node pool inside a cluster."
Status Code | Description |
---|---|
200 | Request was successfully processed. The response body contains the requested data. |
400 | Invalid request parameters. Please review the documentation for valid parameter values. |
403 | You do not have the necessary permissions to access this resource. |
404 | The requested resource could not be found. Please check the resource URL or identifier. |
500 | An internal error occurred on the server. |
Request Body Parameters
annotations
objectautoScaling
booleanavailabilityZone
stringenableNodeAutoReplacement
booleanenableNodeReboots
booleanlabels
objectmaxSize
int64minSize
int64name
stringPattern: ^[a-z0-9-]+$
min length: 1
max length: 25
nodeSize
stringtaints
arrayList of#/components/schemas/NodeTaint
upgradeStrategy
stringOne ofREPLACE
INPLACE
INPLACE_WITHOUT_DRAIN
REPLACE_MINOR_INPLACE_PATCH
REPLACE_MINOR_INPLACE_PATCH_WITHOUT_DRAIN
Related Objects
NodeTaint
effect
stringkey
stringvalue
string
PUT /api/v1/orgs/{organisationSlug}/clusters/{environmentSlug}/{clusterSlug}/pools/{nodePoolId}
Response
annotations
objectautoScaling
booleanavailabilityZone
stringcreatedAt
date-timeenableNodeAutoReplacement
booleanenableNodeReboots
booleanid
int64identity
uuidlabels
objectmaxSize
int64minSize
int64modifiedAt
date-timename
stringnodeSize
stringprovisionStatus
stringtaints
arrayList of#/components/schemas/NodeTaint
upgradeStrategy
string
{ "properties": { "annotations": { "additionalProperties": { "type": "string" }, "type": "object" }, "autoScaling": { "type": "boolean" }, "availabilityZone": { "type": "string" }, "createdAt": { "format": "date-time", "type": "string" }, "enableNodeAutoReplacement": { "type": "boolean" }, "enableNodeReboots": { "type": "boolean" }, "id": { "format": "int64", "type": "integer" }, "identity": { "format": "uuid", "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, "type": "object" }, "maxSize": { "format": "int64", "type": "integer" }, "minSize": { "format": "int64", "type": "integer" }, "modifiedAt": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "nodeSize": { "type": "string" }, "provisionStatus": { "enum": [ "UNKNOWN", "ACCEPTED", "PROVISIONED" ], "type": "string" }, "taints": { "items": { "$ref": "#/components/schemas/NodeTaint" }, "type": "array" }, "upgradeStrategy": { "enum": [ "REPLACE", "INPLACE", "INPLACE_WITHOUT_DRAIN", "REPLACE_MINOR_INPLACE_PATCH", "REPLACE_MINOR_INPLACE_PATCH_WITHOUT_DRAIN" ], "type": "string" } }, "type": "object" }
Get node pool join configuration.
Path Parameters:
organisationSlug
environmentSlug
clusterSlug
nodePoolId
HTTP Responses codes for "Get node pool join configuration."
Status Code | Description |
---|---|
200 | Request was successfully processed. The response body contains the requested data. |
400 | Invalid request parameters. Please review the documentation for valid parameter values. |
403 | You do not have the necessary permissions to access this resource. |
404 | The requested resource could not be found. Please check the resource URL or identifier. |
500 | An internal error occurred on the server. |
Related Objects
JoinConfigVersions
containerd
stringcrictl
stringkubernetes
string
POST /api/v1/orgs/{organisationSlug}/clusters/{environmentSlug}/{clusterSlug}/pools/{nodePoolId}/join-config
Response
cloudInitUserDataBase64
stringinstallScriptBase64
stringjoinCommand
stringkubeletConfigBase64
stringupgradeScriptBase64
stringversions
objectOne of#/components/schemas/JoinConfigVersions
{ "properties": { "cloudInitUserDataBase64": { "type": "string" }, "installScriptBase64": { "type": "string" }, "joinCommand": { "type": "string" }, "kubeletConfigBase64": { "type": "string" }, "upgradeScriptBase64": { "type": "string" }, "versions": { "$ref": "#/components/schemas/JoinConfigVersions" } }, "type": "object" }
Delete a node pool from a cluster.
Path Parameters:
organisationSlug
environmentSlug
clusterSlug
pool
HTTP Responses codes for "Delete a node pool from a cluster."
Status Code | Description |
---|---|
204 | Request was successfully processed, but there is no response body to return. |
400 | Invalid request parameters. Please review the documentation for valid parameter values. |
403 | You do not have the necessary permissions to access this resource. |
404 | The requested resource could not be found. Please check the resource URL or identifier. |
500 | An internal error occurred on the server. |
DELETE /api/v1/orgs/{organisationSlug}/clusters/{environmentSlug}/{clusterSlug}/pools/{pool}
Response
No Content
Update Prometheus rules inheritance.
Path Parameters:
organisationSlug
environmentSlug
clusterSlug
HTTP Responses codes for "Update Prometheus rules inheritance."
Status Code | Description |
---|---|
200 | Request was successfully processed. The response body contains the requested data. |
400 | Invalid request parameters. Please review the documentation for valid parameter values. |
403 | You do not have the necessary permissions to access this resource. |
404 | The requested resource could not be found. Please check the resource URL or identifier. |
500 | An internal error occurred on the server. |
Request Body Parameters
POST /api/v1/orgs/{organisationSlug}/clusters/{environmentSlug}/{clusterSlug}/prometheus-rules-inheritance
Response
message
string
{ "properties": { "message": { "type": "string" } }, "type": "object" }