Add support for presigned URLs in the lakeFS API (treeverse#4985)

Co-authored-by: Barak Amar <barak.amar@treeverse.io>

Author: ozkatz

api/swagger.yml

@@ -246,6 +246,10 @@ components:
           enum: [common_prefix, object]
         physical_address:
           type: string
+          description: |
+            The location of the object on the underlying object store.
+            Formatted as a native URI with the object store type as scheme ("s3://...", "gs://...", etc.)
+            Or, in the case of presign=true, will be an HTTP URL to be consumed via regular HTTP GET
         checksum:
           type: string
         size_bytes:
@@ -971,6 +975,11 @@ components:
         token:
           type: string
           description: opaque staging token to use to link uploaded object
+        presigned_url:
+          type: string
+          nullable: true
+          description: if presign=true is passed in the request, this field will contain a presigned URL to use when uploading
+
 
     StagingMetadata:
       type: object
@@ -2779,6 +2788,11 @@ paths:
           schema:
             type: string
             pattern: '^bytes=((\d*-\d*,? ?)+)$'
+        - in: query
+          name: presign
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: object content
@@ -2820,6 +2834,12 @@ paths:
             ETag:
               schema:
                 type: string
+        302:
+          description: Redirect to a pre-signed URL for the object
+          headers:
+            Location:
+              schema:
+                type: string
         401:
           $ref: "#/components/responses/Unauthorized"
         404:
@@ -2917,6 +2937,12 @@ paths:
         - staging
       operationId: getPhysicalAddress
       summary: get a physical address and a return token to write object to underlying storage
+      parameters:
+        - in: query
+          name: presign
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: physical address for staging area
@@ -3258,6 +3284,11 @@ paths:
         schema:
           type: boolean
           default: true
+      - in: query
+        name: presign
+        required: false
+        schema:
+          type: boolean
     get:
       tags:
         - objects
@@ -3336,6 +3367,11 @@ paths:
         schema:
           type: boolean
           default: true
+      - in: query
+        name: presign
+        required: false
+        schema:
+          type: boolean
       - $ref: "#/components/parameters/PaginationAfter"
       - $ref: "#/components/parameters/PaginationAmount"
       - $ref: "#/components/parameters/PaginationDelimiter"