diff options
| author | Elana Hashman <ehashman@users.noreply.github.com> | 2022-01-25 11:44:36 -0800 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2022-01-25 11:44:36 -0800 |
| commit | f8148d406c36cf46783f62a38bae40352b760d34 (patch) | |
| tree | 30d4e2f7315b77e0d5cc31c8ee7ea534c7ac72f6 | |
| parent | f3c26b2e359773deee1e572f2bfdcead44f5d25a (diff) | |
Note when PUT can create items
See https://github.com/kubernetes/community/issues/6041#issuecomment-1021176213
| -rw-r--r-- | contributors/devel/sig-architecture/api-conventions.md | 5 |
1 files changed, 4 insertions, 1 deletions
diff --git a/contributors/devel/sig-architecture/api-conventions.md b/contributors/devel/sig-architecture/api-conventions.md index f1a90fea..66d453b2 100644 --- a/contributors/devel/sig-architecture/api-conventions.md +++ b/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 |