API presign multipart upload experimenal support for S3

api/swagger.yml

@@ -1115,6 +1115,9 @@ components:
           type: boolean
         import_validity_regex:
           type: string
+        pre_sign_multipart_upload:
+          type: boolean
+
     Config:
       type: object
       properties:
@@ -1504,6 +1507,61 @@ components:
           items:
             $ref: "#/components/schemas/StatsEvent"
 
+    PresignMultipartUpload:
+      type: object
+      properties:
+        upload_id:
+          type: string
+        physical_address:
+          type: string
+        presigned_urls:
+          type: array
+          items:
+            type: string
+      required:
+        - upload_id
+        - physical_address
+
+    UploadPart:
+      type: object
+      properties:
+        part_number:
+          type: integer
+        etag:
+          type: string
+      required:
+        - part_number
+        - etag
+
+    CompletePresignMultipartUpload:
+      type: object
+      properties:
+        physical_address:
+          type: string
+        parts:
+          type: array
+          description: "List of uploaded parts, should be ordered by ascending part number"
+          items:
+            $ref: "#/components/schemas/UploadPart"
+        user_metadata:
+          type: object
+          additionalProperties:
+            type: string
+        content_type:
+          type: string
+          description: Object media type
+      required:
+        - physical_address
+        - parts
+
+    AbortPresignMultipartUpload:
+      type: object
+      properties:
+        physical_address:
+          type: string
+      required:
+        - physical_address
+
 paths:
   /setup_comm_prefs:
     post:
@@ -3785,6 +3843,140 @@ paths:
         default:
           description: internal server error
 
+  /repositories/{repository}/branches/{branch}/staging/pmpu:
+    parameters:
+      - in: path
+        name: repository
+        required: true
+        schema:
+          type: string
+      - in: path
+        name: branch
+        required: true
+        schema:
+          type: string
+      - in: query
+        name: path
+        description: relative to the branch
+        required: true
+        schema:
+          type: string
+      - in: query
+        name: parts
+        description: number of presigned URL parts required to upload
+        schema:
+          type: integer
+    post:
+      tags:
+        - experimental
+      operationId: createPresignMultipartUpload
+      summary: Initiate a multipart upload
+      description: |
+        Initiates a multipart upload and returns an upload ID with presigned URLs for each part (optional).
+        Part numbers starts with 1. Each part except the last one has minimum size depends on the underlying blockstore implementation.
+        For example working with S3 blockstore, minimum size is 5MB (excluding the last part).
+      responses:
+        201:
+          description: Presign multipart upload initiated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/PresignMultipartUpload"
+        400:
+          $ref: "#/components/responses/BadRequest"
+        401:
+          $ref: "#/components/responses/Unauthorized"
+        404:
+          $ref: "#/components/responses/NotFound"
+        420:
+          description: too many requests
+        default:
+          $ref: "#/components/responses/ServerError"
+
+  /repositories/{repository}/branches/{branch}/staging/pmpu/{uploadId}:
+    parameters:
+      - in: path
+        name: repository
+        required: true
+        schema:
+          type: string
+      - in: path
+        name: branch
+        required: true
+        schema:
+          type: string
+      - in: path
+        name: uploadId
+        required: true
+        schema:
+          type: string
+      - in: query
+        name: path
+        description: relative to the branch
+        required: true
+        schema:
+          type: string
+    put:
+      tags:
+        - experimental
+      operationId: completePresignMultipartUpload
+      summary: Complete a presign multipart upload request
+      description: Completes a presign multipart upload by assembling the uploaded parts.
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CompletePresignMultipartUpload"
+      responses:
+        200:
+          description: Presign multipart upload completed
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ObjectStats"
+        400:
+          $ref: "#/components/responses/BadRequest"
+        401:
+          $ref: "#/components/responses/Unauthorized"
+        404:
+          $ref: "#/components/responses/NotFound"
+        409:
+          description: conflict with a commit, try here
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/StagingLocation"
+        420:
+          description: too many requests
+        default:
+          $ref: "#/components/responses/ServerError"
+
+    delete:
+      tags:
+        - experimental
+      operationId: abortPresignMultipartUpload
+      summary: Abort a presign multipart upload
+      description: Aborts a presign multipart upload.
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/AbortPresignMultipartUpload"
+      responses:
+        204:
+          description: Presign multipart upload aborted
+        400:
+          $ref: "#/components/responses/BadRequest"
+        401:
+          $ref: "#/components/responses/Unauthorized"
+        404:
+          $ref: "#/components/responses/NotFound"
+        420:
+          description: too many requests
+        default:
+          $ref: "#/components/responses/ServerError"
+
+
   /repositories/{repository}/branches/{branch}/staging/backing:
     parameters:
       - in: path