Platform9 Managed Kubernetes 3.0.0

Rest API documentation

Server

/qbert

Node

GET

/v3/{project_uuid}/nodes

GET

/v3/{project_uuid}/nodes/{uuid}

PUT

/v3/{project_uuid}/nodes/{uuid}

List all the nodes in a project identified by the project UUID

Auth

Headers

X-Auth-Token string

Path Params

project_uuid

string

UUID of the project the node belongs to

GET /v3/{project_uuid}/nodes

xxxxxxxxxx
 
curl --get \ --url '/qbert/v3/%7Bproject_uuid%7D/nodes' \ --header 'X-Auth-Token: {X-Auth-Token}'
Copy

Responses

200

array	array[object]
cloudProviderType	string	Type of cloud provider, such as local or aws used to create the cluster
clusterName	string	Name of the cluster the node belongs to
clusterUuid	string	UUID of the cluster the node belongs to
name	string	Host name of the node
uuid	string	UUID of the node
api_responding	integer	1 indicates the API server on this node is running. 0 otherwise. Applicable only if isMaster is 1
primaryIp	string	IP address of the node
status	string	Status of the node. States include “ok”, ”converging”, “failed”. These states indicate the current state of kubernetes setup on the host.
isMaster	integer	1 if this node is a master of a custer. 0 otherwise.
nodePoolName	string	Name of the node pool, the node belongs to
nodePoolUuid	string	UUID of the node pool, the node belongs to
projectId	string	UUID of the project the node belongs to

403

unauthorized to perform this operation

Response

xxxxxxxxxx
 
[ {  "cloudProviderType": "{string}",  "clusterName": "{string}",  "clusterUuid": "{string}",  "name": "{string}",  "uuid": "{string}",  "api_responding": "{integer}",  "primaryIp": "{string}",  "status": "{string}",  "isMaster": "{integer}",  "nodePoolName": "{string}",  "nodePoolUuid": "{string}",  "projectId": "{string}" }]
Copy

Get details of a specific node in project, identified by the UUID

Auth

Headers

X-Auth-Token string

Path Params

uuid	string	UUID of the node
project_uuid	string	UUID of the project the node belongs to

GET /v3/{project_uuid}/nodes/{uuid}

xxxxxxxxxx
 
curl --get \ --url '/qbert/v3/%7Bproject_uuid%7D/nodes/%7Buuid%7D' \ --header 'X-Auth-Token: {X-Auth-Token}'
Copy

Responses

200

object	object
cloudProviderType	string	Type of cloud provider, such as local or aws used to create the cluster
clusterName	string	Name of the cluster the node belongs to
clusterUuid	string	UUID of the cluster the node belongs to
name	string	Host name of the node
uuid	string	UUID of the node
api_responding	integer	1 indicates the API server on this node is running. 0 otherwise. Applicable only if isMaster is 1
primaryIp	string	IP address of the node
status	string	Status of the node. States include “ok”, ”converging”, “failed”. These states indicate the current state of kubernetes setup on the host.
isMaster	integer	1 if this node is a master of a custer. 0 otherwise.
nodePoolName	string	Name of the node pool, the node belongs to
nodePoolUuid	string	UUID of the node pool, the node belongs to
projectId	string	UUID of the project the node belongs to

403

unauthorized to perform this operation

Response

xxxxxxxxxx
 
{ "cloudProviderType": "{string}", "clusterName": "{string}", "clusterUuid": "{string}", "name": "{string}", "uuid": "{string}", "api_responding": "{integer}", "primaryIp": "{string}", "status": "{string}", "isMaster": "{integer}", "nodePoolName": "{string}", "nodePoolUuid": "{string}", "projectId": "{string}"}
Copy

Updates the properties of the node specified by the node UUID

Currently, only the cluster property for a node can be modified and its primary usage is to detach a node from a cluster. The node, if needed, can be reattached to another cluster by using the cluster’s attach API

Auth

Headers

X-Auth-Token string

Path Params

uuid	string	UUID of the node
project_uuid	string	UUID of the project the nodes belongs to

Request Body

object	object
clusterUuid	string	Value of this field must be set to null to detach the node

PUT /v3/{project_uuid}/nodes/{uuid}

xxxxxxxxxx
 
curl --request PUT \ --url '/qbert/v3/%7Bproject_uuid%7D/nodes/%7Buuid%7D' \ --header 'X-Auth-Token: {X-Auth-Token}' \ --data '{  "clusterUuid": "{string}"}'
Copy

Responses

200

OK, if the node gets deattached from the cluster

No response body

403

Unauthorized to perform this operation

Response

xxxxxxxxxx
 
No example response
Copy

Get the list of the cloud provider accounts currently setup in a project identified by project UUID

Auth

Headers

X-Auth-Token string

Path Params

project_uuid

string

UUID of the project the cloud provider belongs to

GET /v3/{project_uuid}/cloudProviders

xxxxxxxxxx
 
curl --get \ --url '/qbert/v3/%7Bproject_uuid%7D/cloudProviders' \ --header 'X-Auth-Token: {X-Auth-Token}'
Copy

Responses

200

array	array[object]
name	string	Name of the cloud provider account
uuid	string	UUID of the cloud provider account
type	string	Type of the cloud provider account
nodePoolUuid	string	UUID of the associated node pool

403

unauthorized to perform this operation

Response

xxxxxxxxxx
 
[ {  "name": "{string}",  "uuid": "{string}",  "type": "{string}",  "nodePoolUuid": "{string}" }]
Copy

Add a cloud provider account

Note that by default, there is one “local” cloud provider, which is used for building clusters manually. Currently, AWS is the only supported cloudProvider, other than the “local” provider.

Auth

Headers

X-Auth-Token string

Path Params

project_uuid

string

UUID of the project the cloud provider account belongs to

Request Body

object	object
name	string	Name of the cloud provider account
type	string	Type of the cloud provider account
key	string	Cloud access key
secret	string	Cloud secret key

POST /v3/{project_uuid}/cloudProviders

xxxxxxxxxx
 
curl --request POST \ --url '/qbert/v3/%7Bproject_uuid%7D/cloudProviders' \ --header 'X-Auth-Token: {X-Auth-Token}' \ --data '{  "name": "{string}",  "type": "{string}",  "key": "{string}",  "secret": "{string}"}'
Copy

