Introducing Kubernetes API Version v1beta3

Thursday, April 16, 2015

We've been hard at work on cleaning up the API over the past several months (see

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:

To aid the transition, we've also created a conversion .

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}

The names of all resource collections are now lower cased - instead of replicationControllers, usereplicationcontrollers.

To watch for changes to a resource, open an HTTP or Websocket connection to the collection URL and provide the?watch=true URL parameter along with the desired resourceVersion parameter to watch from.

The container entrypoint has been renamed to command, and command has been renamed to args.