Get detailed information about a specific Kubernetes cluster
GET/api/v1/clusters/:clusterId
Retrieves detailed information about a specific Kubernetes cluster
Request
Path Parameters
Cluster Id
Header Parameters
APIKey
Responses
- 200
- 403
- 404
- 500
detailed information about the cluster
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
Array [
]
Array [
]
Array [
Array [
]
]
data
object
addOnService
object[]
addOnService represents the add-on services installed on the cluster
createdTimestamp is the timestamp when the add-on service was created
lastUpdatedTimestamp is the timestamp of the last update to the add-on service
Name is the name of the add-on service
version is the version of the add-on service
application
object[]
application represents the applications deployed on the cluster
createdTimestamp is the timestamp when the application was created
dnsEndpoint is the DNS endpoint for accessing the application
inputSourceType represents the type of input source for the application
lastUpdatedTimestamp is the timestamp of the last update to the application
name is the name of the application
architecture represents the cluster architecture
clusterFQDN is the fully qualified domain name of the cluster
clusterId is the unique identifier for the cluster
clusterName is the name of the cluster
controlPlaneNode
object
controlPlaneNode represents the control plane node configuration
availabilityZones is the list of availability zones If the list is empty then node group will be created in all the availability zones supported by the region and the provider
Possible values: [ondemand
, spot
]
instanceType is the type of the instance, The supported types are ondemand and spot
labels
object
labels to be applied to the nodes in this group
list of machine types for the nodes in this group
maximum number of nodes in the group
minimum number of nodes in the group
Possible values: non-empty
and <= 50 characters
name of the node group, must be a valid DNS name
taints
object[]
taints to be applied to the nodes in this group
Possible values: [NoSchedule
, PreferNoSchedule
, NoExecute
]
effect indicates the taint effect to match can be NoSchedule, PreferNoSchedule or NoExecute
Possible values: non-empty
key is the taint key that the toleration applies to
Possible values: [Equal
, Exists
, NotExist
, NotEqual
]
operator represents a key's relationship to the value Valid operators are Exists and Equal
Possible values: non-empty
value is the taint value the toleration matches to If the operator is Exists, the value should be empty
KubernetesVersion is the version of Kubernetes running on the cluster
lastUpdatedTimestamp is the timestamp of the last update to the cluster
Provider is the cloud provider hosting the cluster
Possible values: [eks
, gke
, aks
, selfHosted
]
Provisioner is the provisioner spec for the cluster
region is the geographical region where the cluster is deployed
state represents the current state of the cluster
totalMonthlyCost represents the estimated monthly cost of the cluster
workerNodes
object[]
workerNode represents the worker node configurations
availabilityZones is the list of availability zones If the list is empty then node group will be created in all the availability zones supported by the region and the provider
Possible values: [ondemand
, spot
]
instanceType is the type of the instance, The supported types are ondemand and spot
labels
object
labels to be applied to the nodes in this group
list of machine types for the nodes in this group
maximum number of nodes in the group
minimum number of nodes in the group
Possible values: non-empty
and <= 50 characters
name of the node group, must be a valid DNS name
taints
object[]
taints to be applied to the nodes in this group
Possible values: [NoSchedule
, PreferNoSchedule
, NoExecute
]
effect indicates the taint effect to match can be NoSchedule, PreferNoSchedule or NoExecute
Possible values: non-empty
key is the taint key that the toleration applies to
Possible values: [Equal
, Exists
, NotExist
, NotEqual
]
operator represents a key's relationship to the value Valid operators are Exists and Equal
Possible values: non-empty
value is the taint value the toleration matches to If the operator is Exists, the value should be empty
{
"data": {
"addOnService": [
{
"createdTimestamp": "string",
"lastUpdatedTimestamp": "string",
"name": "string",
"version": "string"
}
],
"application": [
{
"createdTimestamp": "string",
"dnsEndpoint": "string",
"inputSourceType": "string",
"lastUpdatedTimestamp": "string",
"name": "string"
}
],
"architecture": "string",
"clusterFQDN": "string",
"clusterId": "string",
"clusterName": "string",
"controlPlaneNode": {
"availabilityZones": [
"string"
],
"instanceType": "ondemand",
"labels": {},
"machineTypes": [
"string"
],
"maxNode": 0,
"minNode": 0,
"name": "string",
"taints": [
{
"effect": "NoSchedule",
"key": "string",
"operator": "Equal",
"value": "string"
}
]
},
"kubernetesVersion": "string",
"lastUpdatedTimestamp": "string",
"provider": "string",
"provisionerType": "eks",
"region": "string",
"state": "string",
"totalMonthlyCost": "string",
"workerNodes": [
{
"availabilityZones": [
"string"
],
"instanceType": "ondemand",
"labels": {},
"machineTypes": [
"string"
],
"maxNode": 0,
"minNode": 0,
"name": "string",
"taints": [
{
"effect": "NoSchedule",
"key": "string",
"operator": "Equal",
"value": "string"
}
]
}
]
},
"id": "string",
"message": "string",
"status": "string"
}
forbidden to fetch cluster. Only admin or platform-admin can fetch clusters.
- application/json
- Schema
- Example (from schema)
Schema
{
"error": "string",
"error_code": "string"
}
cluster not found
- application/json
- Schema
- Example (from schema)
Schema
{
"error": "string",
"error_code": "string"
}
internal server error
- application/json
- Schema
- Example (from schema)
Schema
{
"error": "string",
"error_code": "string"
}