whentimeslows/website
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Name and UID glossary terms (#6606)

Browse Source 
* add name glossary term

* add uid glossary term

* use glossary terms in doc

* Update uid.yaml

* Update name.yaml
This commit is contained in:
Tony Li
2018-01-14 13:35:41 -05:00
committed by Zach Corleissen
parent 01d2be3d17
commit 70ee927cbd
3 changed files with 26 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/concepts/overview/working-with-objects/names.md
+6 -2
View File
@@ -9,10 +9,14 @@ All objects in the Kubernetes REST API are unambiguously identified by a Name an
For non-unique user-provided attributes, Kubernetes provides [labels](/docs/user-guide/labels) and [annotations](/docs/concepts/overview/working-with-objects/annotations/).
See the [identifiers design doc](https://git.k8s.io/community/contributors/design-proposals/architecture/identifiers.md) for the precise syntax rules for Names and UIDs.
## Names
Names are generally client-provided. Only one object of a given kind can have a given name at a time (i.e., they are spatially unique). But if you delete an object, you can make a new object with the same name. Names are used to refer to an object in a resource URL, such as `/api/v1/pods/some-name`. By convention, the names of Kubernetes resources should be up to maximum length of 253 characters and consist of lower case alphanumeric characters, `-`, and `.`, but certain resources have more specific restrictions. See the [identifiers design doc](https://git.k8s.io/community/contributors/design-proposals/architecture/identifiers.md) for the precise syntax rules for names.
{% glossary_definition term_id="name" length="all" %}
By convention, the names of Kubernetes resources should be up to maximum length of 253 characters and consist of lower case alphanumeric characters, `-`, and `.`, but certain resources have more specific restrictions.
## UIDs
UIDs are generated by Kubernetes. Every object created over the whole lifetime of a Kubernetes cluster has a distinct UID (i.e., they are spatially and temporally unique).
{% glossary_definition term_id="uid" length="all" %}