Introducing Kubernetes API Version v1beta3

--- title: " Introducing Kubernetes API Version v1beta3 " date: 2015-04-16 slug: introducing-kubernetes-v1beta3 url: /blog/2015/04/Introducing-Kubernetes-V1Beta3 --- We've been hard at work on cleaning up the API over the past several months (see [https://github.com/GoogleCloudPlatform/kubernetes/issues/1519](https://github.com/GoogleCloudPlatform/kubernetes/issues/1519) for details). The result is v1beta3, which is considered to be the release candidate for the v1 API. We would like you to move to this new API version as soon as possible. v1beta1 and v1beta2 are deprecated, and will be removed by the end of June, shortly after we introduce the v1 API. As of the latest release, v0.15.0, v1beta3 is the primary, default API. We have changed the default kubectl and client API versions as well as the default storage version (which means objects persisted in etcd will be converted from v1beta1 to v1beta3 as they are rewritten).  You can take a look at v1beta3 examples such as: [https://github.com/GoogleCloudPlatform/kubernetes/tree/master/examples/guestbook/v1beta3](https://github.com/GoogleCloudPlatform/kubernetes/tree/master/examples/guestbook/v1beta3) [https://github.com/GoogleCloudPlatform/kubernetes/tree/master/examples/walkthrough/v1beta3](https://github.com/GoogleCloudPlatform/kubernetes/tree/master/examples/walkthrough/v1beta3) [https://github.com/GoogleCloudPlatform/kubernetes/tree/master/examples/update-demo/v1beta3](https://github.com/GoogleCloudPlatform/kubernetes/tree/master/examples/update-demo/v1beta3) To aid the transition, we've also created a conversion [tool](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/cluster_management.md#switching-your-config-files-to-a-new-api-version) and put together a list of important [different API changes](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/api.md#v1beta3-conversion-tips). - The resource `id` is now called `name`. - `name`, `labels`, `annotations`, and other metadata are now nested in a map called `metadata` - `desiredState` is now called `spec`, and `currentState` is now called `status` - `/minions` has been moved to `/nodes`, and the resource has kind `Node` - The namespace is required (for all namespaced resources) and has moved from a URL parameter to the path:`/api/v1beta3/namespaces/{namespace}/{resource_collection}/{resource_name}`

Kubernetes API version v1beta3 is being introduced as the release candidate for the v1 API. The older versions v1beta1 and v1beta2 are deprecated and will be removed by the end of June. v1beta3 is the primary, default API, with changes to kubectl, client API versions, and the default storage version. A conversion tool and a list of API changes are provided to aid the transition.