Skip to content

Commit f8148d4

Browse files
authored
Note when PUT can create items
See #6041 (comment)
1 parent f3c26b2 commit f8148d4

File tree

1 file changed

+4
-1
lines changed

1 file changed

+4
-1
lines changed

contributors/devel/sig-architecture/api-conventions.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -645,7 +645,10 @@ overrides a default grace period, including the zero grace period ("now").
645645
* DELETE /<resourceNamePlural> - Deletes a list of type
646646
<resourceName>, e.g. DELETE /pods a list of Pods.
647647
* PUT /<resourceNamePlural>/<name> - Update or create the resource
648-
with the given name with the JSON object provided by the client.
648+
with the given name with the JSON object provided by the client. Whether a
649+
resource can be created with a PUT request depends on the particular resource's
650+
storage strategy configuration, specifically the `AllowCreateOnUpdate()` return
651+
value. Most built-in types do not allow this.
649652
* PATCH /<resourceNamePlural>/<name> - Selectively modify the
650653
specified fields of the resource. See more information [below](#patch-operations).
651654
* GET /<resourceNamePlural>?watch=true - Receive a stream of JSON

0 commit comments

Comments
 (0)