Kubernetes API
The Kubernetes API is the programmatic interface through which clients and components define, query, modify, and manage Kubernetes resources and cluster state.
Kubernetes in Action, Second Edition
The Kubernetes API is the programmatic interface through which clients and applications query and modify Kubernetes resources and cluster state.
- How it is used
- Provides the interface through which users and Kubernetes components configure a cluster by manipulating objects.
- How deep it goes
- Defines REST operations and the resource–object distinction, then traces manifest submission through control-plane components and status reporting.
- Examples
- Uses `kubectl cluster-info`, `kubectl get nodes`, and a YAML Pod manifest to make API interaction concrete.
- What you can do after
- Apply it via kubectl to inspect cluster objects and prepare a Pod manifest for creation through the API.
Read how Kubernetes in Action, Second Edition explains Kubernetes API →
Developer Experience on Kubernetes
The Kubernetes API is the programmatic interface through which clients create, inspect, modify, and delete Kubernetes objects and resources.
- How it is used
- Supports deploying containerized applications to clusters through manifests and kubectl during the Kubernetes inner loop.
- How deep it goes
- Works through manifests, resource roles, and kubectl commands rather than API internals.
- Examples
- Uses an appointments service with PostgreSQL, a Deployment manifest, a kind cluster, and kubectl apply, get, and delete commands.
- What you can do after
- Apply it via kubectl to create, inspect, update, and remove application resources from YAML manifests.
Read how Developer Experience on Kubernetes explains Kubernetes API →
Acing the Certified Kubernetes Administrator Exam, Second Edition
The Kubernetes API is the interface through which Kubernetes resources and cluster operations are represented and accessed.
- How it is used
- Serves as the entry point for cluster communication and resource operations performed by users, tools, and components.
- How deep it goes
- Explains resource URIs, REST methods, the API server, and access control, without detailing request processing internals.
- Examples
- Uses a JSON resource request as an analogy and a YAML Pod manifest created with kubectl.
- What you can do after
- Apply it via kubectl to create a Pod from a manifest and inspect pods, while considering API permissions.
Read how Acing the Certified Kubernetes Administrator Exam, Second Edition explains Kubernetes API →
Platform Engineering on Kubernetes
The Kubernetes API is the programmatic interface through which Kubernetes resources and cluster behavior are defined and managed.
- How it is used
- Enables platform teams to compose Kubernetes building blocks into developer-facing platforms and cloud-native workflows.
- How deep it goes
- Explains the API’s platform role, conventions, and architectural tradeoffs, but does not provide implementation code or endpoint details.
- Examples
- Uses platform clusters, workload clusters, management tools, and organization-specific APIs as architectural examples.
- What you can do after
- Apply it to design platform APIs that reuse Kubernetes conventions or deliberately complement them with company-specific interfaces.
Read how Platform Engineering on Kubernetes explains Kubernetes API →
Learn Docker in a Month of Lunches, Second Edition
The Kubernetes API is the standardized interface for declaring, querying, and managing Kubernetes resources and application models.
- How it is used
- Models complete applications declaratively and sends them to Kubernetes clusters through kubectl.
- How deep it goes
- Defines four high-level application layers and portability, but defers detailed API mastery and production modeling.
- Examples
- Uses YAML application models, Docker Desktop Kubernetes, kubectl contexts, and node listings.
- What you can do after
- Operate Kubernetes applications by modeling them in YAML and sending those models through kubectl.
Read how Learn Docker in a Month of Lunches, Second Edition explains Kubernetes API →
Effective Platform Engineering
The Kubernetes API is the interface through which clients and components manage Kubernetes resources and cluster state.
- How it is used
- Extends Kubernetes orchestration into a general platform control plane for managing resources and infrastructure.
- How deep it goes
- Explains control-plane extension, desired-state correction, and team-based access, but stops short of implementation details.
- Examples
- Uses failing-service redeployment, team-authorized resources, and GitHub-integrated identity-provider access as concrete examples.
- What you can do after
- Apply it to extend Kubernetes orchestration and authorize teams to provision platform infrastructure through consistent APIs.
Read how Effective Platform Engineering explains Kubernetes API →
Cloud Observability in Action
The Kubernetes API is the programmatic interface for querying and changing the state of Kubernetes resources.
- How it is used
- Uses the Kubernetes API to query and change cluster-resource state while exposing control-plane observability signals.
- How deep it goes
- Defines resource-state management and signal sources, then demonstrates raw metrics, but defers comprehensive telemetry collection and processing.
- Examples
- Demonstrates kubectl raw metrics, API-server admission latency, and control-plane system logs.
- What you can do after
- Diagnose API-server behavior by querying exposed metrics and relating them to control-plane observability signals.
Read how Cloud Observability in Action explains Kubernetes API →
Also covered in
- Automating API Delivery
- Kargo in ActionIn early access (MEAP)
- Bootstrapping Microservices, Second Edition: With Docker, Kubernetes, GitHub Actions, and Terraform
- Designing Deep Learning Systems: A guide for software engineers
- Akka in Action, Second Edition
- Kubernetes for Developers
What to know first
- containerA software container is an isolated execution environment that packages an application and its dependencies, typically sharing the host operating-system kernel.
- cloud providerA cloud provider is an organization or service operator that supplies remotely accessible computing resources or services over a network, often on demand.
- YAMLYAML is a human-readable data serialization standard for representing structured data, commonly using indentation to express mappings and sequences.
- distributed systemA distributed system is a computing system whose components run across multiple networked processes or machines and coordinate through communication.
Related concepts
- kubectlused by · kubectl is the Kubernetes command-line client for communicating with the Kubernetes API and managing cluster resources.
- Kubernetespart of · Kubernetes is an open-source platform for orchestrating containerized workloads and automating their deployment, scaling, and management.
- cloud computingused by · Cloud computing is a model for on-demand network access to shared computing resources and services that can be provisioned and scaled as needed.
- Helmused by · Helm is a Kubernetes package manager and templating tool that defines, packages, installs, upgrades, and manages applications through charts.
- Kubernetes manifestused by · A Kubernetes manifest is a declarative configuration document, typically written in YAML or JSON, that specifies Kubernetes resources and their desired state.
Questions about Kubernetes API
What is Kubernetes API?
The Kubernetes API is the programmatic interface through which clients and components define, query, modify, and manage Kubernetes resources and cluster state.
Which Manning books explain Kubernetes API?
Kubernetes in Action, Second Edition, Developer Experience on Kubernetes, Acing the Certified Kubernetes Administrator Exam, Second Edition, Platform Engineering on Kubernetes, Learn Docker in a Month of Lunches, Second Edition, Effective Platform Engineering and Cloud Observability in Action.
What should I know before learning Kubernetes API?
Manning books that teach Kubernetes API usually introduce container, cloud provider, YAML and distributed system first.
What is Kubernetes API part of?
Kubernetes API is part of Kubernetes. Kubernetes is an open-source platform for orchestrating containerized workloads and automating their deployment, scaling, and management.
These guides are generated from the text of Manning books by Manning's knowledge graph and link to the sections they draw on. The full books are available on liveBook and at manning.com.