Responses

200

OK, if the cloud provider gets created successfully

No response body

403

Unauthorized to perform this operation

Response

xxxxxxxxxx
 
No example response
Copy

Get all available cloud provider types, in a project identified by project UUID

Auth

Headers

X-Auth-Token string

Path Params

project_uuid

string

UUID of the project the cloud provider belongs to

GET /v3/{project_uuid}/cloudProvider/types

xxxxxxxxxx
 
curl --get \ --url '/qbert/v3/%7Bproject_uuid%7D/cloudProvider/types' \ --header 'X-Auth-Token: {X-Auth-Token}'
Copy

Responses

200

object	object
type	string	Cloud provider type. Examples are 'aws','local'

403

unauthorized to perform this operation

Response

xxxxxxxxxx
 
{ "type": "{string}"}
Copy

Get the details for cloud provider account identified by the account_uuid

This is applicable only for public cloud providers

Auth

Headers

X-Auth-Token string

Path Params

uuid	string	UUID of the cloud provider
project_uuid	string	UUID of the project the cloud provider belongs to

GET /v3/{project_uuid}/cloudProviders/{uuid}

xxxxxxxxxx
 
curl --get \ --url '/qbert/v3/%7Bproject_uuid%7D/cloudProviders/%7Buuid%7D' \ --header 'X-Auth-Token: {X-Auth-Token}'
Copy

Responses

200

object	object
Regions	array[object]	Regions belonging to the provider
Endpoint	string	endpoint of the region
RegionName	string	name of the region

403

unauthorized to perform this operation

Response

xxxxxxxxxx
 
{ "Regions": [  {   "Endpoint": "{string}",   "RegionName": "{string}"  } ]}
Copy

Delete a cloud provider account specified by account uuid

Auth

Headers

X-Auth-Token string

Path Params

uuid	string	UUID of the cloud provider
project_uuid	string	UUID of the project the cloud provider account belongs to

DELETE /v3/{project_uuid}/cloudProviders/{uuid}

xxxxxxxxxx
 
curl --request DELETE \ --url '/qbert/v3/%7Bproject_uuid%7D/cloudProviders/%7Buuid%7D' \ --header 'X-Auth-Token: {X-Auth-Token}'
Copy

Responses

200

OK, if the cloud provider gets deleted successfully

No response body

403

Unauthorized to perform this operation

Response

xxxxxxxxxx
 
No example response
Copy

Get the details for a region in a particular cloud provider account identified by the account_uuid

This is applicable only for public cloud providers

Auth

Headers

X-Auth-Token string

Path Params

uuid	string	UUID of the cloud provider
regionid	string	Name of the region
project_uuid	string	UUID of the project the cloud provider belongs to

GET /v3/{project_uuid}/cloudProviders/{uuid}/region/{regionid}

xxxxxxxxxx
 
curl --get \ --url '/qbert/v3/%7Bproject_uuid%7D/cloudProviders/%7Buuid%7D/region/%7Bregionid%7D' \ --header 'X-Auth-Token: {X-Auth-Token}'
Copy

Responses

200

object	object
azs	array[object]	The list of availability zones in the region
domains	array[object]	The list of hosting domains
flavors	array[object]	The list of instance flavors supported in the region
keyPairs	array[object]	The list of ssh key pairs in the region
operatingSystems	array[object]	The list of operating systems available in the region
vpcs	array[object]	The list of virtual private networks available in the region

403

unauthorized to perform this operation

Response

xxxxxxxxxx
 
{ "azs": [  {} ], "domains": [  {} ], "flavors": [  {} ], "keyPairs": [  {} ], "operatingSystems": [  {} ], "vpcs": [  {} ]}
Copy

Add ssh key to a cloud provider region

Auth

Headers

X-Auth-Token string

Path Params

uuid	string	UUID of the cloud provider
regionid	string	Name of the region
project_uuid	string	UUID of the project the cloud provider belongs to

Request Body

object	object
name	string	Name of the key
key	string	Contents of the key

POST /v3/{project_uuid}/cloudProviders/{uuid}/region/{regionid}/sshKey

xxxxxxxxxx
 
curl --request POST \ --url '/qbert/v3/%7Bproject_uuid%7D/cloudProviders/%7Buuid%7D/region/%7Bregionid%7D/sshKey' \ --header 'X-Auth-Token: {X-Auth-Token}' \ --data '{  "name": "{string}",  "key": "{string}"}'
Copy

Responses

200

No response body

400

Key is not in valid OpenSSH public key format

403

unauthorized to perform this operation

Response

xxxxxxxxxx
 
No example response
Copy

Update a cloud provider account specified by account uuid

Auth

Headers

X-Auth-Token string

Path Params

uuid

string

UUID of the cloud provider

Request Body

object	object
name	string	Name of the cloud provider account
key	string	Cloud access key
secret	string	Cloud secret key

PUT /v1/cloudProviders/{uuid}

xxxxxxxxxx
 
curl --request PUT \ --url '/qbert/v1/cloudProviders/%7Buuid%7D' \ --header 'X-Auth-Token: {X-Auth-Token}' \ --data '{  "name": "{string}",  "key": "{string}",  "secret": "{string}"}'
Copy

Responses

200

OK, if the cloud provider gets upddated successfully

No response body

403

Unauthorized to perform this operation

Response

xxxxxxxxxx
 
No example response
Copy

Cluster

GET

/v3/{project_uuid}/clusters

POST

/v3/{project_uuid}/clusters

GET

/v3/{project_uuid}/clusters/{uuid}

PUT

/v3/{project_uuid}/clusters/{uuid}

DELETE

/v3/{project_uuid}/clusters/{uuid}

GET

/v3/{project_uuid}/kubeconfig/{cluster_uuid}

POST

/v3/{project_uuid}/webcli/{uuid}

POST

/v3/{project_uuid}/clusters/{uuid}/attach

POST

/v3/{project_uuid}/clusters/{uuid}/detach

POST

/v3/{project_uuid}/clusters/{uuid}/upgrade

POST

/v3/{project_uuid}/clusters/{uuid}/restart

POST

/v3/{project_uuid}/clusters/{uuid}/restartWorkers

