Skip to content

Commit 9eb3006

Browse files
committed
describe generateName in concepts page
1 parent e2db2d7 commit 9eb3006

File tree

1 file changed

+6
-0
lines changed
  • content/en/docs/concepts/overview/working-with-objects

1 file changed

+6
-0
lines changed

content/en/docs/concepts/overview/working-with-objects/names.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,12 @@ of the same resource. API resources are distinguished by their API group, resour
3232
In cases when objects represent a physical entity, like a Node representing a physical host, when the host is re-created under the same name without deleting and re-creating the Node, Kubernetes treats the new host as the old one, which may lead to inconsistencies.
3333
{{< /note >}}
3434

35+
The server may generate a name when `generateName` is provided in a resource create request instead of `name`.
36+
When `generateName` is used, the provided value is used as a name prefix, which server appends a generated suffix
37+
to. Even though the name is generated, it may conflict with existing names resulting in a HTTP 409 resopnse. This
38+
became far less likely to happen in Kubernetes v1.31 and later, since the server will make up to 8 attempt to generate a
39+
unique name before returning a HTTP 409 response.
40+
3541
Below are four types of commonly used name constraints for resources.
3642

3743
### DNS Subdomain Names

0 commit comments

Comments
 (0)