Merge pull request #6396 from ehashman/patch-2

Note when PUT can create items

Author: k8s-ci-robot

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

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