POST

/v3/{project_uuid}/clusters/{uuid}/restartMasters

GET

/v3/{project_uuid}/currentRollingRestarts

Get the list of clusters currently setup in PMK

Auth

Headers

X-Auth-Token string

Path Params

project_uuid

string

UUID of the project the cluster belongs to

GET /v3/{project_uuid}/clusters

xxxxxxxxxx
 
curl --get \ --url '/qbert/v3/%7Bproject_uuid%7D/clusters' \ --header 'X-Auth-Token: {X-Auth-Token}'
Copy

Responses

200

array	array[object]
name	string	Name of the cluster
uuid	string	UUID of the cluster
containersCidr	string	CIDR used for container IP addresses
servicesCidr	string	CIDR used for service IP addresses
isKubernetes	integer	Field is set to 1 if the cluster is a Kubernetes cluster, 0 otherwise
externalDnsName	string	Optional DNS name for API endpoint. This field is autogenerated when pf9 domain is used.
masterIp	string	Ip of the master node, applicable only for cloud provider type 'openstack'
status	string	Status of the cluster
masterStatus	string	Status of the master nodes. 'healthy' means all masters are healthy. 'partially healthy' means quorum number of masters are healthy, but some are not. 'unhealthy' means quorum number of master are unhealthy
workerStatus	string	Status of the worker nodes. 'healthy' means all workers are healthy. 'partially healthy' means more than 50% of the workers are healthy, rest are unhealthy. 'unhealthy' means more than 50% of the workers are unhealthy
flannelIfaceLabel	string	The interface used by flannel for interhost communication
flannelPublicIfaceLabel	string	The IP address used as the flannel public IP for the nodes in the cluster
dockerRoot	string	Root directory for docker
etcdDataDir	string	Data directory for etcd. The field is applicable to master nodes only
lastOp	string	The last operation such as node attach or node detach that was performed on the cluster
lastOk	string	The timestamp when the cluster last reported an OK status
keystoneEnabled	integer	Field is set to 1 if keystone is enabled, 0 otherwise
authzEnabled	integer	Field is set to 1 if authz is enabled, 0 otherwise
taskStatus	string	Status of the last task that run on the cluster.
taskError	string	Error details if the last task on cluster did not succeed
numMasters	integer	Number of master nodes in the cluster
numWorkers	integer	Number of worker nodes in the cluster
privileged	integer	Field is set to 1 if cluster runs privileged containers, 0 otherwise
appCatalogEnabled	integer	Field is set to 1 if app catalog is enabled, 0 otherwise
projectId	string	UUID of the Keystone project that this cluster is part of
runtimeConfig	string
etcdBackup	object
isEtcdBackupEnabled	boolean	Set to true if etcd backup should be enabled, false otherwise
intervalInMins	integer	etcd backup interval, specified in minutes
storageType	string	Storage type for the etcd backup. Only 'local' is current supported type. 'local' saves backup to the node's local disk
storageProperties	object
localPath	string	Path on the local filesystem where the etcd backup should be stored. For 'local' storage type only.
taskStatus	string	Status indicating whether the backup cron job on the Kubernetes cluster was successfully setup. Can be 'success' or 'error'
taskErrorDetail	string	Details of the error occurred of the taskStatus returned is 'error'
nodePoolUuid	string	UUID of the node pool used for the cluster
nodePoolName	string	Name of the node pool used for the cluster
cloudProviderUuid	string	UUID of the cloud provider used to create this cluster
cloudProviderName	string	Name of the cloud provider used to create this cluster
cloudProviderType	string	Type of the cloud provider used to create this cluster
cloudProperties	object
region	string	Cloud provider region in which the cluster was created
masterFlavor	string	Node flavor used for master node
workerFlavor	string	Node flavor used for worker node
sshKey	string	Public SSH key associated with the cluster nodes
serviceFqdn	string	FQDN used to reference cluster services
ami	string	AMI ID used to provision cluster nodes
domainId	string	Domain used for cluster FQDNs
isPrivate	boolean	Set to true if nodes are deployed using public subnet, false otherwise, applicable also for manual deploy. This parameter is required if internalElb is set to true.
usePf9Domain	string	Set to true if platform9.net domain is used, false otherwise
internalElb	boolean	Set to true if load balancer is an internal load balancer or false for an Internet-facing load balancer. More information here: https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-internal-load-balancers.html Setting this parameter to true requires that isPrivate is set to true. If the private subnet selected is not configured to route IP packets through a VPN, then an httpProxy is required for node communications to work
azs	array[string]	Availability zone(s) the cluster is deployed in
httpProxy	string	The http proxy used for node communications. This parameter is required when internalElb is set to true and the private subnet selected does not route IP packets to the internet through a VPN
privateSubnets	array[string]	The private subnet ID to which the cluster is deployed. This parameter is optional if vpc (VPC ID) is set. This parameter is required if vpc (VPC ID) is set and isPrivate is set to true. This parameter is ignored if vpc (VPC ID) is not set
subnets	array[string]
vpc	string	If set, creates cluster using this VPC ID. Otherwise, the cluster is deployed on a new VPC. This parameter is required if internalElb is set to true
customAmi	string	The custom ami name which can be specified by a user
canUpgrade	boolean	Field is set to true if the cluster can be upgraded, false otherwise
networkPlugin	string	Network backend to use for container networking. Defaults to flannel. Supported choices are flannel, calico, noop, weave
allowWorkloadsOnMaster	integer	Field is set to 1 if the master nodes can run non-critical workloads
tags	object	User defined key-value pairs represented as a JSON object
k8sApiPort	string	Port on which K8S API Server will listen, 443 by default
masterVipIpv4	string	API server Virtual IP that provides failover if specified for the cluster. Defaults to empty string
masterVipIface	string	The interface that VIP attaches to if specified. Defaults to empty string
enableMetallb	boolean	1 if metallb enabled. Defaults to 0
metallbCidr	string	Comma separated pools of IPs like A.B.C.D-E.F.G.H, I.J.K.L-M.N.O.P that metallb will manage if specified
masterVipVrouterId	string	Virtual router id choosen for the cluster. Range: 0-254. Emptry string if masterVipIpv4 not specified
calicoV4BlockSize	string	Subnet size per node for the Calico network, in CIDR notation (e.g. 26)
calicoIpIpMode	string	IP-IP encapsulation mode for Calico network. Choose: Always, Never, CrossSubnet
calicoNatOutgoing	boolean	Field is set to true if Calico nodes need to NAT north-south egress traffic.
mtuSize	string	MTU for container network interfaces. Optional and used for the Calico network backend

