Connect a cluster
Connects a Kubernetes cluster from its kubeconfig. Kapten then installs its agent on the cluster.
/clusterAuthorizationBearer token (JWT) · headerrequiredJWT token passed in the Authorization header using the Bearer <token> format.
application/jsonnamestringrequiredThe name of the cluster.
cloud_providercloud_providerrequiredThe cloud provider for the cluster.
customawsgcpkube_configstringrequiredThe base64-encoded Kubernetes configuration for the cluster.
Cluster created successfully
iduuidrequiredA universally unique identifier (UUID) string
organization_iduuidrequiredA universally unique identifier (UUID) string
namestringrequiredThe name of the cluster.
cloud_providercloud_providerrequiredThe cloud provider for the cluster.
customawsgcpstatecluster_staterequiredThe current lifecycle state of the cluster.
UNKOWNREADYDEPLOYEDDEPLOYINGDEPLOY_QUEUEDDEPLOY_ERRORINITIALIZINGINITIALIZEDINITIALIZE_QUEUEDINITIALIZE_ERRORSTOPEDSTOPINGSTOP_QUEUEDSTOP_ERRORRESTARTRESTARTINGRESTART_QUEUEDRESTART_ERRORcreated_atstring<date-time>requiredThe timestamp when the cluster was created.
update_atstring<date-time>requiredThe timestamp when the cluster was last updated.
deleted_atstring<date-time> | nullrequiredThe timestamp when the cluster was deleted updated.
Error
codeinteger<int32>requiredmessagestringrequiredreasonstringOptional stable machine-readable reason for programmatic error handling