<p>An object definition in Kubernetes requires an <code>apiVersion</code> field. When Kubernetes has a release that updates what is available for you to use—changes something in its API—a new <code>apiVersion</code> is created.</p>
<p>However, the official Kubernetes documentation provides little guidance on <code>apiVersion</code>. This guide gives you a cheat sheet on which version to use, explains each version, and gives you the timeline of releases.</p>
<div class="hn-table">
<table>
<thead>
<tr>
<td>Kind</td><td><code>apiVersion</code></td></tr>
</thead>
<tbody>
<tr>
<td>Service</td><td>v1</td></tr>
<tr>
<td>StatefulSet</td><td>apps/v</td></tr>
<tr>
<td>ClusterRole</td><td><a target="_blank" href="http://rbac.authorization.k8s.io/v1">rbac.authorization.k8s.io/v1</a></td></tr>
<tr>
<td>ComponentStatus</td><td>v1</td></tr>
<tr>
<td>ConfigMap</td><td>v1</td></tr>
<tr>
<td>ControllerRevision</td><td>apps/v1</td></tr>
<tr>
<td>CronJob</td><td>batch/v1beta1</td></tr>
<tr>
<td>DaemonSet</td><td>extensions/v1beta1</td></tr>
<tr>
<td>Deployment</td><td>extensions/v1beta1</td></tr>
<tr>
<td>Endpoints</td><td>v1</td></tr>
<tr>
<td>Event</td><td>v1</td></tr>
<tr>
<td>HorizontalPodAutoscaler</td><td>autoscaling/v1</td></tr>
<tr>
<td>Ingress</td><td>extensions/v1beta1</td></tr>
<tr>
<td>Job</td><td>batch/v1</td></tr>
<tr>
<td>LimitRange</td><td>v1</td></tr>
<tr>
<td>Namespace</td><td>v1</td></tr>
<tr>
<td>NetworkPolicy</td><td>extensions/v1beta1</td></tr>
<tr>
<td>Node</td><td>v1</td></tr>
<tr>
<td>PersistentVolumeClaim</td><td>v1</td></tr>
<tr>
<td>PersistentVolume</td><td>v1</td></tr>
<tr>
<td>PodDisruptionBudget</td><td>policy/v1beta1</td></tr>
<tr>
<td>Pod</td><td>v1</td></tr>
<tr>
<td>PodSecurityPolicy</td><td>extensions/v1beta1</td></tr>
<tr>
<td>PodTemplate</td><td>v1</td></tr>
<tr>
<td>ReplicaSet</td><td>extensions/v1beta1</td></tr>
<tr>
<td>ReplicationController</td><td>v1</td></tr>
<tr>
<td>ResourceQuota</td><td>v1</td></tr>
<tr>
<td>RoleBinding</td><td><a target="_blank" href="http://rbac.authorization.k8s.io/v1">rbac.authorization.k8s.io/v1</a></td></tr>
<tr>
<td>Role</td><td><a target="_blank" href="http://rbac.authorization.k8s.io/v1">rbac.authorization.k8s.io/v1</a></td></tr>
<tr>
<td>Secret</td><td>v1</td></tr>
<tr>
<td>ServiceAccount</td><td>v1</td></tr>
<tr>
<td>CertificateSigningRequest</td><td><a target="_blank" href="http://certificates.k8s.io/v1beta1">certificates.k8s.io/v1beta1</a></td></tr>
<tr>
<td>ClusterRoleBinding</td><td><a target="_blank" href="http://rbac.authorization.k8s.io/v1">rbac.authorization.k8s.io/v1</a></td></tr>
</tbody>
</table>
</div>

An object definition in Kubernetes requires an `apiVersion` field. When Kubernetes has a release that updates what is available for you to use—changes something in its API—a new `apiVersion` is created.

However, the official Kubernetes documentation provides little guidance on `apiVersion`. This guide gives you a cheat sheet on which version to use, explains each version, and gives you the timeline of releases.

| Kind | `apiVersion` |
| --- | --- |
| Service | v1 |
| StatefulSet | apps/v |
| ClusterRole | [rbac.authorization.k8s.io/v1](http://rbac.authorization.k8s.io/v1) |
| ComponentStatus | v1 |
| ConfigMap | v1 |
| ControllerRevision | apps/v1 |
| CronJob | batch/v1beta1 |
| DaemonSet | extensions/v1beta1 |
| Deployment | extensions/v1beta1 |
| Endpoints | v1 |
| Event | v1 |
| HorizontalPodAutoscaler | autoscaling/v1 |
| Ingress | extensions/v1beta1 |
| Job | batch/v1 |
| LimitRange | v1 |
| Namespace | v1 |
| NetworkPolicy | extensions/v1beta1 |
| Node | v1 |
| PersistentVolumeClaim | v1 |
| PersistentVolume | v1 |
| PodDisruptionBudget | policy/v1beta1 |
| Pod | v1 |
| PodSecurityPolicy | extensions/v1beta1 |
| PodTemplate | v1 |
| ReplicaSet | extensions/v1beta1 |
| ReplicationController | v1 |
| ResourceQuota | v1 |
| RoleBinding | [rbac.authorization.k8s.io/v1](http://rbac.authorization.k8s.io/v1) |
| Role | [rbac.authorization.k8s.io/v1](http://rbac.authorization.k8s.io/v1) |
| Secret | v1 |
| ServiceAccount | v1 |
| CertificateSigningRequest | [certificates.k8s.io/v1beta1](http://certificates.k8s.io/v1beta1) |
| ClusterRoleBinding | [rbac.authorization.k8s.io/v1](http://rbac.authorization.k8s.io/v1) |

Kind	`apiVersion`
Service	v1
StatefulSet	apps/v
ClusterRole	rbac.authorization.k8s.io/v1
ComponentStatus	v1
ConfigMap	v1
ControllerRevision	apps/v1
CronJob	batch/v1beta1
DaemonSet	extensions/v1beta1
Deployment	extensions/v1beta1
Endpoints	v1
Event	v1
HorizontalPodAutoscaler	autoscaling/v1
Ingress	extensions/v1beta1
Job	batch/v1
LimitRange	v1
Namespace	v1
NetworkPolicy	extensions/v1beta1
Node	v1
PersistentVolumeClaim	v1
PersistentVolume	v1
PodDisruptionBudget	policy/v1beta1
Pod	v1
PodSecurityPolicy	extensions/v1beta1
PodTemplate	v1
ReplicaSet	extensions/v1beta1
ReplicationController	v1
ResourceQuota	v1
RoleBinding	rbac.authorization.k8s.io/v1
Role	rbac.authorization.k8s.io/v1
Secret	v1
ServiceAccount	v1
CertificateSigningRequest	certificates.k8s.io/v1beta1
ClusterRoleBinding	rbac.authorization.k8s.io/v1

Which Kubernetes apiVersion Should I Use?