Expand

403

unauthorized to perform this operation

Response

xxxxxxxxxx
 
[ {  "name": "{string}",  "uuid": "{string}",  "containersCidr": "{string}",  "servicesCidr": "{string}",  "isKubernetes": "{integer}",  "externalDnsName": "{string}",  "masterIp": "{string}",  "status": "{string}",  "masterStatus": "{string}",  "workerStatus": "{string}",  "flannelIfaceLabel": "{string}",  "flannelPublicIfaceLabel": "{string}",  "dockerRoot": "{string}",  "etcdDataDir": "{string}",  "lastOp": "{string}",  "lastOk": "{string}",  "keystoneEnabled": "{integer}",  "authzEnabled": "{integer}",  "taskStatus": "{string}",  "taskError": "{string}",  "numMasters": "{integer}",  "numWorkers": "{integer}",  "privileged": "{integer}",  "appCatalogEnabled": "{integer}",  "projectId": "{string}",  "runtimeConfig": "{string}",  "etcdBackup": {   "isEtcdBackupEnabled": "{boolean}",   "intervalInMins": "{integer}",   "storageType": "{string}",   "storageProperties": {    "localPath": "{string}"   },   "taskStatus": "{string}",   "taskErrorDetail": "{string}"  },  "nodePoolUuid": "{string}",  "nodePoolName": "{string}",  "cloudProviderUuid": "{string}",  "cloudProviderName": "{string}",  "cloudProviderType": "{string}",  "cloudProperties": {   "region": "{string}",   "masterFlavor": "{string}",   "workerFlavor": "{string}",   "sshKey": "{string}",   "serviceFqdn": "{string}",   "ami": "{string}",   "domainId": "{string}",   "isPrivate": "{boolean}",   "usePf9Domain": "{string}",   "internalElb": "{boolean}",   "azs": [    "{array[string]...}"   ],   "httpProxy": "{string}",   "privateSubnets": [    "{array[string]...}"   ],   "subnets": [    "{array[string]...}"   ],   "vpc": "{string}",   "customAmi": "{string}"  },  "canUpgrade": "{boolean}",  "networkPlugin": "{string}",  "allowWorkloadsOnMaster": "{integer}",  "tags": {},  "k8sApiPort": "{string}",  "masterVipIpv4": "{string}",  "masterVipIface": "{string}",  "enableMetallb": "{boolean}",  "metallbCidr": "{string}",  "masterVipVrouterId": "{string}",  "calicoV4BlockSize": "{string}",  "calicoIpIpMode": "{string}",  "calicoNatOutgoing": "{boolean}",  "mtuSize": "{string}" }]
Copy

Expand

Creates a cluster using auto deploy or manual mode

Auth

Headers

X-Auth-Token string

Path Params

project_uuid

string

UUID of the project the cluster belongs to

Request Body

object	object
allowWorkloadsOnMaster	integer	Field is set to 1 if the master nodes can run non-critical workloads
ami	string	AMI ID used to provision cluster nodes
appCatalogEnabled	integer	Field is set to 1 if app catalog is enabled, 0 otherwise, applicable also for manual deploy
azs	array[string]	Availability zone(s) the cluster is deployed in
calicoV4BlockSize	string	Subnet size per node for the Calico network, in CIDR notation (e.g. 26)
calicoIpIpMode	string	IP-IP encapsulation mode for Calico network. Choose: Always, Never, CrossSubnet
calicoNatOutgoing	boolean	Field is set to true if Calico nodes need to NAT north-south egress traffic.
containersCidr	string	CIDR used for container IP addresses, applicable also for manual deploy
dockerLiveRestoreEnabled	boolean	Enables the use of Docker live restore as described here: https://docs.docker.com/config/containers/live-restore/
domainId	string	Domain used for cluster FQDNs
enableMetallb	boolean	If true, install MetalLB to support the loadbalancer service-type
enableCAS	boolean	If true, cluster autoscaling is enabled (only for AWS clusters).
etcdBackup	object
isEtcdBackupEnabled	boolean	Set to true if etcd backup should be enabled, false otherwise
intervalInMins	integer	etcd backup interval, specified in minutes
storageType	string	Storage type for the etcd backup. Only 'local' is current supported type. 'local' saves backup to the node's local disk
storageProperties	object
localPath	string	Path on the local filesystem where the etcd backup should be stored. For 'local' storage type only.
externalDnsName	string	Optional DNS name for API endpoint. This field is autogenerated when usePf9Domain is set, also applicable for manual deploy
httpProxy	string	The http proxy used for node communications. This parameter is required when internalElb is set to true and the private subnet selected does not route IP packets to the internet through a VPN
internalElb	boolean	Set to true if load balancer is an internal load balancer or false for an Internet-facing load balancer. More information here: https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-internal-load-balancers.html. Setting this parameter to true requires that isPrivate is set to true. If the private subnet selected is not configured to route IP packets through a VPN, then an httpProxy is required for node communications to work
isPrivate	boolean	Set to true if nodes are deployed using public subnet, false otherwise, applicable also for manual deploy. This parameter is required if internalElb is set to true.
k8sApiPort	string	Port on which K8S API Server will listen, 443 by default
masterFlavor	string	Node flavor used for master node
masterVipIpv4	string	API server Virtual IP that provides failover. When specified, deploy keepalived setup to cluster master nodes together
masterVipIface	string	If masterVipIpv4 is specified, this field is required. Specify the interface that the VIP attaches to
metallbCidr	string	If enableMetallb is true, specify the comma-separated pools of IPs that MetalLB will manage (for example: A.B.C.D-E.F.G.H, I.J.K.L-M.N.O.P)
mtuSize	string	MTU for container network interfaces. Optional and used for the Calico network backend
name	string	Name of the cluster, applicable also for manual deploy
networkPlugin	string	Network backend to use for container networking. Defaults to flannel. Supported choices are flannel, calico, noop, weave
nodePoolUuid	string	UUID of the node pool used for the cluster, applicable also for manual deploy
numMasters	integer	Number of master nodes in the cluster
numWorkers	integer	Number of worker nodes in the cluster
numMinWorkers	integer	This parameter is required if enableCAS is set to true. This is the minimum number of worker nodes in ASG
numMaxWorkers	integer	This parameter is required if enableCAS is set to true. This is the maximum number of worker nodes in ASG
privateSubnets	array[string]	The private subnet ID to which the cluster is deployed. This parameter is optional if vpc (VPC ID) is set. This parameter is required if vpc (VPC ID) is set and isPrivate is set to true. This parameter is ignored if vpc (VPC ID) is not set
privileged	boolean	Field is set to 1 if cluster runs privileged containers, 0 otherwise
region	string	Cloud provider region in which the cluster was created
runtimeConfig	string	Applicable also for manual deploy
serviceFqdn	string	FQDN used to reference cluster services
servicesCidr	string	CIDR used for service IP addresses, applicable also for manual deploy
sshKey	string	Public SSH key associated with the cluster nodes
subnets	array[string]
tags	object	User defined key-value pairs represented as a JSON object
usePf9Domain	boolean	Set to true if platform9.net domain is used, false otherwise
vpc	string	If set, creates cluster using this VPC ID. Otherwise, the cluster is deployed on a new VPC. This parameter is required if internalElb is set to true
workerFlavor	string	Node flavor used for worker node

