All objects in the REST API are unambiguously identified by a Name and UID. All non-unique user-generated attributes are stored within labels and annotations.

For precise Name and UID syntax rules, consult the identifiers design doc


Names are a client-provided, human-readable string that refers to an object in a resource URL (i.e. /api/v1/pods/some-name ). Only one object of a given Kind can have a given name at a time. If you delete the object, you can recreate a new object with that name. Kubernetes resource names should consist of lower case alphanumeric characters, - and . , up to 253 characters in length. Note that certain resources may have more specific restrictions.


The UID field is a generated string responsible for uniquely identifying objects in the system. Every object created during the lifetime of a Kubernetes cluster has a distinct UID. It is intended to differentiate between historical occurrences of similar entries.

Did this answer your question?