Genereate Spec
Collects the specifications of the cluster and returns back the payload which can be used to deploy cluster of the same configuration. It may result in creation of new cluster template as well.
Request
URI
POST
https://{api_host}/hybridity/api//infra/k8s/clusters/{clusterId}
COPY
Path Parameters
string
clusterId
Required
clusterId
Query Parameters
string
action
Required
action
Responses
200
Successfully generated the specifications of the cluster
Returns
clusterSpec
of type(s)
application/json
{
"placementParams": [
{
"name": "name",
"type": "type"
},
{
"name": "name",
"type": "type"
}
],
"clusterType": "MANAGEMENT",
"proxyConfig": {
"http_proxy": "http_proxy",
"no_proxy": "no_proxy",
"https_proxy": "https_proxy",
"caCert": "caCert",
"type": "extension",
"extensionId": "extensionId"
},
"hcxUUID": "hcxUUID",
"vmTemplate": "vmTemplate",
"airgapConfig": {
"caCert": "caCert",
"fqdn": "fqdn",
"ip": "ip",
"type": "extension",
"extensionId": "extensionId"
},
"vimId": "vimId",
"workerNodes": [
{
"placementParams": [
{
"name": "name",
"type": "type"
},
{
"name": "name",
"type": "type"
}
],
"name": "name",
"networks": [
{
"nameservers": [
"nameservers",
"nameservers"
],
"networkName": "networkName",
"label": "label",
"mtu": 6
},
{
"nameservers": [
"nameservers",
"nameservers"
],
"networkName": "networkName",
"label": "label",
"mtu": 6
}
]
},
{
"placementParams": [
{
"name": "name",
"type": "type"
},
{
"name": "name",
"type": "type"
}
],
"name": "name",
"networks": [
{
"nameservers": [
"nameservers",
"nameservers"
],
"networkName": "networkName",
"label": "label",
"mtu": 6
},
{
"nameservers": [
"nameservers",
"nameservers"
],
"networkName": "networkName",
"label": "label",
"mtu": 6
}
]
}
],
"description": "description",
"hcxCloudUrl": "hcxCloudUrl",
"managementClusterId": "managementClusterId",
"clusterTemplateId": "clusterTemplateId",
"clusterConfig": {
"systemSettings": [
{
"name": "syslog",
"properties": {
"protocol": "udp",
"port": 0,
"host": "host"
}
},
{
"name": "syslog",
"properties": {
"protocol": "udp",
"port": 0,
"host": "host"
}
}
],
"csi": [
{
"name": "nfs_client",
"properties": {
"mountPath": "mountPath",
"datastoreUrl": "datastoreUrl",
"zone": "zone",
"serverIP": "serverIP",
"region": "region"
}
},
{
"name": "nfs_client",
"properties": {
"mountPath": "mountPath",
"datastoreUrl": "datastoreUrl",
"zone": "zone",
"serverIP": "serverIP",
"region": "region"
}
}
],
"tools": [
{
"name": "harbor",
"properties": {
"type": "extension",
"extensionId": "extensionId",
"url": "url",
"username": "username"
}
},
{
"name": "harbor",
"properties": {
"type": "extension",
"extensionId": "extensionId",
"url": "url",
"username": "username"
}
}
]
},
"masterNodes": [
{
"placementParams": [
{
"name": "name",
"type": "type"
},
{
"name": "name",
"type": "type"
}
],
"name": "name",
"networks": [
{
"nameservers": [
"nameservers",
"nameservers"
],
"networkName": "networkName",
"label": "label",
"mtu": 0
},
{
"nameservers": [
"nameservers",
"nameservers"
],
"networkName": "networkName",
"label": "label",
"mtu": 0
}
]
},
{
"placementParams": [
{
"name": "name",
"type": "type"
},
{
"name": "name",
"type": "type"
}
],
"name": "name",
"networks": [
{
"nameservers": [
"nameservers",
"nameservers"
],
"networkName": "networkName",
"label": "label",
"mtu": 0
},
{
"nameservers": [
"nameservers",
"nameservers"
],
"networkName": "networkName",
"label": "label",
"mtu": 0
}
]
}
]
}
string
clusterTemplateId
Required
clusterTemplateId
string
clusterType
Required
clusterType
Possible values are :
MANAGEMENT,
WORKLOAD,
string
description
Optional
description
string
hcxCloudUrl
Required
hcxCloudUrl
string
vimId
Optional
vimId
string
hcxUUID
Optional
hcxUUID
string
managementClusterId
Optional
managementClusterId
array of
clusterSpec_masterNodes
masterNodes
Required
Pool of nodes on which Kubernetes control plane can run.
string
vmTemplate
Required
OS Image With Kubernetes
array of
clusterSpec_workerNodes
workerNodes
Optional
Pool of worker nodes on which Network Functions can run. Each Node Pool can be deployed on a vSphere Resource Pool. All the worker nodes in a node pool contain same Kubelet and Operating System Configuration. It is recommended that a Node Pool should be used by only one Network Function, if it has Infrastructure requirements.
400
Bad Request
Returns
errorResponse
of type(s)
application/json
{
"errors": [
{
"code": "code",
"message": "message"
}
]
}
500
Internal Server Error
Returns
errorResponse
of type(s)
application/json
{
"errors": [
{
"code": "code",
"message": "message"
}
]
}On This Page
Infra Operations
POST
Abort Cluster Operation
PUT
Change Cluster Password
POST
Create Cluster Node Pool
DELETE
Delete Node Pool
POST
Deploy Cluster
PUT
Edit Cluster
PUT
Edit Cluster Config
PUT
Edit Node Pool
POST
Genereate Spec
GET
Get Cluster Config
GET
Get Clusters
GET
Get Clusters Node Pools
GET
Get K8 Cluster Node Pool
GET
Get Node Pool Customization
POST
Kuberenetes Version Upgrade Matrix
PUT
Pause Node Pool
POST
Retry Cluster Operation
GET
Supported Kubernetes Versions
PUT
Sync Esx Info
PUT
Unpause Node Pool
PUT
Upgrade Cluster
PUT
Upgrade Cluster Addon
GET
Upgrade History
POST
Upgrade Node Pool
GET
Validate Upgrade Cluster
GET
Vsphere Csi Zone Support