Expand

POST /v3/{project_uuid}/clusters

xxxxxxxxxx
 
curl --request POST \ --url '/qbert/v3/%7Bproject_uuid%7D/clusters' \ --header 'X-Auth-Token: {X-Auth-Token}' \ --data '{  "allowWorkloadsOnMaster": "{integer}",  "ami": "{string}",  "appCatalogEnabled": "{integer}",  "azs": [    "{array[string]...}"  ],  "calicoV4BlockSize": "{string}",  "calicoIpIpMode": "{string}",  "calicoNatOutgoing": "{boolean}",  "containersCidr": "{string}",  "dockerLiveRestoreEnabled": "{boolean}",  "domainId": "{string}",  "enableMetallb": "{boolean}",  "enableCAS": "{boolean}",  "etcdBackup": {    "isEtcdBackupEnabled": "{boolean}",    "intervalInMins": "{integer}",    "storageType": "{string}",    "storageProperties": {      "localPath": "{string}"    }  },  "externalDnsName": "{string}",  "httpProxy": "{string}",  "internalElb": "{boolean}",  "isPrivate": "{boolean}",  "k8sApiPort": "{string}",  "masterFlavor": "{string}",  "masterVipIpv4": "{string}",  "masterVipIface": "{string}",  "metallbCidr": "{string}",  "mtuSize": "{string}",  "name": "{string}",  "networkPlugin": "{string}",  "nodePoolUuid": "{string}",  "numMasters": "{integer}",  "numWorkers": "{integer}",  "numMinWorkers": "{integer}",  "numMaxWorkers": "{integer}",  "privateSubnets": [    "{array[string]...}"  ],  "privileged": "{boolean}",  "region": "{string}",  "runtimeConfig": "{string}",  "serviceFqdn": "{string}",  "servicesCidr": "{string}",  "sshKey": "{string}",  "subnets": [    "{array[string]...}"  ],  "tags": {},  "usePf9Domain": "{boolean}",  "vpc": "{string}",  "workerFlavor": "{string}"}'
Copy

Expand

Responses

200

OK, if cluster create request was submitted successfully

No response body

403

Unauthorized to perform this operation

Response

xxxxxxxxxx
 
No example response
Copy

Get details of a cluster

Auth

Headers

X-Auth-Token string

Path Params

uuid	string	UUID of the cluster
project_uuid	string	UUID of the project the cluster belongs to

GET /v3/{project_uuid}/clusters/{uuid}

xxxxxxxxxx
 
curl --get \ --url '/qbert/v3/%7Bproject_uuid%7D/clusters/%7Buuid%7D' \ --header 'X-Auth-Token: {X-Auth-Token}'
Copy

Responses

200

