# kubernetes-api ## Pages - [Kubernetes API](https://docs.ezghcloud.com/kubernetes-api/index.md) — Managed Kubernetes: clusters whose control planes EZGH runs, node groups of your own instances, managed add-ons, access entries that map EZGH principals into the cluster, and pod identity associations. Every path is under an organization; lists are paged with limit, cursor and nextCursor. - [Cancel an operation](https://docs.ezghcloud.com/kubernetes-api/CancelOperation/index.md) — 409 operation_finished or operation_not_cancellable when it can't be cancelled. - [Create an access entry](https://docs.ezghcloud.com/kubernetes-api/CreateAccessEntry/index.md) — Synchronous. - [Create an add-on](https://docs.ezghcloud.com/kubernetes-api/CreateAddon/index.md) — Asynchronous: answers 202 with the operation that creates it. - [Create a cluster](https://docs.ezghcloud.com/kubernetes-api/CreateCluster/index.md) — Asynchronous: answers 202 with the operation that creates it. - [Get a token for kubectl](https://docs.ezghcloud.com/kubernetes-api/CreateClusterToken/index.md) — Synchronous. A cluster token valid 15 minutes, for kubectl's exec credential plugin (ezgh kubernetes token). Needs kubernetes.clusters.accessKubernetesApi on the cluster; each kubectl request is checked again. 409 cluster_not_active while the cluster is being created or deleted. - [Create a node group](https://docs.ezghcloud.com/kubernetes-api/CreateNodeGroup/index.md) — Asynchronous: answers 202 with the operation that creates it. - [Create a pod identity association](https://docs.ezghcloud.com/kubernetes-api/CreatePodIdentityAssociation/index.md) — Synchronous. - [Delete an access entry](https://docs.ezghcloud.com/kubernetes-api/DeleteAccessEntry/index.md) — Synchronous. - [Delete an add-on](https://docs.ezghcloud.com/kubernetes-api/DeleteAddon/index.md) — Asynchronous: answers 202 with the operation that deletes it. - [Delete a cluster](https://docs.ezghcloud.com/kubernetes-api/DeleteCluster/index.md) — Asynchronous: answers 202 with the operation that deletes it. 409 cluster_has_node_groups while it has node groups. - [Delete a node group](https://docs.ezghcloud.com/kubernetes-api/DeleteNodeGroup/index.md) — Asynchronous: answers 202 with the operation that deletes it. - [Delete a pod identity association](https://docs.ezghcloud.com/kubernetes-api/DeletePodIdentityAssociation/index.md) — Synchronous. - [Get an access entry](https://docs.ezghcloud.com/kubernetes-api/GetAccessEntry/index.md) - [Get an add-on](https://docs.ezghcloud.com/kubernetes-api/GetAddon/index.md) - [Get a cluster](https://docs.ezghcloud.com/kubernetes-api/GetCluster/index.md) - [Get a node group](https://docs.ezghcloud.com/kubernetes-api/GetNodeGroup/index.md) - [Get an operation (poll it until it finishes)](https://docs.ezghcloud.com/kubernetes-api/GetOperation/index.md) — While it's queued or running, Retry-After suggests when to poll again. Not recorded in Trails. - [Get a pod identity association](https://docs.ezghcloud.com/kubernetes-api/GetPodIdentityAssociation/index.md) - [List access entries](https://docs.ezghcloud.com/kubernetes-api/ListAccessEntries/index.md) - [List add-ons](https://docs.ezghcloud.com/kubernetes-api/ListAddons/index.md) - [List a cluster's events, newest first](https://docs.ezghcloud.com/kubernetes-api/ListClusterEvents/index.md) - [List clusters](https://docs.ezghcloud.com/kubernetes-api/ListClusters/index.md) - [List node groups](https://docs.ezghcloud.com/kubernetes-api/ListNodeGroups/index.md) - [List the organization's operations, newest first](https://docs.ezghcloud.com/kubernetes-api/ListOperations/index.md) - [List pod identity associations](https://docs.ezghcloud.com/kubernetes-api/ListPodIdentityAssociations/index.md) - [Change an access entry](https://docs.ezghcloud.com/kubernetes-api/UpdateAccessEntry/index.md) — Synchronous. Every field is optional. - [Change an add-on](https://docs.ezghcloud.com/kubernetes-api/UpdateAddon/index.md) — Asynchronous: answers 202 with the operation that changes it. Every field is optional. - [Change a cluster](https://docs.ezghcloud.com/kubernetes-api/UpdateCluster/index.md) — Asynchronous: answers 202 with the operation that changes it. Every field is optional. - [Change a node group](https://docs.ezghcloud.com/kubernetes-api/UpdateNodeGroup/index.md) — Asynchronous: answers 202 with the operation that changes it. Every field is optional. - [Change a pod identity association](https://docs.ezghcloud.com/kubernetes-api/UpdatePodIdentityAssociation/index.md) — Synchronous. Every field is optional. - [AccessEntry](https://docs.ezghcloud.com/kubernetes-api/schemas/AccessEntry/index.md) — An access entry: an EZGH principal's identity in a cluster. - [AccessEntryCreate](https://docs.ezghcloud.com/kubernetes-api/schemas/AccessEntryCreate/index.md) - [AccessEntryList](https://docs.ezghcloud.com/kubernetes-api/schemas/AccessEntryList/index.md) - [AccessEntryUpdate](https://docs.ezghcloud.com/kubernetes-api/schemas/AccessEntryUpdate/index.md) — Every field is optional, and only the ones given change. - [Addon](https://docs.ezghcloud.com/kubernetes-api/schemas/Addon/index.md) — A managed add-on in a cluster. - [AddonCreate](https://docs.ezghcloud.com/kubernetes-api/schemas/AddonCreate/index.md) - [AddonList](https://docs.ezghcloud.com/kubernetes-api/schemas/AddonList/index.md) - [AddonUpdate](https://docs.ezghcloud.com/kubernetes-api/schemas/AddonUpdate/index.md) — Every field is optional, and only the ones given change. - [Cluster](https://docs.ezghcloud.com/kubernetes-api/schemas/Cluster/index.md) — A Kubernetes cluster. - [ClusterCreate](https://docs.ezghcloud.com/kubernetes-api/schemas/ClusterCreate/index.md) - [ClusterEvent](https://docs.ezghcloud.com/kubernetes-api/schemas/ClusterEvent/index.md) - [ClusterEventList](https://docs.ezghcloud.com/kubernetes-api/schemas/ClusterEventList/index.md) - [ClusterList](https://docs.ezghcloud.com/kubernetes-api/schemas/ClusterList/index.md) - [ClusterToken](https://docs.ezghcloud.com/kubernetes-api/schemas/ClusterToken/index.md) - [ClusterUpdate](https://docs.ezghcloud.com/kubernetes-api/schemas/ClusterUpdate/index.md) — Every field is optional, and only the ones given change. - [Error](https://docs.ezghcloud.com/kubernetes-api/schemas/Error/index.md) — Every non-2xx answer. Clients branch on code, never on message. - [NodeGroup](https://docs.ezghcloud.com/kubernetes-api/schemas/NodeGroup/index.md) — A node group: a cluster's nodes, on one autoscaling group. - [NodeGroupCreate](https://docs.ezghcloud.com/kubernetes-api/schemas/NodeGroupCreate/index.md) - [NodeGroupList](https://docs.ezghcloud.com/kubernetes-api/schemas/NodeGroupList/index.md) - [NodeGroupUpdate](https://docs.ezghcloud.com/kubernetes-api/schemas/NodeGroupUpdate/index.md) — Every field is optional, and only the ones given change. - [Operation](https://docs.ezghcloud.com/kubernetes-api/schemas/Operation/index.md) - [OperationList](https://docs.ezghcloud.com/kubernetes-api/schemas/OperationList/index.md) - [OperationStatus](https://docs.ezghcloud.com/kubernetes-api/schemas/OperationStatus/index.md) - [PodIdentityAssociation](https://docs.ezghcloud.com/kubernetes-api/schemas/PodIdentityAssociation/index.md) — A pod identity association: a service account's pods get keys for a Bot. - [PodIdentityAssociationCreate](https://docs.ezghcloud.com/kubernetes-api/schemas/PodIdentityAssociationCreate/index.md) - [PodIdentityAssociationList](https://docs.ezghcloud.com/kubernetes-api/schemas/PodIdentityAssociationList/index.md) - [PodIdentityAssociationUpdate](https://docs.ezghcloud.com/kubernetes-api/schemas/PodIdentityAssociationUpdate/index.md) — Every field is optional, and only the ones given change. - [QuotaExceeded](https://docs.ezghcloud.com/kubernetes-api/schemas/QuotaExceeded/index.md) — quota_exceeded: the quota that refused the request. Never with Retry-After. - [Tags](https://docs.ezghcloud.com/kubernetes-api/schemas/Tags/index.md) — At most 50; keys 1-128 characters, values at most 256, keys starting with ezgh: are reserved.