Skip to content

Commit dd2f21c

Browse files
sanposhihok8s-publishing-bot
authored andcommitted
fix the doc about generateName conflict
Kubernetes-commit: 0865b9eca3f36ecb1fe9664c77d5017ca3c79b29
1 parent 3b8fb46 commit dd2f21c

File tree

3 files changed

+3
-9
lines changed

3 files changed

+3
-9
lines changed

Diff for: pkg/apis/meta/v1/generated.proto

+1-4
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

Diff for: pkg/apis/meta/v1/types.go

+1-4
Original file line numberDiff line numberDiff line change
@@ -125,10 +125,7 @@ type ObjectMeta struct {
125125
// and may be truncated by the length of the suffix required to make the value
126126
// unique on the server.
127127
//
128-
// If this field is specified and the generated name exists, the server will
129-
// NOT return a 409 - instead, it will either return 201 Created or 500 with Reason
130-
// ServerTimeout indicating a unique name could not be found in the time allotted, and the client
131-
// should retry (optionally after the time indicated in the Retry-After header).
128+
// If this field is specified and the generated name exists, the server will return a 409.
132129
//
133130
// Applied only if Name is not specified.
134131
// More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency

Diff for: pkg/apis/meta/v1/types_swagger_doc_generated.go

+1-1
Original file line numberDiff line numberDiff line change
@@ -240,7 +240,7 @@ func (ManagedFieldsEntry) SwaggerDoc() map[string]string {
240240
var map_ObjectMeta = map[string]string{
241241
"": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
242242
"name": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/identifiers#names",
243-
"generateName": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will NOT return a 409 - instead, it will either return 201 Created or 500 with Reason ServerTimeout indicating a unique name could not be found in the time allotted, and the client should retry (optionally after the time indicated in the Retry-After header).\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
243+
"generateName": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
244244
"namespace": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/namespaces",
245245
"selfLink": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
246246
"uid": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: http://kubernetes.io/docs/user-guide/identifiers#uids",

0 commit comments

Comments
 (0)