object	object
name	string	Name of the cluster
uuid	string	UUID of the cluster
containersCidr	string	CIDR used for container IP addresses
servicesCidr	string	CIDR used for service IP addresses
isKubernetes	integer	Field is set to 1 if the cluster is a Kubernetes cluster, 0 otherwise
externalDnsName	string	Optional DNS name for API endpoint. This field is autogenerated when pf9 domain is used.
masterIp	string	Ip of the master node, applicable only for cloud provider type 'openstack'
status	string	Status of the cluster
masterStatus	string	Status of the master nodes. 'healthy' means all masters are healthy. 'partially healthy' means quorum number of masters are healthy, but some are not. 'unhealthy' means quorum number of master are unhealthy
workerStatus	string	Status of the worker nodes. 'healthy' means all workers are healthy. 'partially healthy' means more than 50% of the workers are healthy, rest are unhealthy. 'unhealthy' means more than 50% of the workers are unhealthy
flannelIfaceLabel	string	The interface used by flannel for interhost communication
flannelPublicIfaceLabel	string	The IP address used as the flannel public IP for the nodes in the cluster
dockerRoot	string	Root directory for docker
etcdDataDir	string	Data directory for etcd. The field is applicable to master nodes only
lastOp	string	The last operation such as node attach or node detach that was performed on the cluster
lastOk	string	The timestamp when the cluster last reported an OK status
keystoneEnabled	integer	Field is set to 1 if keystone is enabled, 0 otherwise
authzEnabled	integer	Field is set to 1 if authz is enabled, 0 otherwise
taskStatus	string	Status of the last task that run on the cluster.
taskError	string	Error details if the last task on cluster did not succeed
numMasters	integer	Number of master nodes in the cluster
numWorkers	integer	Number of worker nodes in the cluster
privileged	integer	Field is set to 1 if cluster runs privileged containers, 0 otherwise
appCatalogEnabled	integer	Field is set to 1 if app catalog is enabled, 0 otherwise
projectId	string	UUID of the Keystone project that this cluster is part of
runtimeConfig	string
etcdBackup	object
isEtcdBackupEnabled	boolean	Set to true if etcd backup should be enabled, false otherwise
intervalInMins	integer	etcd backup interval, specified in minutes
storageType	string	Storage type for the etcd backup. Only 'local' is current supported type. 'local' saves backup to the node's local disk
storageProperties	object
localPath	string	Path on the local filesystem where the etcd backup should be stored. For 'local' storage type only.
taskStatus	string	Status indicating whether the backup cron job on the Kubernetes cluster was successfully setup. Can be 'success' or 'error'
taskErrorDetail	string	Details of the error occurred of the taskStatus returned is 'error'
nodePoolUuid	string	UUID of the node pool used for the cluster
nodePoolName	string	Name of the node pool used for the cluster
cloudProviderUuid	string	UUID of the cloud provider used to create this cluster
cloudProviderName	string	Name of the cloud provider used to create this cluster
cloudProviderType	string	Type of the cloud provider used to create this cluster
cloudProperties	object
region	string	Cloud provider region in which the cluster was created
masterFlavor	string	Node flavor used for master node
workerFlavor	string	Node flavor used for worker node
sshKey	string	Public SSH key associated with the cluster nodes
serviceFqdn	string	FQDN used to reference cluster services
ami	string	AMI ID used to provision cluster nodes
domainId	string	Domain used for cluster FQDNs
isPrivate	boolean	Set to true if nodes are deployed using public subnet, false otherwise, applicable also for manual deploy. This parameter is required if internalElb is set to true.
usePf9Domain	string	Set to true if platform9.net domain is used, false otherwise
internalElb	boolean	Set to true if load balancer is an internal load balancer or false for an Internet-facing load balancer. More information here: https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-internal-load-balancers.html Setting this parameter to true requires that isPrivate is set to true. If the private subnet selected is not configured to route IP packets through a VPN, then an httpProxy is required for node communications to work
azs	array[string]	Availability zone(s) the cluster is deployed in
httpProxy	string	The http proxy used for node communications. This parameter is required when internalElb is set to true and the private subnet selected does not route IP packets to the internet through a VPN
privateSubnets	array[string]	The private subnet ID to which the cluster is deployed. This parameter is optional if vpc (VPC ID) is set. This parameter is required if vpc (VPC ID) is set and isPrivate is set to true. This parameter is ignored if vpc (VPC ID) is not set
subnets	array[string]
vpc	string	If set, creates cluster using this VPC ID. Otherwise, the cluster is deployed on a new VPC. This parameter is required if internalElb is set to true
customAmi	string	The custom ami name which can be specified by a user
canUpgrade	boolean	Field is set to true if the cluster can be upgraded, false otherwise
networkPlugin	string	Network backend to use for container networking. Defaults to flannel. Supported choices are flannel, calico, noop, weave
allowWorkloadsOnMaster	integer	Field is set to 1 if the master nodes can run non-critical workloads
tags	object	User defined key-value pairs represented as a JSON object
k8sApiPort	string	Port on which K8S API Server will listen, 443 by default
masterVipIpv4	string	API server Virtual IP that provides failover if specified for the cluster. Defaults to empty string
masterVipIface	string	The interface that VIP attaches to if specified. Defaults to empty string
enableMetallb	boolean	1 if metallb enabled. Defaults to 0
metallbCidr	string	Comma separated pools of IPs like A.B.C.D-E.F.G.H, I.J.K.L-M.N.O.P that metallb will manage if specified
masterVipVrouterId	string	Virtual router id choosen for the cluster. Range: 0-254. Emptry string if masterVipIpv4 not specified
calicoV4BlockSize	string	Subnet size per node for the Calico network, in CIDR notation (e.g. 26)
calicoIpIpMode	string	IP-IP encapsulation mode for Calico network. Choose: Always, Never, CrossSubnet
calicoNatOutgoing	boolean	Field is set to true if Calico nodes need to NAT north-south egress traffic.
mtuSize	string	MTU for container network interfaces. Optional and used for the Calico network backend

Expand

403

unauthorized to perform this operation

Response

xxxxxxxxxx
 
{ "name": "{string}", "uuid": "{string}", "containersCidr": "{string}", "servicesCidr": "{string}", "isKubernetes": "{integer}", "externalDnsName": "{string}", "masterIp": "{string}", "status": "{string}", "masterStatus": "{string}", "workerStatus": "{string}", "flannelIfaceLabel": "{string}", "flannelPublicIfaceLabel": "{string}", "dockerRoot": "{string}", "etcdDataDir": "{string}", "lastOp": "{string}", "lastOk": "{string}", "keystoneEnabled": "{integer}", "authzEnabled": "{integer}", "taskStatus": "{string}", "taskError": "{string}", "numMasters": "{integer}", "numWorkers": "{integer}", "privileged": "{integer}", "appCatalogEnabled": "{integer}", "projectId": "{string}", "runtimeConfig": "{string}", "etcdBackup": {  "isEtcdBackupEnabled": "{boolean}",  "intervalInMins": "{integer}",  "storageType": "{string}",  "storageProperties": {   "localPath": "{string}"  },  "taskStatus": "{string}",  "taskErrorDetail": "{string}" }, "nodePoolUuid": "{string}", "nodePoolName": "{string}", "cloudProviderUuid": "{string}", "cloudProviderName": "{string}", "cloudProviderType": "{string}", "cloudProperties": {  "region": "{string}",  "masterFlavor": "{string}",  "workerFlavor": "{string}",  "sshKey": "{string}",  "serviceFqdn": "{string}",  "ami": "{string}",  "domainId": "{string}",  "isPrivate": "{boolean}",  "usePf9Domain": "{string}",  "internalElb": "{boolean}",  "azs": [   "{array[string]...}"  ],  "httpProxy": "{string}",  "privateSubnets": [   "{array[string]...}"  ],  "subnets": [   "{array[string]...}"  ],  "vpc": "{string}",  "customAmi": "{string}" }, "canUpgrade": "{boolean}", "networkPlugin": "{string}", "allowWorkloadsOnMaster": "{integer}", "tags": {}, "k8sApiPort": "{string}", "masterVipIpv4": "{string}", "masterVipIface": "{string}", "enableMetallb": "{boolean}", "metallbCidr": "{string}", "masterVipVrouterId": "{string}", "calicoV4BlockSize": "{string}", "calicoIpIpMode": "{string}", "calicoNatOutgoing": "{boolean}", "mtuSize": "{string}"}
Copy

