Options for uploading an existing file

[soxofaan]

spin-off from Open-EO/openeo-python-client#378

openeo-api/openapi.yaml

Lines 3332 to 3337 in 16b1122

	put:
	summary: Upload a file to the workspace
	operationId: upload-file
	description: >-
	Uploads a new file to the given path or updates an existing file if a
	file at the path exists.

Current behavior of uploading a file to an existing path is to silently overwrite the existing file.

We might want to add more options for the user here:

• blindly overwrite existing files
• raise error when overwriting existing file
• skip upload of existing files

The latter could be a client specific feature, but the second option might be important to handle back-end side (doing it client-side might involve race conditions)

[m-mohr]

As you always upload only one file per request, skipping and erroring is basically the same.

In HTTP verbs, I think it's basically just adding a new POST endpoint with very similar semantics.

PUT -> override
POST -> error (i.e. skip) if exists

[soxofaan]

Sounds fine do it at API level with standard POST/PUT. Clients can translate that to more user friendly UI (e.g.: error, warning, skip, overwrite, interactive choice, ...).

With POST, would that then be POST /files (and an additional path request parameter), or POST /files/{path} (path directly in URL) ?