Expand

Update the properties of a cluster specified by the cluster_uuid

Auth

Headers

X-Auth-Token string

Path Params

uuid	string	UUID of the cluster
project_uuid	string	UUID of the project the cluster belongs to

Request Body

object	object
name	string	Name of the cluster
numWorkers	integer	Number of worker nodes in the cluster. For AWS cluster, this parameter is relevant only if cluster autoscaling is disabled
numMinWorkers	integer	Minimum number of worker nodes in ASG for AWS cluster. This parameter is relevant only if cluster autoscaling is enabled
numMaxWorkers	integer	Maximum number of worker nodes in ASG for AWS cluster. This parameter is relevant only if cluster autoscaling is enabled
etcdBackup	object
isEtcdBackupEnabled	boolean	Set to true if etcd backup should be enabled, false otherwise
intervalInMins	integer	etcd backup interval, specified in minutes
storageType	string	Storage type for the etcd backup. Only 'local' is current supported type. 'local' saves backup to the node's local disk
storageProperties	object
localPath	string	Path on the local filesystem where the etcd backup should be stored. For 'local' storage type only.
tags	object	User defined key-value pairs represented as a JSON object
customAmi	string	The custom ami name which can be specified by a user

PUT /v3/{project_uuid}/clusters/{uuid}

xxxxxxxxxx
 
curl --request PUT \ --url '/qbert/v3/%7Bproject_uuid%7D/clusters/%7Buuid%7D' \ --header 'X-Auth-Token: {X-Auth-Token}' \ --data '{  "name": "{string}",  "numWorkers": "{integer}",  "numMinWorkers": "{integer}",  "numMaxWorkers": "{integer}",  "etcdBackup": {    "isEtcdBackupEnabled": "{boolean}",    "intervalInMins": "{integer}",    "storageType": "{string}",    "storageProperties": {      "localPath": "{string}"    }  },  "tags": {},  "customAmi": "{string}"}'
Copy

Responses

200

OK, if cluster upgrade request was submitted successfully

No response body

403

Unauthorized to perform this operation

Response

xxxxxxxxxx
 
No example response
Copy

Delete a cluster from PMK as specified by the cluster UUID

Auth

Headers

X-Auth-Token string

Path Params

uuid	string	UUID of the cluster
project_uuid	string	UUID of the project the cluster belongs to

DELETE /v3/{project_uuid}/clusters/{uuid}

xxxxxxxxxx
 
curl --request DELETE \ --url '/qbert/v3/%7Bproject_uuid%7D/clusters/%7Buuid%7D' \ --header 'X-Auth-Token: {X-Auth-Token}'
Copy

Responses

200

OK, if cluster delete request was submitted successfully

No response body

403

Unauthorized to perform this operation

Response

xxxxxxxxxx
 
No example response
Copy

Get the kubeconfig blob for the specific cluster

Auth

Headers

X-Auth-Token string

Path Params

cluster_uuid	string	UUID of the cluster
project_uuid	string	UUID of the project the cluster belongs to

GET /v3/{project_uuid}/kubeconfig/{cluster_uuid}

xxxxxxxxxx
 
curl --get \ --url '/qbert/v3/%7Bproject_uuid%7D/kubeconfig/%7Bcluster_uuid%7D' \ --header 'X-Auth-Token: {X-Auth-Token}'
Copy

Responses

200

The response is a blob sent with the Content-Type ‘application/octet-stream’

No response body

403

Unauthorized to perform this operation

Response

xxxxxxxxxx
 
No example response
Copy

Generate token to be used by web cli

Auth

Headers

X-Auth-Token string

Path Params

uuid	string	UUID of the cluster
project_uuid	string	UUID of the project the cluster belongs to

POST /v3/{project_uuid}/webcli/{uuid}

xxxxxxxxxx
 
curl --request POST \ --url '/qbert/v3/%7Bproject_uuid%7D/webcli/%7Buuid%7D' \ --header 'X-Auth-Token: {X-Auth-Token}'
Copy

Responses

200

object	object
token	string	Web cli token

403

Unauthorized to perform this operation

Response

xxxxxxxxxx
 
{ "token": "{string}"}
Copy

Attach nodes to a cluster. In a manual deployed cluster, nodes can be added to a cluster using this API. If the cluster has no masters, multiple masters can be attached simultaneously.

Auth

Headers

X-Auth-Token string

Path Params

uuid	string	UUID of the cluster
project_uuid	string	UUID of the project the cluster belongs to

Request Body

array	array[object]
uuid	string	UUID of the node
isMaster	boolean	true if the node should be attached as master, false otherwise.

POST /v3/{project_uuid}/clusters/{uuid}/attach

xxxxxxxxxx
 
curl --request POST \ --url '/qbert/v3/%7Bproject_uuid%7D/clusters/%7Buuid%7D/attach' \ --header 'X-Auth-Token: {X-Auth-Token}' \ --data '[  {    "uuid": "{string}",    "isMaster": "{boolean}"  }]'
Copy

Responses

200

OK, if the node get attached to the cluster

No response body

403

Unauthorized to perform this operation

Response

xxxxxxxxxx
 
No example response
Copy

Detach nodes from a cluster. In a manual deployed cluster, nodes can be removed from a cluster using this API.

Auth

Headers

X-Auth-Token string

Path Params

uuid	string	UUID of the cluster
project_uuid	string	UUID of the project the cluster belongs to

Request Body

array	array[object]
uuid	string	UUID of the node
isMaster	boolean	true if the node should be attached as master, false otherwise.

POST /v3/{project_uuid}/clusters/{uuid}/detach

xxxxxxxxxx
 
curl --request POST \ --url '/qbert/v3/%7Bproject_uuid%7D/clusters/%7Buuid%7D/detach' \ --header 'X-Auth-Token: {X-Auth-Token}' \ --data '[  {    "uuid": "{string}",    "isMaster": "{boolean}"  }]'
Copy

Responses

200

OK, if the node get attached to the cluster

No response body

403

Unauthorized to perform this operation

Response

xxxxxxxxxx
 
No example response
Copy

Upgrade a cluster, identified by the uuid

Auth

Headers

X-Auth-Token string

Path Params

uuid	string	UUID of the cluster
project_uuid	string	UUID of the project the cloud provider account belongs to

Request Body

object	object
batchUpgradePercent	number	Number between 1-100 which represents the percent of worker nodes to upgrade in parallel at once during an upgrade

POST /v3/{project_uuid}/clusters/{uuid}/upgrade

xxxxxxxxxx
 
curl --request POST \ --url '/qbert/v3/%7Bproject_uuid%7D/clusters/%7Buuid%7D/upgrade' \ --header 'X-Auth-Token: {X-Auth-Token}' \ --data '{  "batchUpgradePercent": "{number}"}'
Copy

Responses

200

OK, if upgrade request is successfully issued

No response body

403

Unauthorized to perform this operation

Response

xxxxxxxxxx
 
No example response
Copy

Restart PMK service on all nodes in a cluster, identified by the uuid

Auth

Headers

X-Auth-Token string

Path Params

uuid	string	UUID of the cluster
project_uuid	string	UUID of the project the cloud provider account belongs to

POST /v3/{project_uuid}/clusters/{uuid}/restart

xxxxxxxxxx
 
curl --request POST \ --url '/qbert/v3/%7Bproject_uuid%7D/clusters/%7Buuid%7D/restart' \ --header 'X-Auth-Token: {X-Auth-Token}'
Copy

Responses

200

OK, if restart request is successfully issued

No response body

403

Unauthorized to perform this operation

Response

xxxxxxxxxx
 
No example response
Copy

Restart PMK service on all worker nodes in a cluster, identified by the uuid

Auth

Headers

X-Auth-Token string

Path Params

uuid	string	UUID of the cluster
project_uuid	string	UUID of the project the cloud provider account belongs to

POST /v3/{project_uuid}/clusters/{uuid}/restartWorkers

xxxxxxxxxx
 
curl --request POST \ --url '/qbert/v3/%7Bproject_uuid%7D/clusters/%7Buuid%7D/restartWorkers' \ --header 'X-Auth-Token: {X-Auth-Token}'
Copy

Responses

200

OK, if restart request is successfully issued

No response body

403

Unauthorized to perform this operation

Response

xxxxxxxxxx
 
No example response
Copy

Restart PMK service on all master nodes in a cluster, identified by the uuid

Auth

Headers

X-Auth-Token string

Path Params

uuid	string	UUID of the cluster
project_uuid	string	UUID of the project the cloud provider account belongs to

POST /v3/{project_uuid}/clusters/{uuid}/restartMasters

xxxxxxxxxx
 
curl --request POST \ --url '/qbert/v3/%7Bproject_uuid%7D/clusters/%7Buuid%7D/restartMasters' \ --header 'X-Auth-Token: {X-Auth-Token}'
Copy

Responses

200

OK, if restart request is successfully issued

No response body

403

Unauthorized to perform this operation

Response

xxxxxxxxxx
 
No example response
Copy

Get list of nodes on which PMK service is getting restarted

Auth

Headers

X-Auth-Token string

Path Params

project_uuid

string

UUID of the project the cloud provider account belongs to

GET /v3/{project_uuid}/currentRollingRestarts

xxxxxxxxxx
 
curl --get \ --url '/qbert/v3/%7Bproject_uuid%7D/currentRollingRestarts' \ --header 'X-Auth-Token: {X-Auth-Token}'
Copy

Responses

200

array	array[object]
name	string	UUID of the node
runState	boolean	True if the node is up

403

Unauthorized to perform this operation

Response

xxxxxxxxxx
 
[ {  "name": "{string}",  "runState": "{boolean}" }]
Copy

Node Pool

GET

/v3/{project_uuid}/nodePools

Get details of all node pools

Auth

Headers

X-Auth-Token string

Path Params

project_uuid

string

UUID of the project the node pool belongs to

GET /v3/{project_uuid}/nodePools

xxxxxxxxxx
 
curl --get \ --url '/qbert/v3/%7Bproject_uuid%7D/nodePools' \ --header 'X-Auth-Token: {X-Auth-Token}'
Copy

Responses

200

array	array[object]
name	string	Name of the node pool
uuid	string	UUID of the node pool
cloudProviderUuid	string	UUID of the associated cloud provider
cloudProviderName	string	Name of the associated cloud provider

403

unauthorized to perform this operation

Response

xxxxxxxxxx
 
[ {  "name": "{string}",  "uuid": "{string}",  "cloudProviderUuid": "{string}",  "cloudProviderName": "{string}" }]
Copy

Platform9 Managed Kubernetes 3.0.0

Node

List all the nodes in a project identified by the project UUID

Get details of a specific node in project, identified by the UUID

Updates the properties of the node specified by the node UUID

Cloud Provider

Get the list of the cloud provider accounts currently setup in a project identified by project UUID

Add a cloud provider account

Get all available cloud provider types, in a project identified by project UUID

Get the details for cloud provider account identified by the account_uuid

Delete a cloud provider account specified by account uuid

Get the details for a region in a particular cloud provider account identified by the account_uuid

Add ssh key to a cloud provider region

Update a cloud provider account specified by account uuid

Cluster

Get the list of clusters currently setup in PMK

Creates a cluster using auto deploy or manual mode

Get details of a cluster

Update the properties of a cluster specified by the cluster_uuid

Delete a cluster from PMK as specified by the cluster UUID

Get the kubeconfig blob for the specific cluster

Generate token to be used by web cli

Attach nodes to a cluster. In a manual deployed cluster, nodes can be added to a cluster using this API. If the cluster has no masters, multiple masters can be attached simultaneously.

Detach nodes from a cluster. In a manual deployed cluster, nodes can be removed from a cluster using this API.

Upgrade a cluster, identified by the uuid

Restart PMK service on all nodes in a cluster, identified by the uuid

Restart PMK service on all worker nodes in a cluster, identified by the uuid

Restart PMK service on all master nodes in a cluster, identified by the uuid

Get list of nodes on which PMK service is getting restarted

Node Pool

Get details of all node pools